鸿蒙NEXT开发实战往期必看文章:

一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)

HarmonyOS NEXT应用开发案例实践总结合(持续更新......)

HarmonyOS NEXT应用开发性能优化实践总结(持续更新......)


申请方式

当前仅少量符合特殊场景的应用可在通过审批后,使用受限权限,其申请方式请参考:申请使用受限权限

说明

如果应用涉及获取受限权限,在应用发布上架时,应用市场(AGC)将根据应用的使用场景审核是否可以使用对应的受限权限。如不符合,应用的上架申请将被驳回,审核方式请见发布HarmonyOS应用

权限列表

ohos.permission.READ_AUDIO

允许读取用户公共目录的音频文件。

可申请此权限的特殊场景与功能 应用需要克隆、备份或同步音频类文件。

其他场景下的使用方案 使用“AudioPicker”访问用户音频文件,使用方式请参考:选择用户文件(FilePicker)

授权方式: 用户授权(user_grant)

起始版本: 9

ohos.permission.WRITE_AUDIO

允许修改用户公共目录的音频文件。

可申请此权限的特殊场景与功能 应用需要克隆、备份或同步音频类文件。

其他场景下的使用方案: 使用“AudioPicker”保存用户音频文件,使用方式请参考:保存用户文件(FilePicker)。

授权方式: 用户授权(user_grant)

起始版本: 9

ohos.permission.READ_IMAGEVIDEO

允许读取用户公共目录的图片或视频文件。

可申请此权限的特殊场景与功能 应用需要克隆、备份或同步图片/视频类文件。

其他场景下的使用方案: 使用“PhotoViewPicker”访问用户图片或视频,使用方式请参考:使用Picker选择媒体库资源

授权方式: 用户授权(user_grant)

起始版本: 9

ohos.permission.WRITE_IMAGEVIDEO

允许修改用户公共目录的图片或视频文件。

可申请此权限的特殊场景与功能 应用需要克隆、备份或同步图片/视频类文件。

其他场景下的使用方案: 使用“保存控件”保存用户图片或视频,使用方式请参考:保存控件

授权方式: 用户授权(user_grant)

起始版本: 9

ohos.permission.SHORT_TERM_WRITE_IMAGEVIDEO

允许应用保存图片、视频到用户公共目录。

应用获取此权限后,最长可获得30分钟的短时授权,来保存图片/视频。如果超过30分钟,将再次弹窗,需要用户再次确认。

可申请此权限的特殊场景与功能:

  1. 应用无法使用安全保存控件,例如H5网页应用等。
  2. 存在连续多次保存图片/视频的场景,无法使用保存确认弹框,一次保存多个图片/视频。

其他场景下的使用方案:使用“保存控件”保存用户图片或视频,使用方式请参考:保存控件拉起保存确认弹窗

授权方式: 用户授权(user_grant)

起始版本: 12

ohos.permission.READ_WRITE_DESKTOP_DIRECTORY

允许应用访问公共目录下Desktop目录及子目录。

可申请此权限的特殊场景与功能当前仅2in1设备应用可申请此权限。

授权方式: 用户授权(user_grant)

起始版本: 11

ohos.permission.READ_CONTACTS

允许应用读取联系人数据。

可申请此权限的特殊场景与功能应用需要克隆、备份或同步联系人信息。

其他场景下的使用方案: 使用“联系人Picker”访问联系人数据,使用方式请参考:选择联系人

授权方式: 用户授权(user_grant)

起始版本: 8

ohos.permission.WRITE_CONTACTS

允许应用添加、移除或更改联系人数据。

可申请此权限的特殊场景与功能应用需要克隆、备份或同步联系人信息。

其他场景下的使用方案: 除以上特殊场景外,应用不能修改联系人数据,应引导用户到“联系人”应用中修改联系人数据。

授权方式: 用户授权(user_grant)

起始版本: 8

ohos.permission.SYSTEM_FLOAT_WINDOW

允许应用使用全局悬浮窗的能力。

可申请此权限的特殊场景与功能

  • 多人视频通话
  • 屏幕共享
  • 当前仅2in1设备应用可申请此权限。

说明

应用基于悬浮窗提供的窗口界面,必须向用户提供退出窗口的方式。

其他场景下的使用方案: 在其他设备或场景下,使用“画中画”功能,使用方式请参考:画中画开发指导

授权方式: 系统授权(system_grant)

起始版本: 8

ohos.permission.READ_PASTEBOARD

允许应用读取剪贴板。

可申请此权限的特殊场景与功能

  • 2in1设备上的应用均可申请。
  • 其他设备只有符合以下场景可申请:
    • 银行卡号复制:银行类应用需要读取剪贴板中的银行卡号自动生成卡片。
    • 口令复制:应用需要读取剪贴板中特定格式口令,自动打开应用内对应页面。
    • 文档编辑类应用。
    • 输入法:系统级输入法需要读取剪贴板信息实现自动填充。应用内置输入法不能申请此权限。

其他场景下的使用方案: 使用“粘贴控件”读取剪贴板数据,使用方式请参考:粘贴控件

授权方式: 用户授权(user_grant)

起始版本: 11

ohos.permission.ACCESS_DDK_USB

允许扩展外设驱动访问USB DDK接口开发USB总线扩展外设驱动。

可申请此权限的特殊场景与功能

  • 外接设备总线类型为USB总线,用于支持外接设备实现相应的功能,如外接指纹采集、打印机、身份证、指纹识别等外接设备。
  • 当前仅2in1设备应用可申请此权限。

除上述场景外,应用不需要使用此权限保护的系统能力,不涉及申请此权限。

授权方式: 系统授权(system_grant)

起始版本: 11

ohos.permission.ACCESS_DDK_HID

允许扩展外设驱动访问HID DDK接口开发HID类扩展外设驱动。

可申请此权限的特殊场景与功能

  • 外接设备为人机交互外设( HID外设),可支持外接设备与主机实现人机交互功能,如外接手写板、游戏手柄、键鼠等HID输入外设。
  • 当前仅2in1设备应用可申请此权限。

除上述场景外,应用不需要使用此权限保护的系统能力,不涉及申请此权限。

授权方式: 系统授权(system_grant)

起始版本: 11

ohos.permission.INPUT_MONITORING

允许应用监听输入事件。

可申请此权限的特殊场景与功能

应用需要录屏,且录屏过程中有显示键盘按键事件,或是显示鼠标指针效果/触摸效果的功能;应用需要共享桌面。

除上述场景外,应用不能申请此权限。

授权方式: 系统授权(system_grant)

起始版本: 12

ohos.permission.INTERCEPT_INPUT_EVENT

允许应用拦截输入事件。

可申请此权限的特殊场景与功能

  • 应用为云桌面或是远程登录客户端,需要在本地设备显示远端服务端的云电脑,或是显示远程电脑的画面。
  • 当前仅2in1设备应用可申请此权限。

除上述场景外,应用不能申请此权限。

授权方式: 系统授权(system_grant)

起始版本: 12

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐