抖音开放平台Logo
开发者文档
控制台

tt.getSetting
收藏
我的收藏

基础库 1.3.0 开始支持本方法,结果中只会包含小程序向用户请求过的权限,这是一个异步方法。

获取用户已经授权过的配置。

前提条件
业务背景
使用限制
注意事项
  • tt.openSetting 的区别是 getSetting 只会获取配置,而不会打开配置页面。
相关教程

语法

tt.getSetting(options)

参数说明

options 为 object 类型,属性如下:

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

回调成功

object 类型,属性如下:

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

AuthSetting,授权结果。

1.3.0
errMsgstring

"getSetting: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

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

1.3.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

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