申请访问剪贴板权限

概述

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.通过弹窗向用户申请权限。