《HarmonyOS 7 跨设备数据协同专题》01:DistributedDataObject 的 Session 与对象同步机制【鸿蒙心迹】

发布时间:2026/9/23 10:23:19
《HarmonyOS 7 跨设备数据协同专题》01:DistributedDataObject 的 Session 与对象同步机制【鸿蒙心迹】 手机改了一个标题平板为什么像读本地变量一样拿到了新值做跨设备笔记的时候最开始的思路很简单手机改了笔记通过接口把数据发给平板就行了。结果做出来发现特别麻烦要管网络连接、要管消息发送、要管两端状态同步。一大堆代码。后来才知道 HarmonyOS 有分布式数据对象直接就像操作本地变量一样两端自动同步。手机改一个值平板那边自动收到。一、普通对象和分布式对象有什么区别先看一个普通 ArkTS 对象letnote{title:我的笔记}这个对象只在当前设备内存里。另一台设备看不到。分布式数据对象不一样你创建一个分布式对象同一个 Session 下的设备这个对象就是共享的。手机改了平板那边自动收到。类型同步方式跨设备普通对象手动传不能分布式对象自动同步可以二、SessionId 是什么SessionId 就是一个会话标识。同一个 SessionId 下的分布式对象才会互相同步。你创建两个对象SessionId 不一样那它们各管各的互相同步不了。这段代码解决什么问题创建分布式笔记对象。文件distributed/NoteObject.ets用途跨设备笔记同步接入位置笔记创建import{distributedDataObject}fromkit.ArkData;// 创建分布式对象letnoteObjdistributedDataObject.create(this.context);// 生成 SessionIdletsessionIddistributedDataObject.genSessionId();// 设置 SessionId建立同步关系noteObj.setSessionId(sessionId);// 像操作普通对象一样赋值noteObj.title我的新笔记;这里最关键的就是 setSessionId。同一个 SessionId 的设备这个对象才会同步。三、change 回调是什么分布式对象变了怎么知道通过 change 回调。你注册一个 change 回调对象数据变了它就会触发告诉你哪个字段变了。noteObj.on(change,(fields){// 哪些字段变了console.log(变化的字段:,fields);// 更新 UIthis.refreshUI();});四、几个容易踩的坑第一个坑两端 SessionId 不一致。你这边 SessionId 是 A那边是 B根本同步不了。第二个坑把 Session 当设备 ID。SessionId 是会话标识不是设备唯一标识。第三个坑目标设备初始数据覆盖源设备。新设备加入 Session 的时候初始数据不对把原来的覆盖了。第四个坑退出页面后监听器未注销。页面都关了回调还在跑。五、Local 和 Distributed 状态分布式对象有状态变化。刚创建的时候是 Local加入 Session 之后才是 Distributed。状态说明Local本地对象还没加入 SessionDistributed已加入 Session跨设备同步中你可以通过 status 回调监听这个状态变化。这次做跨设备同步最大的体会是分布式数据对象把跨设备同步这件事简化到像操作本地变量一样。但底层还是有 Session、状态、回调这些机制不是完全不管就行的。