授权
授权 部分接口需要经过用户授权同意才能调用。我们把这些接口按使用范围分成多个 scope ,用户选择对 scope 来进行授权,当授权给一个 scope 之后,其对应的所有接口都可以直接使用。
部分接口需要获得用户授权同意后才能调用。此类接口调用时:
- 如果用户未接受或拒绝过此权限,会弹窗询问用户,用户点击同意后方可调用接口;
- 如果用户已授权,可以直接调用接口;
- 如果用户已拒绝授权,则不会出现弹窗,而是直接进入接口 fail 回调。请开发者兼容用户拒绝授权的场景。
获取用户授权设置
开发者可以使用 bl.getSetting 获取用户当前的授权状态。
打开设置界面
开发者可以调用 bl.openSetting 打开设置界面,引导用户开启授权。
提前发起授权请求
开发者可以使用 bl.authorize 在调用需授权 API 之前,提前向用户发起授权请求。
scope 列表
scope | 对应接口 | 描述 | 版本 |
---|---|---|---|
scope.userInfo | bl.getUserInfo | 用户信息 | |
scope.userLocation | bl.getLocation, bl.chooseLocation, bl.openLocation | 地理位置 | |
scope.address | bl.chooseAddress | 通讯地址 | |
scope.record | bl.startRecord | 录音功能 | |
scope.writePhotosAlbum | bl.saveImageToPhotosAlbum, bl.saveVideoToPhotosAlbum | 保存到相册 |