# tap.openSetting(Object object)
基础库 2.6.0 开始支持,低版本需做兼容处理
以 Promise 风格调用:支持
# 功能描述
调起客户端小游戏设置界面,返回用户设置的操作结果。设置界面只会出现小游戏已经向用户请求过的权限。
# 参数
# Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
| withSubscriptions | Boolean | false | 否 | 不支持订阅相关功能,不会返回subscriptionsSetting |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# object.success 回调函数
# 参数
# Object res
| 属性 | 类型 | 说明 |
| authSetting | AuthSetting | 用户授权结果 |
| subscriptionsSetting | SubscriptionsSetting | 不支持订阅相关功能,返回空 |
- 注意 版本开始,用户发生点击行为后,才可以跳转打开设置页,管理授权信息。
示例代码
function compareVersion(v1, v2) {
const parts1 = v1.split('.').map(Number)
const parts2 = v2.split('.').map(Number)
for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
const num1 = parts1[i] || 0
const num2 = parts2[i] || 0
if (num1 > num2) return 1
if (num1 < num2) return -1
}
return 0
}
const tapSDKVersion = tap.getAppBaseInfo().tapSDKVersion
if (tapSDKVersion && compareVersion(tapSDKVersion, '2.6.0') >= 0) {
tap.openSetting({
success (res) {
console.log(res.authSetting)
}
})
} else {
console.error('openSetting api is not supported yet')
}
