1. Wifi 热点简介
Wifi 热点是移动设备接入网络的重要形式，特别是在不具备固定网络接入点的情况下，可以通过 Wifi 热点灵活方便的接入网络，因此在日常生活中具有广泛的应用。鸿蒙系统也提供了方便的 Wifi 管理 API，支持热点扫描，热点连接等功能，相关的能力归属于系统相关 Kit 开放能力中的 Connectivity Kit（短距通信服务），使用如下的代码导入模块：
import { wifiManager } from '@kit.ConnectivityKit';
复制代码
本文将通过一个示例演示扫描 Wifi 热点以及连接指定热点的功能，相关的主要 Wifi 能力接口如下所示：
//返回扫描到的热点列表function getScanInfoList(): Array<WifiScanInfo>;
//查询WLAN信号强度。function getSignalLevel(rssi: number, band: number): number;
//添加候选网络配置function addCandidateConfig(config: WifiDeviceConfig): Promise<number>;
//连接到自己添加的候选网络（如果当前已经连接到热点，需要先断开连接）。function connectToCandidateConfig(networkId: number): void;
复制代码
2. Wifi 热点扫描及连接演示
本示例运行后的界面如图所示：
单击“扫描热点”按钮，会扫描附近的热点，界面如下所示：
这里列出了热点的名称、是否加密、网络制式以及信号强度。要连接某一个特定热点，单击热点后面的"连接"按钮即可，不过要注意的是，如果当前手机已经连接了一个热点，需要先断开连接才能连接新的热点，假设已经断开了 Wifi 连接，在某一个标识加密的热点后面单击"连接"按钮，会出现密码输入框，输入密码后，再单击"连接"按钮，会出现“连接至指定的候选 WLAN”的弹出窗口，如图所示：
单击弹出窗口的"连接"按钮，即可连接到指定的热点，如图所示：
3. Wifi 热点扫描及连接示例编写
下面详细介绍创建该示例的步骤。
步骤 1：创建 Empty Ability 项目。
步骤 2：在 module.json5 配置文件加上对权限的声明：
"requestPermissions": [ { "name": "ohos.permission.GET_WIFI_INFO" }, { "name": "ohos.permission.SET_WIFI_INFO" } ]
复制代码
这里添加了读取和设置 Wifi 配置的权限。
步骤 3：添加 WifiHotspotItem.ets 文件，该文件定义了显示 Wifi 热点信息的子组件，代码如下：
import { wifiManager } from '@kit.ConnectivityKit';
@ComponentV2export struct WifiHotspotItem { @Param @Require WifiInfo: wifiManager.WifiScanInfo @Param @Require connectCallback: (item: wifiManager.WifiScanInfo, password: string) => void @Local showPassword: boolean = false @Local password: string = ""
build() { Column() { Flex({ justifyContent: FlexAlign.End, alignItems: ItemAlign.Center }) { Text(this.WifiInfo.ssid) .width(120) .flexGrow(1)
Text(this.WifiInfo.securityType == wifiManager.WifiSecurityType.WIFI_SEC_TYPE_OPEN ? "开放" : "加密") .width(40)
Text(this.WifiInfo.band == 1 ? "2.5G" : "5G") .width(40)
Rating({ rating: wifiManager.getSignalLevel(this.WifiInfo.rssi, this.WifiInfo.band), indicator: true }) .stars(5) .width(80)
Button("连接") .onClick(() => { if (this.WifiInfo.securityType != wifiManager.WifiSecurityType.WIFI_SEC_TYPE_OPEN) { this.showPassword = true } else { this.showPassword = false } if (this.showPassword && this.password == "") { return } this.connectCallback(this.WifiInfo, this.password) }) .width(60) .fontSize(12) } .width('100%')
Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) { Text("请输入wifi密码") .width(150)
TextInput({ text: this.password }) .onChange((value) => { this.password = value }) .width(100) .type(InputType.Password) .flexGrow(1) .fontSize(11) } .width('100%') .visibility(this.showPassword ? Visibility.Visible : Visibility.None) } .width('100%') .padding(5) }}
复制代码
步骤 4：在 Index.ets 文件里添加如下的代码：
import { wifiManager } from '@kit.ConnectivityKit';import { WifiHotspotItem } from './WifiHotspotItem';
@Entry@ComponentV2struct Index { //Wifi热点列表 @Local wifiHotspotParamList: wifiManager.WifiScanInfo[] = []
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.wifiHotspotParamList = wifiManager.getScanInfoList().sort((a, b) => { return wifiManager.getSignalLevel(b.rssi, b.band) - wifiManager.getSignalLevel(a.rssi, a.band) }) }) .width(120) .fontSize(14) } .width('100%') .padding(5)
List({ space: 10, initialIndex: 0 }) { ForEach(this.wifiHotspotParamList, (item: wifiManager.WifiScanInfo) => { if (item.ssid != "") { ListItem() { WifiHotspotItem({ WifiInfo: item, connectCallback: this.connectWifiHotspot }) } } }) }.width('100%') .padding(5) } .width('100%') .justifyContent(FlexAlign.Start) .height('100%') } .height('100%') }
//执行连接的方法 async connectWifiHotspot(wifiInfo: wifiManager.WifiScanInfo, password: string): Promise<void> { if (wifiManager.isConnected()) { AlertDialog.show({ title: "提示", message: "请先断开Wifi连接", confirm: { value: '确定', action: () => { } } }) return }
let config: wifiManager.WifiDeviceConfig = { ssid: wifiInfo.ssid, preSharedKey: password, securityType: wifiInfo.securityType }
let netId = await wifiManager.addCandidateConfig(config) wifiManager.connectToCandidateConfig(netId) }}
复制代码
步骤 5：编译运行，可以使用模拟器或者真机。
步骤 6：按照本节第 2 部分“Wifi 热点扫描及连接演示”操作即可。
4. 代码分析
本示例主要有两点需要注意，第一点是关于热点的信号强度级别，虽然扫描时得到了热点的信号强度属性 rssi，但是这个属性不适合按照强度级别来表示，本示例是通过 getSignalLevel 函数来查询得到信号强度对应的信号强度级别的；另外一点是连接到热点，系统并不是直接连接热点的，而是先把热点添加为候选网络，得到网络配置 ID，然后再通过该 ID 连接到指定的热点网络，代码如下所示：
let config: wifiManager.WifiDeviceConfig = { ssid: wifiInfo.ssid, preSharedKey: password, securityType: wifiInfo.securityType }
let netId = await wifiManager.addCandidateConfig(config) wifiManager.connectToCandidateConfig(netId)
复制代码
（本文作者原创，除非明确授权禁止转载）
本文源码地址：
https://gitee.com/zl3624/harmonyos_network_samples/tree/master/code/wifi/WifiHotspotManager
本系列源码地址：
https://gitee.com/zl3624/harmonyos_network_samples
评论