tencent cloud

腾讯云超级应用服务

文档腾讯云超级应用服务小程序开发指南API授权设置

授权设置

Download
聚焦模式
字号
最后更新时间： 2025-08-29 18:32:31

设置

AuthSetting

功能说明：用户授权设置信息， 所有 scope 参考: 详见 scope
参数及说明：
属性
说明
boolean scope.userLocation
是否授权地理位置，对应接口 wx.getLocation 和 wx.chooseLocation
boolean scope.writePhotosAlbum
是否授权保存到相册 wx.saveImageToPhotosAlbum
boolean scope.camera
是否授权摄像头，对应 <camera /> 组件

getSetting

该 API 使用方法为 wx.getSetting(Object object)。
功能说明：获取用户的当前设置。
参数及说明：Object object。
属性
类型
默认值
必填
说明
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数（调用成功、失败都会执行）
object.success 回调函数参数：Object res。
属性
类型
说明
authSetting
AuthSetting
用户授权结果
示例代码：
wx.getSetting({
  success(res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

openSetting

该 API 使用方法为 wx.openSetting(Object object)。
功能说明：调起 superapp 的小程序设置界面，返回用户设置的操作结果，用户发生单击行为后，可以跳转打开设置页，管理授权信息。
参数及说明：Object object。
属性
类型
默认值
必填
说明
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数（调用成功、失败都会执行）
object.success 回调函数参数：Object res。
属性
类型
说明
authSetting
AuthSetting
用户授权结果
示例代码：
wx.openSetting({
  success(res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})
wx.openSetting({
  success (res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

授权

authorize

该 API 使用方法为 wx.authorize(Object object)。
功能说明：提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据，但不会实际调用对应接口。如果用户之前已经同意授权，则不会出现弹窗，直接返回成功。
参数及说明：Object object。
属性
类型
默认值
必填
说明
scope
string
-
是
需要获取权限的 scope 详见 scope
success
function
-
否
接口调用成功的回调函数
fail
function
-
否
接口调用失败的回调函数
complete
function
-
否
接口调用结束的回调函数（调用成功、失败都会执行）
示例代码：
// 可以通过 wx.getSetting 先查询一下用户是否授权了 "scope.record" 这个 scope
wx.getSetting({
  success(res) {
    if (!res.authSetting['scope.record']) {
      wx.authorize({
        scope: 'scope.record',
        success() {
          // 用户已经同意小程序使用录音功能，后续调用 wx.startRecord 接口不会弹窗询问
          wx.startRecord()
        }
      })
    }
  }
})


上一篇: 广告下一篇: 小程序登录

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈