开放权限(用户授权)
此列表内所有权限均为用户授权(user_grant)的开放权限,面向所有应用开放。
该类型权限不仅需要在安装包中申请权限,还需要在应用动态运行时,通过发送弹窗的方式请求用户授权。在用户手动允许授权后,应用才会真正获取相应权限,从而成功访问操作目标对象。
申请方式
以下权限的授权方式均为user_grant(用户授权),申请方式请参考声明权限 > 向用户申请授权。
ohos.permission.ACCESS_BLUETOOTH
允许应用接入蓝牙并使用蓝牙功能。
包括扫描和发现外围蓝牙设备、与外围蓝牙设备配对和连接等操作,同时支持低功耗蓝牙的广播和扫描功能。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:10
ohos.permission.MEDIA_LOCATION
允许应用访问用户媒体文件中的地理位置信息。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.APP_TRACKING_CONSENT
允许应用读取开放匿名设备标识符。
在申请此权限时,是否弹窗向用户请求授权,取决于“要求应用请求关联”的开关状态。
- 如果开关关闭,当应用请求权限时,系统不会弹窗,默认授予应用权限。
- 如果开关开启,当应用请求权限时,系统将弹窗,需要用户确认才能授予应用权限。
“要求应用请求关联”的开关状态可在“设置 > 隐私与安全 > 跨应用关联”页面中查看。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:9
ohos.permission.ACTIVITY_MOTION
允许应用读取用户的运动状态。
例如,判断用户是否处于运动中、记录用户行走步数。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.CAMERA
允许应用使用相机。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:9
ohos.permission.DISTRIBUTED_DATASYNC
允许不同设备间的数据交换。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.LOCATION_IN_BACKGROUND
允许应用在后台运行时获取设备位置信息。
申请流程:
-
在“module.json5”配置文件中声明权限。
由于在申请后台位置权限前,必须先申请前台位置权限,因此开发者在配置时,应同时配置后台位置权限和前台位置权限。前台位置权限的申请有两种允许情况:
- 申请前台模糊位置权限:声明权限ohos.permission.APPROXIMATELY_LOCATION。
- 申请前台精确位置权限:同时声明权限ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION。
-
应用调用requestPermissionsFromUser()拉起弹窗向用户申请对应的前台位置权限。
-
若用户点击弹窗允许应用使用前台位置权限,应用可以引导用户在系统应用“设置”中,授予后台位置权限;若用户点击弹窗禁止应用使用前台位置权限,应用可以引导用户在系统应用“设置”中授权,或通过调用requestPermissionOnSetting()再次拉起权限设置弹窗,引导用户授权。
当前系统提供了长时任务机制,对于需要在后台使用位置的应用,结合自身业务场景,可通过申请LOCATION类型的长时任务和前台位置权限的方式在后台获取位置,而不必申请后台位置权限。请参考:长时任务指导。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.LOCATION
允许应用获取设备位置信息。
申请条件:需要与模糊位置权限ohos.permission.APPROXIMATELY_LOCATION一起,才可申请此权限。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.APPROXIMATELY_LOCATION
允许应用获取设备模糊位置信息。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:9
ohos.permission.MICROPHONE
允许应用使用麦克风。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:8
ohos.permission.READ_CALENDAR
允许应用读取日历信息。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:8
ohos.permission.WRITE_CALENDAR
允许应用添加、移除或更改日历活动。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:8
ohos.permission.READ_HEALTH_DATA
允许应用读取用户的健康数据。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
ohos.permission.ACCESS_NEARLINK
允许应用接入星闪并使用星闪能力,例如配对、连接外围设备等。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:12
ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY
允许应用访问公共目录下Download目录及子目录。
该权限级别发生变更,为保证兼容性,在当前版本请继续采用受限权限申请方式申请使用该权限。
权限级别:normal
授权方式:用户授权(user_grant)
支持设备:PC/2in1 | Tablet
起始版本:11
变更信息: API 11,权限级别为system_basic;从API 12开始,变更为normal。
ohos.permission.READ_WRITE_DOCUMENTS_DIRECTORY
允许应用访问公共目录下的Documents目录及子目录。
该权限级别发生变更,为保证兼容性,在当前版本请继续采用受限权限申请方式申请使用该权限。
权限级别:normal
授权方式:用户授权(user_grant)
支持设备:PC/2in1 | Tablet
起始版本:11
变更信息: API 11,权限级别为system_basic;从API 12开始,变更为normal。
ohos.permission.CUSTOM_SCREEN_CAPTURE
允许应用获取屏幕图像。
应用获取此权限后,可进行截屏等操作。
权限级别:normal
授权方式:用户授权(user_grant)
支持设备:PC/2in1 | Tablet | Phone
起始版本:14
变更信息:API 14-20,该权限仅支持在平板、PC/2in1设备上申请;从API 21开始,增加支持在手机上申请。
ohos.permission.READ_MEDIA
允许应用读取用户外部存储中的媒体文件信息。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
废弃版本:22
替代方案:
请参考文件权限组废弃替代方案。
ohos.permission.WRITE_MEDIA
允许应用读写用户外部存储中的媒体文件信息。
权限级别:normal
授权方式:用户授权(user_grant)
起始版本:7
废弃版本:22
替代方案:
请参考文件权限组废弃替代方案。