鸿蒙分布式开发实战指南：让设备协同像操作本地一样简单

"requestPermissions": [
  {
    "name": "ohos.permission.DISTRIBUTED_DATASYNC"
  },
  {
    "name": "ohos.permission.DISTRIBUTED_DEVICE_STATE"
  }]

示例代码：获取可信设备列表

import deviceManager from '@ohos.distributedDeviceManager';let deviceMgr = null;
deviceManager.createDeviceManager('com.example.app', (err, mgr) => {  if (!err) {
    deviceMgr = mgr;    // 获取可信设备列表
    let trustedList = deviceMgr.getTrustedDeviceListSync();
    trustedList.forEach(device => {      console.log(`设备名称: ${device.deviceName}, 网络ID: ${device.networkId}`);
    });
  }
});

这段代码获取了当前所有可信的设备列表，并可以在后续进行任务调度时作为目标设备进行识别。

基于UDMF统一数据通路的数据共享实现

鸿蒙提供的  UDMF（Unified Data Management Framework） 是一个跨设备的数据传输框架。

数据提供方

import { unifiedDataChannel, uniformTypeDescriptor } from '@kit.ArkData';const data = {  name: 'sync_text',  value: '这是要同步到其他设备的文字内容'};// 插入到统一数据通路unifiedDataChannel.insert({  data: data,  type: uniformTypeDescriptor.TEXT}).then(() => {  console.log('插入数据成功');
});

数据访问方

import { unifiedDataChannel } from '@kit.ArkData';
unifiedDataChannel.query({  type: uniformTypeDescriptor.TEXT}).then(result => {
  result.forEach(item => {    console.log(`收到同步数据：${item.data.value}`);
  });
});

典型应用场景与代码讲解

场景一：手机向电视推送一条指令执行任务

描述

用户在手机APP里点击按钮，电视立即开始播放一段视频。

简化代码实现（手机端）

kvStore.put('tv_action', 'play_video'); // kvStore 为分布式数据对象

简化代码实现（电视端）

kvStore.on('dataChange', (changed) => {  if (changed.insertEntries.some(entry => entry.key === 'tv_action' && entry.value === 'play_video')) {    // 执行播放视频的本地逻辑
    startVideo();
  }
});

场景二：智能手表检测到跑步，自动让音箱播放音乐

逻辑流程

1. 手表检测心率或加速度后识别为“运动状态”
2. 将数据同步至音箱
3. 音箱接收到数据后自动播放音乐

手表端示意代码

kvStore.put('user_activity', 'running');

音箱端示意代码

kvStore.on('dataChange', (changed) => {  if (changed.insertEntries.some(e => e.key === 'user_activity' && e.value === 'running')) {    playMusic('动感跑步歌单');
  }
});

QA环节

Q1：分布式数据同步会有延迟吗？ 答：系统提供的是异步同步机制，通常在局域网内同步延迟在百毫秒级别，如果网络不稳定可能会存在延迟，建议关键任务数据做好状态确认。

Q2：不同设备运行不同App能不能同步？ 答：必须是同一个应用包名的设备，且通过设备认证后，才能建立分布式数据同步关系。

Q3：是否可以手动指定任务运行在哪个设备？ 答：可以，获取到可信设备后，可以通过  networkId 标识去下发特定指令或设置目标数据，前提是该设备已经绑定并处于在线状态。