HarmonyOS Next跨设备剪贴板技术解析原创

SameX

发布于 2025-3-3 10:29

浏览

0收藏

在HarmonyOS Next系统里，跨设备剪贴板的出现让多设备间的数据共享变得轻松又高效。咱们先来说说它的原理。当用户在设备A复制数据时，系统剪贴板服务会对数据进行处理，然后通过设备间的连接通道（比如Wi-Fi、蓝牙，在同一局域网下效果更佳）将数据同步到设备B的剪贴板服务。这个过程中，设备A和设备B需要登录同一华为账号，并且都要打开Wi-Fi和蓝牙开关，这样才能确保数据能准确无误地传输。

从数据同步机制来看，它有点像快递运输。每个设备的剪贴板服务就像是快递站点，数据就是包裹。当数据被复制后，它会被“打包”并通过特定的“运输路线”（设备连接通道）送到目标设备的“站点”（剪贴板服务）。而且，跨设备复制的数据在两分钟内有效，就像快递包裹有个保鲜期一样，过了这个时间，数据就失效啦。

再讲讲剪贴板数据生命周期。从数据被复制进入剪贴板，到被粘贴或者过期失效，这个过程中系统会对数据进行管理。在有效时间内，数据随时准备被粘贴到其他设备上，一旦过期，就会被清理掉，以保证剪贴板的空间和数据的时效性。

在实际开发中，跨设备剪贴板的API使用是重点。先看getSystemPasteboard()，这就像是打开了设备的剪贴板仓库大门，通过它我们可以获取到系统剪贴板对象，后续对剪贴板的操作都得通过这个对象来进行。

setData()方法呢，是用来把我们想要分享的数据“放进”剪贴板仓库。比如我们有一段文本或者一张图片要复制，就用这个方法把数据存进去。不过在使用自定义控件后台访问剪贴板时，别忘了申请ohos.permission.READ_PASTEBOARD权限，不然就没办法顺利把数据存进去啦。

getData()则是从剪贴板仓库里“取出”数据。当我们在设备B上想要粘贴数据时，就调用这个方法，它会返回我们之前复制的数据，然后我们就能对这些数据进行处理，比如显示在界面上或者进行其他操作。

下面给大家来个实际开发案例，看看在不同设备间复制文本与图片是怎么实现的。先看设备A复制数据的代码：

import pasteboard from '@ohos.pasteboard';
import { BusinessError } from '@ohos.base';

export async function setPasteDataTest(): Promise<void> {
    // 准备要复制的文本
    let text: string = '这是一段跨设备复制的文本';
    // 创建一个纯文本类型的剪贴板数据对象
    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}`);
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.

在这段代码里，我们先定义了要复制的文本，然后用createData()方法创建了一个符合纯文本格式的剪贴板数据对象，再通过getSystemPasteboard()获取系统剪贴板对象，最后用setData()把数据写入剪贴板。如果写入过程出现错误，就会在控制台打印错误信息。

接着看设备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;
        }
        // 获取剪贴板内数据的个数
        let recordCount: number = data.getRecordCount(); 
        // 获取剪贴板内数据的类型
        let types: string = data.getPrimaryMimeType(); 
        // 获取剪贴板内数据的内容
        let primaryText: string = data.getPrimaryText(); 
        console.log(`剪贴板数据个数: ${recordCount}`);
        console.log(`数据类型: ${types}`);
        console.log(`数据内容: ${primaryText}`);
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.

在设备B这边，同样先获取系统剪贴板对象，然后用getData()方法从剪贴板获取数据。这里通过回调函数处理获取到的数据，如果获取过程有错误，也会打印错误信息。获取到数据后，我们可以进一步处理，这里只是简单地把数据的相关信息打印出来。

如果要复制图片，原理类似，不过数据类型就不是纯文本啦，而是图片对应的MIME类型。比如在设备A上复制图片：

import pasteboard from '@ohos.pasteboard';
import { BusinessError } from '@ohos.base';

export async function setImagePasteDataTest(): Promise<void> {
    // 假设这里有一个图片资源的路径或者二进制数据
    let imageData = getImageDataSomehow(); 
    let pasteData: pasteboard.PasteData = pasteboard.createData(pasteboard.MIMETYPE_IMAGE_PNG, imageData);
    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}`);
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.

在设备B上粘贴图片数据时，就需要根据图片类型进行相应的处理，比如显示在界面上：

import pasteboard from '@ohos.pasteboard';
import { BusinessError } from '@ohos.base';

export async function getImagePasteDataTest(): 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;
        }
        if (data.getPrimaryMimeType() === pasteboard.MIMETYPE_IMAGE_PNG) {
            let imageData = data.getPrimaryImage(); 
            // 这里可以用imageData在界面上显示图片
        }
    });
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.

以上就是HarmonyOS Next跨设备剪贴板的技术解析和实际开发案例，希望对大家有所帮助。如果在开发过程中有什么问题，欢迎一起交流探讨。

分类

HarmonyOS

标签

鸿蒙

51CTO

51CTO博客

51CTO学堂

HarmonyOS Next跨设备剪贴板技术解析原创

订阅鸿蒙技术特刊，精选内容抢先看

51CTO

51CTO博客

51CTO学堂

HarmonyOS Next跨设备剪贴板技术解析 原创

订阅鸿蒙技术特刊，精选内容抢先看

HarmonyOS Next跨设备剪贴板技术解析原创