tt.showDouyinOpenAuth

基础库 1.93.0 开始支持本方法，这是一个异步方法。

提供小程序获取抖音权限的能力，展示出抖音权限授权弹窗。在使用接口前，需要小程序拥有者前往抖音开放平台-管理中心-应用管理申请开通小程序需要的权限。下图以开通视频发布权限为例。

查看原图

语法

tt.showDouyinOpenAuth(options)

参数说明

options 为 object 类型，属性如下：

scopes 说明

scopes 是 object 类型，其中 key 值是申请权限的 scope，详见用户授权 scope 列表。value 的合法值见下表。注意：此处申请的权限在抖音开放平台必须是已开通状态。

回调成功

object 类型，属性如下：

ticket 说明

ticket 是临时票据，是用来从开放平台的接口（点击进入接口详情）获取用户的长期票据 access_token 的。开放平台的授权流程示意图如下：

查看原图

回调失败

object 类型，属性如下：

错误说明

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.showDouyinOpenAuth({
  scopes: {
    "following.list": 1,
    "fans.list": 1,
    "item.comment": 1,
  },
  success(res) {
    console.log("success", res);
  },
  fail(res) {
    console.log("fail", res);
  },
  complete(res) {
    console.log("complete", res);
  },
});

Bug & Tip

• Tip：该接口只支持抖音，所以请在抖音 APP 中调用；
• Tip：每次申请授权都是该小程序的抖音权限全量授权，请在传入 scopes 时，把需要的授权的 scopes 都传入。由于不支持增量授权，即使用户已经授权过部分抖音权限，也还是需要全量传入所有需要的权限；
• Tip：每次申请授权的抖音权限必须是在抖音开发平台已经申请并且审批开通的权限，否则会导致本次授权操作失败；
• Tip：此处授权是抖音相关的授权，如果想要申请小程序授权，请查看 tt.authorize。这两处授权的 scopes 范围不同；
• Tip：在请求服务端接口时，应用唯一标识在小程序场景下，对应的是小程序 appId；应用唯一标识对应的密钥对应的是小程序的 APP Secret。