tt.showDouyinOpenAuth收藏我的收藏
收藏
我的收藏基础库 1.93.0 开始支持本方法,这是一个异步方法。
提供小游戏获取抖音权限的能力,展示出抖音权限授权弹窗。
前提条件 | 在使 用在接口前,需要小游戏拥有者登录抖音开放平台申请开通小游戏需要的权限(如下图所示)。 具体路径:控制台 -> 运营 -> 抖音开放能力 |
业务背景 | 无 |
使用限制 | 该接口只支持抖音,所以请在抖音 APP 中调用; |
注意事项 |
|
相关教程 | 无 |
语法
tt.showDouyinOpenAuth(options)
参数说明
options 为 object 类型,属性如下:
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
---|---|---|---|---|---|
scopes | object | 否 | 需要获取权限的信息,其中 key 值是申请权限的 scope,value 值必须是 0,1,2(此处申请的权限在抖音开放平台必须是已开通状态) | 1.93.0 | |
success | function | 否 | 接口调用成功的回调函数 | 1.93.0 | |
fail | function | 否 | 接口调用失败的回调函数 | 1.93.0 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 1.93.0 |
scopes 参数说明
scopes 的属性值必需是0, 1, 2
属性值 | 类型 | 说明 | 版本 |
0 | number | 必选项(用户无法取消) | 1.93.0 |
1 | number | 非必选,默认选中 | 1.93.0 |
2 | number | 非必选,默认不选中 | 1.93.0 |
回调成功
回调失败
object 类型,属性如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
errMsg | string | "showDouyinOpenAuth:fail" + 详细错误信息 | 1.93.0 |
错误码
errNo | errMsg | 说明 | 最低支持版本 |
---|---|---|---|
10301 | feature is not supported in app | 宿主不支持登录/宿主不支持抖音开放平台授权 | 1.93.0 |
21000 | login fail xxx | 用户登录失败 | 1.93.0 |
21101 | request auth ticket fail xxx | 获取权限票据失败 | 1.93.0 |
21102 | request auth scope info fail xxx | 获取权限信息失败 | 1.93.0 |
21103 | request auth code fail xxx | 获取权限授权码失败 | 1.93.0 |
20000 | scopes is empty | 开发者传入的 scopes 为空数据 | 1.93.0 |
21104 | no usage scope | 没有可用的授权权限(开发者申请授权的权限全部没有被开通权限) | 1.93.0 |
代码示例
tt.showDouyinOpenAuth({ scopes: { im: 0, // 用户无法取消 "im.media": 2, }, success(res) { console.log("success", res); }, fail(res) { console.log("fail", res); }, complete(res) { console.log("complete", res); }, });
点击纠错