抖音开放平台Logo
控制台

tt.openSetting
收藏
我的收藏

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

打开设置页面,返回用户设置过的授权结果。

前提条件
业务背景
使用限制
注意事项
  • 设置页面只包含用户请求过的权限
  • tt.getSetting 的区别是,openSetting 会打开设置页面,而 getSetting 只会返回用户授权的设置信息
相关教程

语法

tt.openSetting(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
successfunction
接口调用成功的回调函数
1.3.0
failfunction
接口调用失败的回调函数
1.3.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
1.3.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
authSettingobject

AuthSetting,授权结果

1.3.0
errMsgstring

"openSetting:ok"

1.3.0

authSetting 类型说明

object 类型,属性如下:

属性名类型说明最低支持版本
scope.userInfoboolean

是否授权用户信息

1.3.0
scope.userLocationboolean

是否授权地理位置

1.3.0
scope.recordboolean

是否授权录音功能

1.3.0
scope.albumboolean

是否授权保存到相册

1.3.0
scope.cameraboolean

是否授权摄像头

1.3.0
scope.screenRecordboolean

是否授权录屏,默认为开。在 onError 里面报错到没有录屏权限时,可以尝试主动调用

1.3.0
scope.calendarboolean

是否授权添加日历事件

1.3.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring

"openSetting:fail " + 详细错误信息

1.3.0

代码示例

开发者工具中预览

tt.openSetting({
  success(res) {
    console.log(res);
  },
  fail(res) {
    console.log(`openSetting 调用失败`);
  },
});