文章目录
使用须知
-
在申请目标权限前，建议开发者先阅读应用权限管控概述-权限组和子权限，了解相关概念，再合理申请对应的权限组。
-
当应用请求权限时，同一个权限组的权限将会在一个弹窗内一起请求用户授权，用户同意授权后，权限组内权限将被统一授权。地理位置、通讯录、通话记录、电话、信息、日历权限组除外。
以位置信息和相机权限组举例说明：
- 当应用只申请了权限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.CAMERA
麦克风
- ohos.permission.MICROPHONE
通讯录
-
ohos.permission.READ_CONTACTS
-
ohos.permission.WRITE_CONTACTS
日历
-
ohos.permission.READ_CALENDAR
-
ohos.permission.WRITE_CALENDAR
运动数据
说明
由于2in1设备无相关传感器，此权限不支持在2in1设备上申请。
- ohos.permission.ACTIVITY_MOTION
身体传感器
说明
仅穿戴设备可申请。
- ohos.permission.READ_HEALTH_DATA
图片和视频
-
ohos.permission.WRITE_IMAGEVIDEO
-
ohos.permission.READ_IMAGEVIDEO
-
ohos.permission.MEDIA_LOCATION
音乐和音频
-
ohos.permission.WRITE_AUDIO
-
ohos.permission.READ_AUDIO
跨应用关联
- ohos.permission.APP_TRACKING_CONSENT
设备发现和连接
- ohos.permission.ACCESS_BLUETOOTH
- ohos.permission.ACCESS_NEARLINK
- ohos.permission.DISTRIBUTED_DATASYNC
说明
从API version 13开始，原有的"蓝牙"、"星闪"、"多设备协同"权限组不再使用，相关权限将通过"设备发现和连接"权限组统一授权和操作。
剪切板
- ohos.permission.READ_PASTEBOARD
文件夹
说明
仅2in1设备可申请。
-
ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY
-
ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY
文件(deprecated)
说明
从API 12开始，该权限组及其子权限废弃。
-
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读写媒体库的音频文件。
-
读取文件管理器中的文件：
无需申请权限，通过文件Picker读写文件管理器中的文件。参考：选择用户文件、保存用户文件。
