分布式软总线设备发现机制支持harmonyos设备在不手动配对、不依赖同一wi-fi、不开启蓝牙界面条件下，基于华为账号自动识别附近可信设备；其运行需harmonyos 4.2+、开启“多设备协同”开关，并通过devicemanager或discovery模块调用多协议联合发现（ble/wi-fi aware/plc），由系统自动完成身份校验与安全过滤。
要在HarmonyOS中让手机自动识别附近的平板、智慧屏或耳机等设备，无需手动配对、不依赖同一Wi-Fi、不打开蓝牙设置界面，直接通过系统级能力完成可信设备发现——这正是分布式软总线设备发现机制的核心目标。
确认基础运行环境
确保目标设备已升级至HarmonyOS 4.2及以上版本，且均登录同一华为账号。旧版本（如3.0以下）不支持Wi-Fi Aware与PLC双模发现，部分设备可能仅回退到BLE单模广播，发现成功率下降约40%。
检查设备是否开启“多设备协同”开关：设置 → 系统和更新 → 多设备协同 → 开启“设备发现”和“自动连接”。【此开关关闭时，即使代码调用deviceManager.startDiscovery()也不会触发任何广播或扫描】
验证网络拓扑：两台设备必须处于同一局域网（Wi-Fi同频段优先），或物理距离≤10米（启用BLE 5.2时）。跨路由器或AP隔离环境下，Wi-Fi Aware将失效，仅靠BLE维持基础发现能力。
使用@ohos.distributedHardware.deviceManager实现发现
方法一：标准设备发现流程（推荐用于生产环境）
第一步：在module.json5中声明权限："reqPermissions": [{ "name": "ohos.permission.DISTRIBUTED_DEVICE_MANAGER" }]。缺少该权限会导致startDiscovery()静默失败，无错误日志输出。
第二步：导入并初始化DeviceManager实例：
import deviceManager from '@ohos.distributedHardware.deviceManager';
const dm = deviceManager.createDeviceManager();
第三步：注册设备发现回调，再启动扫描：
dm.on('discoverDevice', (data: DeviceInfo) => { console.info('发现设备:', data.deviceName, data.deviceId); });dm.startDiscovery({ strategy: deviceManager.DiscoveryStrategy.PEER_DEVICES });
注意：startDiscovery()必须在on()监听注册后调用，否则首次发现事件会丢失。该策略仅发现同账号下已认证的HarmonyOS设备，不包含未登录账号的访客设备。
启用多协议联合发现（鸿蒙5.0+专属）
鸿蒙5.0起支持BLE + Wi-Fi Aware + PLC三模并发发现，大幅提升复杂环境下的设备触达率。需使用新API路径：
导入新模块：import discovery from '@ohos.device.discovery';
创建管理器并配置协议组合：
const dm = discovery.createDeviceManager({ scope: discovery.Scope.ALL_DEVICES });await dm.startDiscovery({ protocols: [discovery.Protocol.BLE, discovery.Protocol.WIFI_AWARE] });
Wi-Fi Aware要求设备Wi-Fi处于开启状态但无需连接网络；PLC模式仅在搭载电力线通信模块的工业终端上可用，消费级设备调用该协议会自动跳过。该调用返回Promise，拒绝时抛出BusinessError，错误码6000003表示当前设备不支持指定协议。
发现结果中DeviceInfo新增字段discoveryMethod: 'wifi_aware' | 'ble' | 'plc'，可用于前端UI差异化展示连接质量图标。
过滤与匹配可信设备
发现回调返回的DeviceInfo对象含deviceId、deviceName、networkId、capabilities等字段。其中capabilities是Set结构，可直接判断是否支持所需能力：
if (data.capabilities.has('video_playback')) { // 该设备支持投屏 }
关键过滤逻辑应放在回调内而非启动前：startDiscovery()不支持filter参数，所有广播设备都会触发on('discoverDevice')，必须由业务层自行筛除非目标设备。避免在回调中执行耗时操作（如网络请求），否则会阻塞后续发现事件分发。
设备身份可信性由系统自动保障——只有通过华为云证书校验且绑定同一账号的设备才会出现在discoverDevice事件中。伪造deviceId或篡改广播内容会被服务层拦截，不会进入应用回调。
