HarmonyOS鸿蒙Next中实现设备网络监听示例代码

介绍

本示例实现以下三种功能：

1. 利用 NetConnection 监听当前网络连接状态。
2. 监听网络类型（wifi、蜂窝网络）。
3. 判断蜂窝网络类型（3G\4G\5G）和信号强度。

实现设备网络监听源码地址

效果预览

使用说明

1. 进入应用默认网络开关开，网络类型为“未知”。
2. 插入SIM卡，断开wifi，关闭数据流量，网络开关关闭，网络类型显示为“网络未开启”。
3. 连接wifi，关闭数据流量，网络开关打开，网络类型显示为“Wi-Fi网络”。
4. 断开wifi，打开数据流量，网络开关打开，网络类型显示为“蜂窝网络”，显示SIM卡槽，蜂窝网络类型（3G\4G\5G)以及信号等级强度。

实现思路

监听网络连接状态

利用 NetConnection 可获取当前设备的网络连接状态。使用 register 接口注册订阅事件，设备从无网络到有网络会触发 netAvailable 事件、netCapabilitiesChange 事件和 netConnectionPropertiesChange 事件；设备从有网络到无网络状态会触发 netLost 事件；设备从 WiFi 到蜂窝会触发 netLost 事件（WiFi 丢失）之后触发 netAvailable 事件（蜂窝可用）。核心代码如下，源码参考

Index.ets

onNetCapabilitiesChange() {
    // 先使用 register 接口注册订阅事件
    this.netCon.register((error: BusinessError) => {
      if (error) {
        console.log(this.tag, `register failed ${JSON.stringify(error)}`);
      } else {
        console.log(this.tag, `register success`);
      }
    });
    // 订阅网络可用事件。调用 register 后，才能接收到此事件通知
    this.netCon.on('netAvailable', (data: connection.NetHandle) => {
      console.log(this.tag, 'netAvailable' + JSON.stringify(data));
      this.netAvailable = true;
      connection.getNetCapabilities(data, (error: BusinessError, data: connection.NetCapabilities) => {
        if (error) {
          console.log(this.tag, 'getNetCapabilities ' + JSON.stringify(error));
        }
        console.log(this.tag, 'getNetCapabilities ' + JSON.stringify(data));
        // 解析网络类型
        if (data && data.bearerTypes) {
          this.netBearType = data.bearerTypes[0];
          if (data.bearerTypes[0] == 0) {
            this.getSignalInformation()
          }
        }
      })
    });
    // 订阅网络能力变化事件
    this.netCon.on('netCapabilitiesChange', (data: connection.NetCapabilityInfo) => {
      console.log(this.tag, 'netCapabilitiesChange' + JSON.stringify(data));
    });
    // 订阅网络可用事件
    this.netCon.on('netConnectionPropertiesChange', (data: connection.NetConnectionPropertyInfo) => {
      console.log(this.tag, 'netConnectionPropertiesChange' + JSON.stringify(data));
    });
    // 订阅网络丢失事件
    this.netCon.on('netLost', (data: connection.NetHandle) => {
      console.log(this.tag, 'netLost' + JSON.stringify(data));
      this.netAvailable = false;
    });
    // 订阅网络不可用事件。调用 register 后，才能接收到此事件通知
    this.netCon.on('netUnavailable', () => {
      console.log(this.tag, 'netUnavailable');
      this.netAvailable = false;
    });
  }
  netBearTypeNameMapping(netBearType: number) {
    if (!this.netAvailable) {
      this.netBearType = -1;
      return '网络未开启'
    }
    return this.netBearHashMap.get(netBearType) ? this.netBearHashMap.get(netBearType) : '未知'
  }
}

监听网络类型（wifi、蜂窝网络）

NetBearType 接口可获取当前网络类型并用不同的值表示，蜂窝网络值为 0，Wi-Fi 网络值为 1。将网络类型与对应的值存储在 HashMap 中，通过查询键值对的方式判断当前网络类型并显示。

判断蜂窝网络类型（3G\4G\5G）和信号强度

利用 [@ohos.telephony.radio](https://developer.huawei.com/consumer/cn/doc/harmonyos-references-V5/js-apis-radio-V5) 接口获取当前 SIM 卡所在卡槽以及网络信号强度等级，通过 NetworkType 获取蜂窝网络类型并用不同的值表示。将蜂窝网络类型与对应的值存储在 HashMap 中，通过查询键值对的方式判断当前蜂窝网络类型并显示。核心代码如下，源码参考

Index.ets

getSignalInformation() {
    // 获取蜂窝网络的 SIM 卡槽
    radio.getPrimarySlotId((err: BusinessError, data: number) => {
      if (err) {
        console.error(this.tag, `getPrimarySlotId failed, callback: err->${JSON.stringify(err)}`);
        return;
      }
      console.log(this.tag, `getPrimarySlotId success, callback: data->${JSON.stringify(data)}`);
      this.slotId = data;
      radio.getSignalInformation(data, (err: BusinessError, data: Array<radio.SignalInformation>) => {
        if (err) {
          console.error(this.tag, `getSignalInformation failed, callback: err->${JSON.stringify(err)}`);
          return;
        }
        console.log(this.tag, `getSignalInformation success, callback: data->${JSON.stringify(data)}`);
        if (data) {
          this.signalTypeName = this.signalTypeHashMap.get(data[0].signalType.toString())
          this.signalLevelName = data[0].signalLevel
        }
      });
    });
  }