大网数据广告活动
OpenHarmony 设备与应用开发

开放权限(用户授权)

· 52CE 我爱测

该类型权限不仅需要在安装包中申请权限,还需要在应用动态运行时,通过发送弹窗的方式请求用户授权。在用户手动允许授权后,应用才会真正获取相应权限,从而成功访问操作目标对象。

开放权限(用户授权)

此列表内所有权限均为用户授权(user_grant)的开放权限,面向所有应用开放。

该类型权限不仅需要在安装包中申请权限,还需要在应用动态运行时,通过发送弹窗的方式请求用户授权。在用户手动允许授权后,应用才会真正获取相应权限,从而成功访问操作目标对象。

说明: 权限级别为normal的权限,不涉及是否支持证书授权字段。

申请方式

以下权限的授权方式均为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

允许应用在后台运行时获取设备位置信息。

申请流程:

  1. 在“module.json5”配置文件中声明权限。

    由于在申请后台位置权限前,必须先申请前台位置权限,因此开发者在配置时,应同时配置后台位置权限和前台位置权限。前台位置权限的申请有两种允许情况:

  2. 应用调用requestPermissionsFromUser()拉起弹窗向用户申请对应的前台位置权限。

  3. 若用户点击弹窗允许应用使用前台位置权限,应用可以引导用户在系统应用“设置”中,授予后台位置权限;若用户点击弹窗禁止应用使用前台位置权限,应用可以引导用户在系统应用“设置”中授权,或通过调用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

替代方案:

请参考文件权限组废弃替代方案。

本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。