授权
authorize
解释: 提前向用户发起授权请求。调用后会立刻弹窗询问用户是否同意授权智能小程序使用某项功能或获取用户的某些数据,但不会实际调用对应接口。如果用户之前已经同意授权,则不会出现弹窗,直接返回成功。
参数:Object
Object参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
scope | String | 是 | 需要获取权限的 scope,详见 scope 列表。 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
scope 列表
scope | 对应接口 | 描述 |
---|---|---|
scope.userInfo | swan.getUserInfo | 用户信息 |
scope.userLocation | swan.getLocation, swan.chooseLocation | 地理位置 |
scope.writePhotosAlbum | swan.saveImageToPhotosAlbum | 保存到相册 |
scope.address | swan.chooseAddress | 收货地址 |
scope.invoiceTitle | swan.chooseInvoiceTitle | 发票抬头 |
scope.record | swan.getRecorderManager | 录音功能 |
scope.camera | <camera/> | 摄像头 |
示例:在开发者工具中预览效果
- swan.authorize({
scope: 'scope.userLocation',
success: function (res) {
// 用户已经同意智能小程序使用定位功能
swan.getLocation();
}
});
说明:授权操作为异步操作,完成前请不要多次调用。