harmony 鸿蒙申请访问剪贴板权限

  • 2025-06-12
  • 浏览 (4)

申请访问剪贴板权限

概述

API version 12及之后,系统为提升用户隐私安全保护能力,剪贴板读取接口增加权限管控。

涉及接口如下:

名称 说明
getData(callback: AsyncCallback<PasteData>): void 读取系统剪贴板内容,使用callback异步回调。
getData(): Promise<PasteData> 读取系统剪贴板内容,使用Promise异步回调。
getDataSync(): PasteData 读取系统剪贴板内容, 此接口为同步接口。
getUnifiedData(): Promise<unifiedDataChannel.UnifiedData> 从系统剪贴板中读取统一数据对象的数据。
getUnifiedDataSync(): unifiedDataChannel.UnifiedData 从系统剪贴板中读取统一数据对象的数据,此接口为同步接口。
OH_UdmfData * OH_Pasteboard_GetData (OH_Pasteboard *pasteboard, int *status) 获取剪贴板中的数据。
getDataWithProgress(params: GetDataParams): Promise<PasteData> 获取剪贴板的内容和进度,使用Promise异步回调,不支持对文件夹的拷贝。
OH_UdmfData* OH_Pasteboard_GetDataWithProgress(OH_Pasteboard* pasteboard, Pasteboard_GetDataParams* params, int* status) 获取剪贴板的数据以及粘贴进度,不支持对文件夹的拷贝。

访问剪贴板内容

剪贴板为应用提供如下两种访问内容的方式。

  • 使用安全控件

    使用安全控件访问剪贴板内容的应用,可以无需申请权限。

    已经使用了安全控件的应用无需做任何适配就可以访问剪贴板内容。

  • 申请ohos.permission.READ_PASTEBOARD权限

    ohos.permission.READ_PASTEBOARD是受限的user_grant(用户授权)权限,使用自定义控件的应用可以通过申请ohos.permission.READ_PASTEBOARD权限,在用户授权的场景下访问剪贴板内容。

    权限申请步骤: 1.通过ACL方式,申请高级别权限。

    2.在module.json5配置文件中声明权限

    3.通过弹窗向用户申请权限

你可能感兴趣的鸿蒙文章

harmony 鸿蒙剪贴板服务

harmony 鸿蒙使用剪贴板进行复制粘贴 (C/C++)

harmony 鸿蒙使用剪贴板进行延迟复制粘贴

harmony 鸿蒙使用剪贴板进行复制粘贴

0  赞