1# 申请访问剪贴板权限
2
3## 概述
4
5API version 12及之后，系统为提升用户隐私安全保护能力，剪贴板读取接口增加权限管控。
6
7涉及接口如下：
8
9| 名称 | 说明                                                                                                                                        |
10| -------- |----------------------------------------------------------------------------------------------------------------------------------------|
11| getData( callback: AsyncCallback<PasteData>): void | 读取系统剪贴板内容，使用callback异步回调。 |
12| getData(): Promise<PasteData> | 读取系统剪贴板内容，使用Promise异步回调。 |
13| getDataSync(): PasteData | 读取系统剪贴板内容, 此接口为同步接口。 |
14| getUnifiedData(): Promise\<udc.UnifiedData\> | 从系统剪贴板中读取统一数据对象的数据。 |
15| getUnifiedDataSync(): udc.UnifiedData | 从系统剪贴板中读取统一数据对象的数据，此接口为同步接口。 |
16| OH_UdmfData * OH_Pasteboard_GetData (OH_Pasteboard *pasteboard, int *status) | 获取剪贴板中的数据。 |
17
18## 访问剪贴板内容
19
20剪贴板为应用提供如下两种访问内容的方式。
21
22- 使用安全控件
23
24    使用[安全控件](../../security/AccessToken/pastebutton.md)访问剪贴板内容的应用，可以无需申请权限。
25
26    已经使用了安全控件的应用无需做任何适配就可以访问剪贴板内容。
27
28- 申请ohos.permission.READ_PASTEBOARD权限
29
30    ohos.permission.READ_PASTEBOARD是受限的user_grant（用户授权）权限，使用自定义控件的应用可以通过申请ohos.permission.READ_PASTEBOARD权限，在用户授权的场景下访问剪贴板内容。
31
32    权限申请步骤：
33    <!--RP1-->
34    1.通过[ACL方式](../../security/AccessToken/declare-permissions-in-acl.md)，申请高级别权限。
35
36    2.在module.json5配置文件中[声明权限](../../security/AccessToken/declare-permissions.md)。
37
38    3.通过弹窗[向用户申请权限](../../security/AccessToken/request-user-authorization.md)。
39    <!--RP1End-->