HarmonyOS开发实战系列：移动设备获取Wifi信息规范

标签：实战 ipNum 鸿蒙获取 Wifi HarmonyOS wifiManager msgHistory

1. Wifi信息简介

对于移动设备来说，一般都提供了无线网卡，可以在需要时连接无线网络，这时候就可以获取相关的无线网络信息，比如热点名称、连接频段、链接速度、IP地址、MAC地址等，鸿蒙系统提供了丰富的无线网络管理API，可以轻松获取相关WIFI信息。

2. Wifi信息获取常用方法

鸿蒙封装的wifiManager模块使用如下的方式导入：

import wifiManager from '@ohos.wifiManager';

wifiManager模块包括了众多的操作方法，就本文而言，重点需要掌握的是如下三个：

1）isWifiActive(): boolean

查询WLAN是否已使能，如果使用者关闭了Wifi功能，就返回false

2）getLinkedInfo(): Promise<WifiLinkedInfo>

获取WLAN连接信息，使用Promise异步回调。

3）getIpInfo(): IpInfo

获取IP信息，这是一个同步方法。

3. 获取Wifi信息示例

本示例会获取当前设备的Wifi信息，运行后的初始界面如下所示：

下面详细介绍创建该应用的步骤。

步骤1：创建Empty Ability项目。

步骤2：在module.json5配置文件加上对权限的声明：

"requestPermissions": [
      {
        "name": "ohos.permission.GET_WIFI_INFO"
      }
    ]

这里添加了获取WIFI信息的权限。

步骤3：在Index.ets文件里添加如下的代码：

import wifiManager from '@ohos.wifiManager';

@Entry
@Component
struct Index {
  //连接、通讯历史记录
  @State msgHistory: string = ''
  scroller: Scroller = new Scroller()

  build() {
    Row() {
      Column() {
        Text("Wifi信息获取示例")
          .fontSize(14)
          .fontWeight(FontWeight.Bold)
          .width('100%')
          .textAlign(TextAlign.Center)
          .padding(10)

        Flex({ justifyContent: FlexAlign.End, alignItems: ItemAlign.Center }) {
          Button("获取")
            .onClick(() => {
              this.showWifiInfo()
            })
            .width(70)
            .fontSize(14)
            .flexGrow(0)
        }
        .width('100%')
        .padding(10)

        Scroll(this.scroller) {
          Text(this.msgHistory)
            .textAlign(TextAlign.Start)
            .padding(10)
            .width('100%')
            .backgroundColor(0xeeeeee)
        }
        .align(Alignment.Top)
        .backgroundColor(0xeeeeee)
        .height(300)
        .flexGrow(1)
        .scrollable(ScrollDirection.Vertical)
        .scrollBar(BarState.On)
        .scrollBarWidth(20)
      }
      .width('100%')
      .justifyContent(FlexAlign.Start)
      .height('100%')
    }
    .height('100%')
  }

  showWifiInfo() {
    if (wifiManager.isWifiActive()) {
      this.msgHistory += `Wifi可用\r\n`;
      this.showIPInfo()
      this.showLinkedInfo()
    }
    else {
      this.msgHistory += `Wifi不可用\r\n`;
    }
  }

  //显示IP相关信息
  showIPInfo() {
    let ipInfo = wifiManager.getIpInfo();

    let ipAddr = getIpAddrFromNum(ipInfo.ipAddress)
    this.msgHistory += `IP地址: ${ipAddr}\r\n`;

    let gateAddr = getIpAddrFromNum(ipInfo.gateway)
    this.msgHistory += `网关地址: ${gateAddr}\r\n`;

    let maskAddr = getIpAddrFromNum(ipInfo.netmask)
    this.msgHistory += `子网掩码: ${maskAddr}\r\n`;

    let dnsAddr = getIpAddrFromNum(ipInfo.primaryDns)
    this.msgHistory += `DNS服务器: ${dnsAddr}\r\n`;

    let dhcpServer = getIpAddrFromNum(ipInfo.serverIp)
    this.msgHistory += `DHCP服务器: ${dhcpServer}\r\n`;

    this.msgHistory += `租用时长: ${ipInfo.leaseDuration}\r\n`;
  }

  //显示和设备相关信息
  showLinkedInfo() {
    wifiManager.getLinkedInfo()
      .then((linkedInfo) => {
        let len =linkedInfo.ssid.length
        let ssid = linkedInfo.ssid.substring(1,len-1)
        this.msgHistory += `SSID: ${ssid}\r\n`;
        this.msgHistory += `信号强度: ${linkedInfo.rssi}\r\n`;
        this.msgHistory += `网络频段: ${linkedInfo.band}\r\n`;
        this.msgHistory += `链接速度: ${linkedInfo.linkSpeed}\r\n`;
        this.msgHistory += `网络频率: ${linkedInfo.frequency}\r\n`;
        this.msgHistory += `MAC地址: ${linkedInfo.macAddress}\r\n`;
      }
      )
  }
}

//根据数字形式的IP地址获取字符串形式的IP地址
function getIpAddrFromNum(ipNum: number): string {
  return (ipNum >>> 24) + '.' + (ipNum >> 16 & 0xFF) + '.' + (ipNum >> 8 & 0xFF) + '.' + (ipNum & 0xFF);
}

步骤4：编译运行，可以使用模拟器或者真机。

步骤5：单击“获取”按钮，截图如下所示：

这样就完成了一个简单的Wifi信息获取应用。

3. 重点功能分析

虽然本例较简单，但是有一点要注意，就是从数字形式的IP地址转换为字符串形式的IP地址，这是通过函数getIpAddrFromNum实现的：

//根据数字形式的IP地址获取字符串形式的IP地址
function getIpAddrFromNum(ipNum: number): string {
  return (ipNum >>> 24) + '.' + (ipNum >> 16 & 0xFF) + '.' + (ipNum >> 8 & 0xFF) + '.' + (ipNum & 0xFF);
}