抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • JavaScript API
  • API 概览
  • 基础
  • 界面
  • 渲染
  • 数据缓存
  • 文件
  • 位置
  • 设备
  • 网络
  • 媒体
  • Worker
  • 数据分析
  • 支付
  • 广告
  • 开放能力
  • 登录
  • 侧边栏能力
  • 设置
  • 授权
  • tt.authorize
  • tt.showDouyinOpenAuth
  • tt.onNeedPrivacyAuthorization
  • 添加到桌面
  • 游戏排行榜
  • 订阅消息
  • 开放数据域
  • 开放数据
  • 开放数据分组
  • 客服消息
  • 直播能力
  • 推荐流直出游戏能力
  • 社交互动能力
  • 公会群能力
  • 意见反馈
  • 游戏站
  • 转发
  • 关注
  • 群聊
  • 收藏
  • C# API
  • 基础库 1.80.0 开始支持本方法,这是一个异步方法。

    向用户请求单项能力授权(如地理位置、摄像头等)。

    前提条件无
    业务背景无
    使用限制无
    注意事项
    新版本中在 scope 授权前会前置校验隐私协议授权。
    相关教程无

    语法

    tt.authorize(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    scopestring是
    需要授权的能力 scope(如 scope.camera、scope.record 等)
    1.80.0
    successfunction否
    接口调用成功的回调函数
    1.80.0
    failfunction否
    接口调用失败的回调函数
    1.80.0
    completefunction否
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.80.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    固定为 "authorize:ok"
    1.80.0
    dataobject
    用户授权结果,属性如下
    1.80.0

    data 类型说明

    object 类型,属性如下:

    属性名类型说明最低支持版本
    scope.userInfoboolean
    是否授权用户信息
    1.80.0
    scope.userLocationboolean
    是否授权地理位置
    1.80.0
    scope.recordboolean
    是否授权使用录音
    1.80.0
    scope.albumboolean
    是否授权使用相册
    1.80.0
    scope.cameraboolean
    是否授权使用摄像头
    1.80.0
    scope.screenRecordboolean
    是否授权屏幕录制
    1.80.0
    scope.calendarboolean
    是否授权使用日历
    1.80.0
    scope.gameClubboolean
    是否授权获取游戏站数据
    3.77.0
    scope.groupTagboolean
    是否授权使用群聊标签
    3.78.0
    scope.accelerometerboolean
    是否授权使用加速度计
    4.22.0
    scope.clipboardboolean
    是否授权使用剪贴板
    4.22.0
    scope.compassboolean
    是否授权使用指南针
    4.22.0
    scope.screenBrightnessboolean
    是否授权使用屏幕亮度
    4.22.0
    scope.vibrateboolean
    是否授权使用振动
    4.22.0
    scope.gyroscopeboolean
    是否授权使用陀螺仪
    4.22.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    详细失败原因
    1.80.0
    errNonumber
    错误码
    1.80.0

    错误码

    errNoerrMsg说明最低支持版本
    21105/s
    %s 代表占位符。
    1.80.0
    21102auth deny
    1.80.0
    10401internal auth error
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    21101invalid scope
    1.80.0
    21103batched auth permission deny
    1.80.0
    21104%s not support batched auth
    1.80.0
    20001invalid param
    参数错误
    1.80.0
    20000internal error
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    20000Scope is NULL.
    1.80.0
    10401Internal error: platform auth deny
    小游戏框架内部错误,有需要请创建工单咨询
    1.80.0
    21106not login
    1.80.0

    代码示例

    tt.authorize({ scope: 'scope.camera', success: () => { console.log('授权成功'); }, fail: (err) => { console.error('授权失败', err); } });