手机改了一个标题，平板为什么像读本地变量一样拿到了新值？

做跨设备笔记的时候，最开始的思路很简单：手机改了笔记，通过接口把数据发给平板就行了。

结果做出来发现特别麻烦：要管网络连接、要管消息发送、要管两端状态同步。一大堆代码。

后来才知道 HarmonyOS 有分布式数据对象，直接就像操作本地变量一样，两端自动同步。手机改一个值，平板那边自动收到。

一、普通对象和分布式对象有什么区别

先看一个普通 ArkTS 对象：

let note = {
  title: '我的笔记'
}

这个对象只在当前设备内存里。另一台设备看不到。

分布式数据对象不一样：你创建一个分布式对象，同一个 Session 下的设备，这个对象就是共享的。手机改了，平板那边自动收到。

类型	同步方式	跨设备
普通对象	手动传	不能
分布式对象	自动同步	可以

二、SessionId 是什么

SessionId 就是一个会话标识。同一个 SessionId 下的分布式对象，才会互相同步。

你创建两个对象，SessionId 不一样，那它们各管各的，互相同步不了。

这段代码解决什么问题： 创建分布式笔记对象。
文件： distributed/NoteObject.ets
用途： 跨设备笔记同步
接入位置： 笔记创建

import { distributedDataObject } from '@kit.ArkData';

// 创建分布式对象
let noteObj = distributedDataObject.create(this.context);

// 生成 SessionId
let sessionId = distributedDataObject.genSessionId();

// 设置 SessionId，建立同步关系
noteObj.setSessionId(sessionId);

// 像操作普通对象一样赋值
noteObj.title = '我的新笔记';

这里最关键的就是 setSessionId。同一个 SessionId 的设备，这个对象才会同步。

三、change 回调是什么

分布式对象变了，怎么知道？通过 change 回调。

你注册一个 change 回调，对象数据变了，它就会触发，告诉你哪个字段变了。

noteObj.on('change', (fields) => {
  // 哪些字段变了
  console.log('变化的字段:', fields);
  // 更新 UI
  this.refreshUI();
});

四、几个容易踩的坑

第一个坑：两端 SessionId 不一致。你这边 SessionId 是 A，那边是 B，根本同步不了。

第二个坑：把 Session 当设备 ID。SessionId 是会话标识，不是设备唯一标识。

第三个坑：目标设备初始数据覆盖源设备。新设备加入 Session 的时候，初始数据不对，把原来的覆盖了。

第四个坑：退出页面后监听器未注销。页面都关了，回调还在跑。

五、Local 和 Distributed 状态

分布式对象有状态变化。刚创建的时候是 Local，加入 Session 之后才是 Distributed。

状态	说明
Local	本地对象，还没加入 Session
Distributed	已加入 Session，跨设备同步中

你可以通过 status 回调监听这个状态变化。

这次做跨设备同步最大的体会是：分布式数据对象把跨设备同步这件事，简化到像操作本地变量一样。但底层还是有 Session、状态、回调这些机制，不是完全不管就行的。