HarmonyOS 设备自动发现与连接全攻略：从原理到可运行 Demo
摘要
在智能设备越来越多的今天，让设备之间**“自动认识并说上话”**，已经成为一个刚需。无论是智能家居、可穿戴设备，还是车机系统，用户都希望设备开机就能互相发现并自动连接，减少繁琐的手动配对流程。
鸿蒙系统（HarmonyOS）提供了强大的设备发现与分布式连接能力，结合蓝牙、Wi-Fi 以及分布式软总线等技术，可以让开发者很容易地实现“自动发现 + 自动连接”的体验。本文将带你从原理到实战，一步步实现鸿蒙下的设备自动发现与连接功能。
引言
在传统的 IoT（物联网）设备中，想让两台设备互联，往往需要：
- 用户手动进入配对模式
- 搜索可用设备
- 手动选择目标并输入密码
这种方式不仅繁琐，还很容易因为用户操作失误导致连接失败。
而在鸿蒙系统中，这个过程可以**“全自动”**化：
- 设备开机自动广播自身信息
- 系统扫描到符合条件的设备自动发起连接
- 分布式能力完成跨设备数据传输和协作
比如，你回家时，手机自动连接到家里的音响并播放音乐；或者你靠近车子，车机自动解锁并同步导航信息。这种流畅体验正是鸿蒙的强项。
设备自动发现的基本原理
蓝牙与 Wi-Fi 扫描
鸿蒙提供了 API 来扫描周围支持蓝牙 / Wi-Fi 的设备。它会返回设备 ID、MAC 地址、信号强度等信息，开发者可以据此判断是否是“目标设备”。
服务发现与设备标识
鸿蒙的 设备标识管理 机制可以区分不同设备，并支持服务发现（Service Discovery），即不仅找到设备，还知道它提供哪些功能（播放音乐、温度控制等）。
分布式自动连接
基于鸿蒙的 分布式软总线（SoftBus），设备可以在局域网或近场自动组网，免去手动配对。你只需要在代码里注册发现和连接回调，剩下的交给系统。
实现步骤与 Demo 代码
下面我们写一个基于鸿蒙分布式能力的设备自动发现 + 自动连接 Demo，假设场景是两台鸿蒙设备（手机和 IoT 设备）之间自动互联。
引入依赖
在 module.json5 中添加：
{"requestPermissions": [{ "name": "ohos.permission.DISCOVER_BLUETOOTH" },{ "name": "ohos.permission.LOCATION" },{ "name": "ohos.permission.DISTRIBUTED_DATASYNC" }]
}
这些权限用于扫描蓝牙/Wi-Fi 和进行分布式数据同步。
自动发现与连接代码示例
import deviceManager from '@ohos.distributedHardware.deviceManager';let dmInstance: deviceManager.DeviceManager | null = null;// 创建设备管理实例
function initDeviceManager() {deviceManager.createDeviceManager('com.example.demo', (err, data) => {if (err) {console.error('DeviceManager create failed: ' + JSON.stringify(err));return;}dmInstance = data;console.info('DeviceManager created successfully');startDeviceDiscovery();});
}// 开始自动发现设备
function startDeviceDiscovery() {if (!dmInstance) return;dmInstance.startDeviceDiscovery('auto_discovery', {subscribeId: 1001,mode: 1, // 主动搜索模式medium: 2, // 2 表示 BLE，3 表示 Wi-Fifreq: 2, // 高频isSameAccount: true,isWakeRemote: true,capability: 1,});dmInstance.on('deviceFound', (data) => {console.info('Device found: ' + JSON.stringify(data));// 根据设备ID判断是否为目标设备if (data?.deviceId && isTargetDevice(data.deviceId)) {autoConnectDevice(data.deviceId);}});
}// 判断是否为目标设备
function isTargetDevice(deviceId: string): boolean {// 这里可以根据预设的设备ID、名称等来判断return deviceId.startsWith('DEVICE_ABC');
}// 自动连接
function autoConnectDevice(deviceId: string) {if (!dmInstance) return;dmInstance.authenticateDevice(deviceId, {authType: 1, // 1 表示 PIN 码配对extraInfo: {}}, (err, data) => {if (err) {console.error('Connect failed: ' + JSON.stringify(err));return;}console.info('Connected to device: ' + deviceId);});
}initDeviceManager();
代码说明
- createDeviceManager：创建设备管理实例，后续的扫描和连接都基于它
- startDeviceDiscovery：自动扫描设备，
medium决定使用蓝牙或 Wi-Fi - deviceFound 回调：发现设备后自动调用
autoConnectDevice - isTargetDevice：用来过滤目标设备，避免乱连
- authenticateDevice：发起连接和认证过程
典型应用场景
智能家居自动连接
回家时，手机通过鸿蒙自动发现并连接家里的智能灯光系统：
if (isTargetDevice(deviceId) && deviceName.includes('SmartLight')) {setLightStatus(deviceId, 'ON');
}
车机自动解锁与同步导航
靠近汽车时，鸿蒙自动发现车机并发送导航数据：
if (isTargetDevice(deviceId) && deviceName.includes('CarSystem')) {sendNavigationData(deviceId, currentRoute);
}
多设备音乐共享
朋友聚会时，多个设备自动连接到同一个音响系统：
if (deviceSupportsService(deviceId, 'AUDIO_PLAY')) {syncMusic(deviceId, currentTrack);
}
常见问题 QA
Q1：自动发现会不会乱连陌生设备？
不会。你可以在 isTargetDevice 中加入白名单或加密认证机制，只连你允许的设备。
Q2：发现设备很慢怎么办？
可以提高 freq 参数为高频模式，并同时启用蓝牙和 Wi-Fi 扫描，提升发现速度。
Q3：跨网络的设备也能自动连接吗？
在局域网和近场通信下可以全自动连接，跨公网需要配合鸿蒙的云协同能力或自建信令服务。
总结
鸿蒙的设备自动发现和连接能力，让设备间的交互从“需要手动配对”进化到“开机即连”，不仅提升了用户体验，也降低了开发难度。
通过蓝牙/Wi-Fi 扫描 + 分布式软总线 + 服务发现机制，你可以轻松构建一个无感互联的多设备生态。
未来，这套机制在智能家居、车联网、可穿戴设备、工业物联网等领域都会有更大的用武之地。