文档开发者中心
我的
|

HarmonyOS 5

HarmonyOS分布式剪贴板开发——跨设备无缝流转的设计奥秘(二)之代码实操:

1. 开发四步曲

步骤1:写入数据

收起
自动换行
深色代码主题
复制
import pasteboard from '@ohos.pasteboard';
// 创建文本数据(跨设备同步)
let textData = pasteboard.createData(
  pasteboard.MIMETYPE_TEXT_PLAIN, 
  "跨设备粘贴测试"
);
// 创建仅本地数据(如URI)
let uriData = pasteboard.createUriData("file://internal/storage/image.jpg");
uriData.setLocalOnly(true); // 禁止跨设备同步

// 写入系统剪贴板
let sysPasteboard = pasteboard.getSystemPasteboard();
sysPasteboard.setData(textData);

步骤2:读取数据

收起
自动换行
深色代码主题
复制
sysPasteboard.getData().then((data) => {
  if (data.hasMimeType(pasteboard.MIMETYPE_TEXT_PLAIN)) {
    console.log("文本内容:" + data.getPrimaryText());
  } else if (data.hasMimeType(pasteboard.MIMETYPE_TEXT_URI)) {
    console.log("URI内容:" + data.getPrimaryUri());
  }
}).catch((err) => {
  console.error("读取失败:" + err.code);
});

步骤3:监听剪贴板变化

收起
自动换行
深色代码主题
复制
// 注册监听器
let listenerId = pasteboard.on('update', () => {
  console.log("剪贴板内容已更新!");
});

// 取消监听(页面销毁时)
pasteboard.off('update', listenerId); 

2. 避坑指南

  • 权限缺失处理

    收起
    自动换行
    深色代码主题
    复制
    // config.json 添加权限
    "reqPermissions": [{
      "name": "ohos.permission.DISTRIBUTED_DATASYNC"
    }]
    • 首次跨设备同步需动态申请权限:requestPermissionsFromUser()

  • 超量传输拦截

    • 跨设备数据>64KB时,setData() 返回错误码 201(建议压缩文本或分片传输)

  • 生命周期管理

    收起
    自动换行
    深色代码主题
    复制
    // 监听应用前后台切换
    appManager.on('activeStateChange', (state) => {
      if (state === 0) { // 进入后台
        sysPasteboard.clear(); // 主动清除敏感数据
      }
    });

3. 性能优化技巧

  1. 预加载机制

    收起
    自动换行
    深色代码主题
    复制
    // 预测用户可能粘贴时提前加载
    deviceManager.suspendDeviceSync(false); // 保持设备连接
  2. 数据压缩策略

    收起
    自动换行
    深色代码主题
    复制
    import zlib from '@ohos.zlib';
    let compressed = zlib.compressSync(textData); // GZIP压缩
  3. 能耗控制

    • 屏幕关闭时暂停同步:power.on('screenState') 事件管理

4. 完整流程图解

收起
自动换行
深色代码主题
复制
设备A->>+分布式数据库: 加密写入数据
  分布式数据库-->>设备B: 推送变更通知
  设备B->>+分布式数据库: 请求数据
  分布式数据库-->>-设备B: 返回解密数据
  设备B->>UI: 渲染粘贴内容
点赞
收藏
回复
分享
举报
浏览170 发布于2025-06-29 08:34北京
全部评论
最多点赞
最新发布
最早发布
暂无评论
暂无评论
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。