# x-perm-apply-instr ## 安卓应用申请权限时弹窗告知用户使用目的 ### 用法说明, 在main.js引入 ```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 中调用 ``` vue ``` ### 交互逻辑说明 1. 在调用需要申请权限的 uni api 时会对该 uni api 进行拦截, 并弹出申请权限说明弹窗 (应用商店的审核要求) 2. 用户如果**不同意**申请权限该 uni api 会进入错误回调, 如果用户**同意**申请权限会显示申请系统权限的弹窗(因为第一步有说明申请权限用途, 已达到应用商店审核要求) 3. 当申请系统权限的弹窗显示时, 用户可以选择同意或拒绝**(此时才是同意或拒绝权限)**, **同意**后将会调用 uni api, **拒绝**会进入 uni api 错误回调 ### 插件如果对你有帮助给个好评吧~