HarmonyOS Next跨应用跨设备数据共享实战：从拖拽到同步 原创

{
  "UniformDataTypeDeclarations": [
    {
      "TypeId": "com.example.image",
      "BelongingToTypes": ["general.image"],
      "FilenameExtensions": [".jpg", ".png"],
      "MIMETypes": ["image/jpeg", "image/png"],
      "Description": "Shared image",
      "ReferenceURL": ""
    },
    {
      "TypeId": "com.example.text",
      "BelongingToTypes": ["general.plain-text"],
      "Description": "Shared plain text",
      "ReferenceURL": ""
    }
  ]
}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

import { uniformDataStruct, uniformTypeDescriptor, unifiedDataChannel } from '@kit.ArkData';

let imageDetails: Record<string, string> = {
  'attr1': 'image_attribute_1',
  'attr2': 'image_attribute_2',
};

let image: uniformDataStruct.Image = {
  uniformDataType: 'com.example.image',
  url: 'path/to/image.jpg',
  description: 'This is an example image',
  details: imageDetails,
};

// 创建纯文本数据
let plainTextDetails: Record<string, string> = {
  'attr1': 'text_attribute_1',
  'attr2': 'text_attribute_2',
};

let plainText: uniformDataStruct.PlainText = {
  uniformDataType: 'com.example.text',
  textContent: 'This is a plain text example',
  abstract: 'Text abstract',
  details: plainTextDetails,
};

// 将数据放入统一数据对象
let unifiedData = new unifiedDataChannel.UnifiedData();
let imageRecord = new unifiedDataChannel.UnifiedRecord(uniformTypeDescriptor.UniformDataType.IMAGE, image);
let plainTextRecord = new unifiedDataChannel.UnifiedRecord(uniformTypeDescriptor.UniformDataType.PLAIN_TEXT, plainText);

unifiedData.addRecord(imageRecord);
unifiedData.addRecord(plainTextRecord);

// 将数据拖拽至目标区域
unifiedDataChannel.setDragData(unifiedData);
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.
23.
24.
25.
26.
27.
28.
29.
30.
31.
32.
33.
34.
35.
36.
37.

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

let sessionId = distributedDataObject.genSessionId();
let dataObject = distributedDataObject.create(this.context, unifiedData);

// 设置同步的sessionId
dataObject.setSessionId(sessionId);

// 监听同步状态
dataObject.on('status', (sessionId: string, networkId: string, status: string) => {
  if (status == 'restored') {
    console.log(`Data restored on device: ${networkId}`);
  }
});

// 保存数据到其他设备
let targetDeviceId = 'device_B_network_id';  // 目标设备的网络ID
dataObject.save(targetDeviceId);
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.

let receivedDataObject = distributedDataObject.create(this.context, null);

// 设置相同的sessionId进行同步
receivedDataObject.setSessionId(sessionId);

// 监听同步数据变化
receivedDataObject.on('change', (sessionId: string, fields: Array<string>) => {
  fields.forEach((field) => {
    console.log(`Field changed: ${field}, new value: ${receivedDataObject[field]}`);
  });
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.

dataObject.on('change', (sessionId: string, fields: Array<string>) => {
  fields.forEach((field) => {
    console.log(`Data field ${field} has changed on session ${sessionId}`);
    
    // 解决冲突：我们可以根据业务逻辑手动处理冲突
    if (field === 'textContent') {
      if (receivedDataObject[field] !== dataObject[field]) {
        console.log(`Conflict detected in ${field}.`);
        // 手动解决冲突逻辑，例如保留最新的值
        dataObject[field] = receivedDataObject[field];
      }
    }
  });
});
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.