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

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

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

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

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

剪贴板分为本地剪贴板和跨设备剪贴板，本地剪贴板提供设备内的内容复制粘贴，跨设备剪贴板提供跨设备的内容复制粘贴。

当用户拥有多台设备时，可以通过跨设备剪贴板的功能，在A设备的应用上复制一段文本，粘贴到B设备的应用中，高效地完成多设备间的内容共享。

当开发者正在开发一款浏览器类应用，或是备忘录、笔记、邮件等富文本编辑类应用时，均可接入跨设备剪贴板，提升用户体验。

运作机制

1. 用户在设备A复制数据。

2. 系统剪贴板服务将处理相关数据，并完成数据同步。此过程开发者不感知。

3. 用户在设备B粘贴来自设备A的数据。

在开发跨设备剪贴板的功能时，系统将自动完成跨设备的数据传递，应用可按照本设备上的开发示例，完成跨设备剪贴板的开发。

约束与限制

接口说明

在开发具体功能前，请先查阅参考文档，获取详细的接口说明。

开发示例

说明

跨设备复制的数据两分钟内有效。

• 设备A复制数据，写入到剪贴板服务。

  import pasteboard from '@ohos.pasteboard';
  import { BusinessError } from '@ohos.base';
  
  export async function setPasteDataTest(): Promise<void> {
    let text: string = 'hello world';
    let pasteData: pasteboard.PasteData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_PLAIN, text);
    let systemPasteBoard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard();
    await systemPasteBoard.setData(pasteData).catch((err: BusinessError) => {
      console.error(`Failed to set pastedata. Code: ${err.code}, message: ${err.message}`);
    });
  }

• 设备B粘贴数据，读取剪贴板内容。

  import pasteboard from '@ohos.pasteboard';
  import { BusinessError } from '@ohos.base';
  
  export async function getPasteDataTest(): Promise<void> {
    let systemPasteBoard: pasteboard.SystemPasteboard = pasteboard.getSystemPasteboard();
    systemPasteBoard.getData((err: BusinessError, data: pasteboard.PasteData) => {
      if (err) {
        console.error(`Failed to get pastedata. Code: ${err.code}, message: ${err.message}`);
        return;
      }
      // 对pastedata进行处理，获取类型，个数等
      let recordCount: number = data.getRecordCount(); // 获取剪贴板内record的个数
      let types: string = data.getPrimaryMimeType(); // 获取剪贴板内数据的类型
      let primaryText: string = data.getPrimaryText(); // 获取剪贴板内数据的内容
    });
  }