在 HarmonyOS（鸿蒙） 中，获取网络信息是开发者常常需要的操作，特别是在需要根据设备的网络状态进行不同的处理时。例如，应用可能需要判断设备是否连接到网络、网络类型（Wi-Fi、4G等）、信号强度等信息。这些信息可以帮助应用优化用户体验，或者在网络不稳定时提供相应的提示或处理。

HarmonyOS 提供了多种方法来获取设备的网络状态和网络信息，主要通过 网络信息管理 API 来实现。

✅ 一、网络信息概述

在 HarmonyOS 中，网络信息管理 API 主要提供以下功能：

  1. 获取网络连接状态：判断设备是否连接到网络。
  2. 获取网络类型：获取当前设备使用的是 Wi-Fi 还是移动数据（如 4G、5G）。
  3. 获取网络信号强度：获取 Wi-Fi 或移动数据的信号强度。
  4. 获取网络运营商信息：获取当前运营商（适用于移动数据连接）。
  5. 监听网络变化：检测网络连接状态的变化（例如，设备从 Wi-Fi 切换到移动数据）。

✅ 二、如何获取网络信息

在 HarmonyOS 中，通过 @ohos.net 模块提供的 API 可以方便地获取相关的网络信息。

2.1 获取网络连接状态

使用 NetworkManager 类来判断设备的网络连接状态。你可以判断设备是否已经连接到网络。

import network from '@ohos.net';

async function checkNetworkStatus() {
    try {
        // 获取网络连接状态
        const isConnected = await network.isConnected();
        
        if (isConnected) {
            console.log('设备已连接到网络');
        } else {
            console.log('设备未连接到网络');
        }
    } catch (error) {
        console.error('获取网络连接状态失败:', error);
    }
}
  • network.isConnected()：返回一个布尔值，表示设备是否已连接到网络。

2.2 获取当前网络类型

你可以获取当前设备使用的是哪种类型的网络（Wi-Fi、移动数据等）。

async function getNetworkType() {
    try {
        const type = await network.getNetworkType();
        
        switch (type) {
            case network.NetworkType.WIFI:
                console.log('当前网络类型是 Wi-Fi');
                break;
            case network.NetworkType.MOBILE:
                console.log('当前网络类型是移动数据');
                break;
            case network.NetworkType.NONE:
                console.log('当前没有网络连接');
                break;
            default:
                console.log('未知的网络类型');
        }
    } catch (error) {
        console.error('获取网络类型失败:', error);
    }
}
  • network.getNetworkType()：获取当前设备的网络类型。
    • network.NetworkType.WIFI：Wi-Fi 网络。
    • network.NetworkType.MOBILE：移动数据（如 4G、5G）。
    • network.NetworkType.NONE：没有网络连接。

2.3 获取 Wi-Fi 信息

如果设备连接的是 Wi-Fi 网络，你可以进一步获取 Wi-Fi 的详细信息，如信号强度、SSID（网络名称）等。

async function getWiFiInfo() {
    try {
        const wifiInfo = await network.getWiFiInfo();

        if (wifiInfo) {
            console.log('Wi-Fi SSID:', wifiInfo.ssid);  // 获取 Wi-Fi 名称
            console.log('Wi-Fi 信号强度:', wifiInfo.signalStrength);  // 获取信号强度
        } else {
            console.log('当前没有连接 Wi-Fi');
        }
    } catch (error) {
        console.error('获取 Wi-Fi 信息失败:', error);
    }
}
  • network.getWiFiInfo()：获取当前 Wi-Fi 的详细信息，包括 SSID 和信号强度等。

2.4 获取移动数据运营商信息

如果设备使用的是移动数据网络，你还可以获取当前网络的运营商信息。

async function getMobileNetworkInfo() {
    try {
        const mobileInfo = await network.getMobileNetworkInfo();
        
        if (mobileInfo) {
            console.log('运营商名称:', mobileInfo.carrierName);
            console.log('网络类型:', mobileInfo.networkType);  // 如 4G, 5G 等
        } else {
            console.log('当前未连接移动数据');
        }
    } catch (error) {
        console.error('获取移动网络信息失败:', error);
    }
}
  • network.getMobileNetworkInfo()：获取当前移动数据网络的运营商信息，包括运营商名称和网络类型。

2.5 监听网络变化

如果需要在网络状态发生变化时进行处理（例如，网络连接或断开时），可以使用事件监听器来监听网络变化。

import network from '@ohos.net';

function networkChangeListener(event) {
    if (event.type === network.NetworkEvent.CONNECTED) {
        console.log('设备已连接到网络');
    } else if (event.type === network.NetworkEvent.DISCONNECTED) {
        console.log('设备已断开网络');
    }
}

// 监听网络状态变化
network.on('networkChange', networkChangeListener);
  • network.on('networkChange', listener)：监听网络状态的变化事件。当网络连接或断开时，会触发相应的事件。

✅ 三、网络信息相关常量

在获取网络信息时，可能需要处理一些常量，下面是几个常用的网络信息相关常量：

常量描述
network.NetworkType.WIFIWi-Fi 网络类型
network.NetworkType.MOBILE移动数据网络类型（如 4G、5G）
network.NetworkType.NONE没有网络连接
network.NetworkEvent.CONNECTED网络连接事件
network.NetworkEvent.DISCONNECTED网络断开事件

✅ 四、总结

在 HarmonyOS 中，使用网络信息 API 你可以轻松地获取设备的网络状态、网络类型、Wi-Fi 信息、运营商信息等，帮助应用进行智能的网络管理和优化用户体验。下面是主要功能的总结：

功能描述
获取网络连接状态判断设备是否已连接到网络
获取网络类型判断设备当前使用的是 Wi-Fi 还是移动数据
获取 Wi-Fi 信息获取连接的 Wi-Fi 网络的详细信息，如 SSID 和信号强度
获取移动数据运营商信息获取当前移动数据连接的运营商名称和网络类型
监听网络变化监听网络连接状态的变化（如连接、断开网络等）

这些 API 在应用中非常有用，尤其是在需要根据网络状态调整功能或提供网络相关提示时，能够有效提升用户体验。如果你需要进一步的帮助或有任何问题，欢迎随时提问！