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);
}
(本文作者原创,除非明确授权禁止转载)
https://gitee.com/zl3624/harmonyos_network_samples/tree/maste...
本系列源码地址:
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。