Skip to content

qin.authorize(OBJECT) ​

提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权小程序使用某项功能或获取用户的某些数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。如果用户之前拒绝了授权,此接口会直接进入失败回调,一般搭配qin.getSetting和qin.openSetting使用。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序抖音小程序、飞书小程序QQ小程序快手小程序京东小程序
xx√x√√√√x

注意:App平台的授权判断方式,另见:https://ext.dcloud.net.cn/plugin?id=594

OBJECT 参数说明

参数类型必填说明
scopeString是需要获取权限的 scope,详见 scope 列表。
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)
scope 列表 ​
scope对应接口描述平台差异说明
scope.userInfoqin.getUserInfo用户信息
scope.userLocationqin.getLocation, qin.chooseLocation地理位置
scope.userLocationBackgroundwx.userLocationBackground后台定位微信小程序
scope.addressqin.chooseAddress通信地址
scope.recordqin.getRecorderManager录音功能
scope.writePhotosAlbumqin.saveImageToPhotosAlbum, qin.saveVideoToPhotosAlbum保存到相册抖音小程序的返回值是scope.album
scope.camera<camera /> 组件,头条下的扫码、拍照、选择相册摄像头
scope.invoicewx.chooseInvoice获取发票微信小程序、QQ小程序
scope.invoiceTitleqin.chooseInvoiceTitle发票抬头微信小程序、百度小程序、QQ小程序
scope.werunwx.getWeRunData微信运动步数微信小程序

注意:scope.userLocation 权限需要在 manifest.json 配置 permission, 详见:https://uniapp.dcloud.io/collocation/manifest

代码示例

js
qin.authorize({
    scope: 'scope.userLocation',
    success() {
        qin.getLocation()
    }
})
qin.authorize({
    scope: 'scope.userLocation',
    success() {
        qin.getLocation()
    }
})