x-perm-apply-instr
安卓应用申请权限时弹窗告知用户使用目的
用法说明, 在main.js引入
// @func addPermisionInterceptor
// @param {String} permisionName 要拦截的 uniApi 名称
// @param {String} content 申请权限说明信息
// @param {Boolean} once 只询问一次, 用户不同意申请或拒绝权限将无法使用 uniApi, 如果要继续使用 Api 先用 removePermisionInterceptor 函数移除拦截再调用 Api
// @func removePermisionInterceptor
// @param {String} permisionName 要移除拦截的 uniApi 名称
import { addPermisionInterceptor, removePermisionInterceptor } from '@/uni_modules/x-perm-apply-instr/js_sdk/index.js'
addPermisionInterceptor('chooseImage', '为了xxxxxx, 我们需要申请您设备的相机和存储权限')
addPermisionInterceptor('chooseVideo', '为了xxxxxx, 我们需要申请您设备的相机和存储权限')
addPermisionInterceptor('saveImageToPhotosAlbum', '为了xxxxxx, 我们需要申请您设备的存储权限')
addPermisionInterceptor('getLocation', '为了xxxxxx, 我们需要申请您设备的位置权限')
addPermisionInterceptor('makePhoneCall', '为了xxxxxx, 我们需要申请您设备的拨打电话权限')
addPermisionInterceptor('getRecorderManager', '为了xxxxxx, 我们需要申请您设备的麦克风权限')
addPermisionInterceptor('startLocationUpdate', '为了xxxxxx, 我们需要申请您设备的位置权限')
addPermisionInterceptor('scanCode', '为了xxxxxx, 我们需要申请您设备的相机权限')
注意, 如果需要拦截 getRecorderManager , 在使用时不要直接在 script 下初始化, 会导致拦截失败, 请在 onLoad 或 onReady 中调用
<script>
// 错误写法
const recorderManager = uni.getRecorderManager();
// 正确写法
let recorderManager = null
export default {
onLoad() {
recorderManager = uni.getRecorderManager();
}
}
</script>
交互逻辑说明
- 在调用需要申请权限的 uni api 时会对该 uni api 进行拦截, 并弹出申请权限说明弹窗 (应用商店的审核要求)
- 用户如果不同意申请权限该 uni api 会进入错误回调, 如果用户同意申请权限会显示申请系统权限的弹窗(因为第一步有说明申请权限用途, 已达到应用商店审核要求)
- 当申请系统权限的弹窗显示时, 用户可以选择同意或拒绝**(此时才是同意或拒绝权限)**, 同意后将会调用 uni api, 拒绝会进入 uni api 错误回调