HarmonyOS 实时监听与获取 Wi-Fi 信息

摘要

本文展示了如何使用 HarmonyOS 框架开发一个 Demo，用于监听手机的 Wi-Fi 状态变化并实时获取连接的 Wi-Fi 信息。通过订阅 Wi-Fi 状态事件，我们实现了 Wi-Fi 状态的动态监听，并在状态变化时调用方法刷新 Wi-Fi 详情。

项目功能概述

本 Demo 主要实现以下功能：

1. Wi-Fi 状态监听：实时监测 Wi-Fi 连接状态的变化（如连接中、已连接、断开连接等）。
2. Wi-Fi 信息获取：动态获取当前连接 Wi-Fi 的 SSID 和 MAC 地址。
3. 事件驱动回调：通过事件订阅机制，在 Wi-Fi 状态变化时触发回调并更新 UI。

代码模块详细说明

创建 Wi-Fi 状态保存对象

CommonEventBean 是一个简单的类，用于保存 Wi-Fi 的当前状态以及订阅者对象。

export class CommonEventBean {
  /**
   * Wi-Fi 当前状态的描述。
   */
  state: string = '初始化状态';

  /**
   * 保存事件订阅者对象。
   */
  subscriber: any = null;
}

Wi-Fi 状态监听模块

通过 CommonEventManager.createSubscriber 创建订阅者，监听 Wi-Fi 状态的变化事件。

核心功能包括：

1. 根据状态变化更新 CommonEventBean 的 state 属性。
2. 当状态为“已连接”时，触发后续 Wi-Fi 信息获取方法。

代码实现如下：

export class WifiStatusListener {
  subscribe(commonEventItem: CommonEventBean, callback: Function): void {
    const subscribeInfo = { events: ['CommonConstants.CONN_STATE'] };
    let toastMsg: string;

    CommonEventManager.createSubscriber(subscribeInfo, (err, subscriber) => {
      if (err || subscriber === null) {
        toastMsg = '创建订阅失败';
        callback(commonEventItem, toastMsg);
        return;
      }
      commonEventItem.subscriber = subscriber;

      CommonEventManager.subscribe(subscriber, (err, data) => {
        if (err) {
          toastMsg = '订阅失败';
          callback(commonEventItem, toastMsg);
          return;
        }

        const connState = data?.data;
        if (connState) {
          switch (connState) {
            case 'connecting':
              commonEventItem.state = 'Wi-Fi 连接中';
              break;
            case 'connected':
              commonEventItem.state = 'Wi-Fi 已连接';
              break;
            case 'disconnected':
              commonEventItem.state = 'Wi-Fi 已断开';
              break;
            default:
              commonEventItem.state = '未知状态';
          }
        }
        callback(commonEventItem);
      });

      toastMsg = '订阅成功';
      callback(commonEventItem, toastMsg);
    });
  }

  unsubscribe(commonEventItem: CommonEventBean, callback: Function): void {
    if (commonEventItem.subscriber) {
      CommonEventManager.unsubscribe(commonEventItem.subscriber, () => {
        callback('已成功退订');
      });
    }
  }
}

获取当前 Wi-Fi 信息

该模块通过 wifiManager 获取设备当前连接的 Wi-Fi 信息。

主要功能包括：

1. 检测 Wi-Fi 是否已激活。
2. 获取 Wi-Fi 的 SSID 和 MAC 地址并进行格式化处理。

代码如下：

export class WifiInfoHandler {
  wifiViewUpdates(): void {
    try {
      const isWifiActive: boolean = wifiManager.isWifiActive();
      if (isWifiActive) {
        this.showLinkedInfo();
      } else {
        console.info('Wi-Fi 未激活');
      }
    } catch (error) {
      console.error(`Wi-Fi 状态检查失败，错误码: ${(error as BusinessError).code}`);
    }
  }

  showLinkedInfo(): void {
    wifiManager.getLinkedInfo()
      .then((linkedInfo) => {
        const ssid = linkedInfo.ssid.replace(/^"|"$/g, '');
        const bssid = linkedInfo.macAddress;
        console.info(`当前连接的 Wi-Fi SSID: ${ssid}`);
        console.info(`Wi-Fi MAC 地址: ${bssid}`);
      })
      .catch((err) => {
        console.error(`获取 Wi-Fi 信息失败: ${err}`);
      });
  }
}

整合主模块

将 Wi-Fi 状态监听和信息获取功能整合到主程序中：

const commonEventBean = new CommonEventBean();
const wifiListener = new WifiStatusListener();
const wifiHandler = new WifiInfoHandler();

wifiListener.subscribe(commonEventBean, (event, msg) => {
  console.info(`状态: ${event.state}`);
  if (msg) {
    console.info(`消息: ${msg}`);
  }
  if (event.state === 'Wi-Fi 已连接') {
    wifiHandler.wifiViewUpdates();
  }
});

运行效果展示

示例输出 1（Wi-Fi 连接中）：

状态: Wi-Fi 连接中

示例输出 2（Wi-Fi 已连接）：

状态: Wi-Fi 已连接  
当前连接的 Wi-Fi SSID: MyHomeWiFi  
Wi-Fi MAC 地址: 00:1A:2B:3C:4D:5E  

示例输出 3（Wi-Fi 已断开）：

状态: Wi-Fi 已断开  

性能分析

• 时间复杂度：

  • Wi-Fi 状态监听：实时事件触发，复杂度为 (O(1))。
  • Wi-Fi 信息获取：getLinkedInfo 为同步操作，复杂度为 (O(1))。

• 空间复杂度：

  • 使用少量对象和事件订阅，复杂度为 (O(1))。

总结

通过本文的代码实现，开发者可以：

1. 动态监听 Wi-Fi 的连接状态并实时更新。
2. 获取当前连接的 Wi-Fi 信息，为应用提供更智能的网络交互功能。

此 Demo 结构清晰，模块化设计方便扩展，适用于需要实时监控网络状态的场景。