使用须知
在申请目标权限前,建议开发者先阅读应用权限管控概述-权限组和子权限,了解相关概念,再合理申请对应的权限组。
当应用请求权限时,同一个权限组的权限将会在一个弹窗内一起请求用户授权,用户同意授权后,权限组内权限将被统一授权。地理位置、通讯录、通话记录、电话、信息、日历权限组除外。
以位置信息和相机权限组举例说明:
- 当应用只申请了权限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读写文件管理器中的文件。参考:选择用户文件、保存用户文件。