HarmonyOS 设备自动发现与连接全攻略：从原理到可运行 Demo

摘要

在智能设备越来越多的今天，让设备之间**"自动认识并说上话"**，已经成为一个刚需。无论是智能家居、可穿戴设备，还是车机系统，用户都希望设备开机就能互相发现并自动连接，减少繁琐的手动配对流程。

鸿蒙系统（HarmonyOS）提供了强大的设备发现与分布式连接能力，结合蓝牙、Wi-Fi 以及分布式软总线等技术，可以让开发者很容易地实现"自动发现 + 自动连接"的体验。本文将带你从原理到实战，一步步实现鸿蒙下的设备自动发现与连接功能。

引言

在传统的 IoT（物联网）设备中，想让两台设备互联，往往需要：

用户手动进入配对模式
搜索可用设备
手动选择目标并输入密码

这种方式不仅繁琐，还很容易因为用户操作失误导致连接失败。

而在鸿蒙系统中，这个过程可以**"全自动"**化：

设备开机自动广播自身信息
系统扫描到符合条件的设备自动发起连接
分布式能力完成跨设备数据传输和协作

比如，你回家时，手机自动连接到家里的音响并播放音乐；或者你靠近车子，车机自动解锁并同步导航信息。这种流畅体验正是鸿蒙的强项。

设备自动发现的基本原理

蓝牙与 Wi-Fi 扫描

鸿蒙提供了 API 来扫描周围支持蓝牙 / Wi-Fi 的设备。它会返回设备 ID、MAC 地址、信号强度等信息，开发者可以据此判断是否是"目标设备"。

服务发现与设备标识

鸿蒙的 设备标识管理 机制可以区分不同设备，并支持服务发现（Service Discovery），即不仅找到设备，还知道它提供哪些功能（播放音乐、温度控制等）。

分布式自动连接

基于鸿蒙的 分布式软总线（SoftBus），设备可以在局域网或近场自动组网，免去手动配对。你只需要在代码里注册发现和连接回调，剩下的交给系统。

实现步骤与 Demo 代码

下面我们写一个基于鸿蒙分布式能力的设备自动发现 + 自动连接 Demo，假设场景是两台鸿蒙设备（手机和 IoT 设备）之间自动互联。

引入依赖

在 module.json5 中添加：

json 复制代码

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

这些权限用于扫描蓝牙/Wi-Fi 和进行分布式数据同步。

自动发现与连接代码示例

typescript 复制代码

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-Fi
    freq: 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：发起连接和认证过程

典型应用场景

智能家居自动连接

回家时，手机通过鸿蒙自动发现并连接家里的智能灯光系统：

typescript 复制代码

if (isTargetDevice(deviceId) && deviceName.includes('SmartLight')) {
  setLightStatus(deviceId, 'ON');
}

车机自动解锁与同步导航

靠近汽车时，鸿蒙自动发现车机并发送导航数据：

typescript 复制代码

if (isTargetDevice(deviceId) && deviceName.includes('CarSystem')) {
  sendNavigationData(deviceId, currentRoute);
}

多设备音乐共享

朋友聚会时，多个设备自动连接到同一个音响系统：

typescript 复制代码

if (deviceSupportsService(deviceId, 'AUDIO_PLAY')) {
  syncMusic(deviceId, currentTrack);
}

常见问题 QA

Q1：自动发现会不会乱连陌生设备？

不会。你可以在 isTargetDevice 中加入白名单或加密认证机制，只连你允许的设备。

Q2：发现设备很慢怎么办？

可以提高 freq 参数为高频模式，并同时启用蓝牙和 Wi-Fi 扫描，提升发现速度。

Q3：跨网络的设备也能自动连接吗？

在局域网和近场通信下可以全自动连接，跨公网需要配合鸿蒙的云协同能力或自建信令服务。

HarmonyOS 设备自动发现与连接全攻略：从原理到可运行 Demo

摘要

引言

设备自动发现的基本原理

蓝牙与 Wi-Fi 扫描

服务发现与设备标识

分布式自动连接

实现步骤与 Demo 代码

引入依赖

自动发现与连接代码示例

代码说明

典型应用场景

智能家居自动连接

车机自动解锁与同步导航

多设备音乐共享

常见问题 QA

总结