应用权限组列表
使用须知
-
在申请目标权限前,建议开发者先阅读应用权限管控概述-权限组和子权限,了解相关概念,再合理申请对应的权限组。
-
应用请求权限时,同一权限组内的权限将在一个弹窗内请求用户授权。用户同意授权后,权限组内的权限将被统一授权。但位置信息、通讯录、日历权限组除外。
以位置信息权限组和相机权限组为例说明。
- 当应用只申请权限ohos.permission.APPROXIMATELY_LOCATION(属于位置信息权限组)时,用户将收到一个请求位置信息的弹窗,包含单个权限的申请。
- 当应用同时申请权限ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION(均属于位置信息权限组)时,用户将收到一个请求位置信息的弹窗,包含两个权限的申请。
- 当应用同时申请权限ohos.permission.APPROXIMATELY_LOCATION(属于位置信息权限组)和ohos.permission.CAMERA(属于相机权限组)时,用户将收到请求位置信息、请求使用相机的两个弹窗。
-
当前系统支持的权限组如下所示。各子权限的含义请查阅应用权限列表。
位置
- ohos.permission.LOCATION_IN_BACKGROUND
- ohos.permission.LOCATION
- ohos.permission.APPROXIMATELY_LOCATION
相机
麦克风
通讯录
日历
- ohos.permission.READ_CALENDAR
- ohos.permission.WRITE_CALENDAR
- ohos.permission.READ_WHOLE_CALENDAR
- ohos.permission.WRITE_WHOLE_CALENDAR
运动数据
由于2in1设备无相关传感器,此权限不支持在2in1设备上申请。
身体传感器
仅穿戴设备可申请。
图片和视频
由于权限ohos.permission.READ_IMAGEVIDEO和ohos.permission.MEDIA_LOCATION均用于读取图片的场景,当同时申请两者时,系统(包括权限申请弹框和权限设置界面)将只展示READ_IMAGEVIDEO的申请理由(reason字段)。
当同时申请两个权限时,建议在READ_IMAGEVIDEO的reason字段中,同步说明获取MEDIA_LOCATION权限后的使用场景。
音乐和音频
跨应用关联
在申请此权限时,是否弹窗向用户请求授权,取决于“要求应用请求关联”的开关状态。
- 如果开关关闭,当应用请求权限时,系统不会弹窗,默认授予应用权限。
- 如果开关开启,当应用请求权限时,系统将弹窗,需要用户确认才能授予应用权限。
“要求应用请求关联”的开关状态可在“设置 > 隐私与安全 > 跨应用关联”页面中查看。
设备发现和连接
从API 13开始,原有的“蓝牙”、“星闪”、“多设备协同”权限组不再使用,相关权限将通过“设备发现和连接”权限组统一授权和操作。
- ohos.permission.ACCESS_BLUETOOTH
- ohos.permission.ACCESS_NEARLINK
- ohos.permission.DISTRIBUTED_DATASYNC
剪切板
截屏
文件夹
仅2in1设备可申请。
- ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY
- ohos.permission.READ_WRITE_DESKTOP_DIRECTORY
- ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY
文件(deprecated)
从API 9开始,支持使用替代方案。
- ohos.permission.READ_MEDIA
- ohos.permission.WRITE_MEDIA
替代方案:
-
读写媒体库中的图片或视频。
- 推荐方案(无需申请权限):使用Picker读取媒体库的图片与视频。使用保存控件/授权弹窗保存媒体库的图片与视频。
- 受限使用方案:申请受限权限ohos.permission.READ_IMAGEVIDEO或ohos.permission.WRITE_IMAGEVIDEO以读取媒体库的图片与视频。
-
读写媒体库音频文件。
申请受限权限ohos.permission.READ_AUDIO或ohos.permission.WRITE_AUDIO以读写媒体库的音频文件。
-
读取文件管理器中的文件。