鸿蒙网络编程系列34-Wifi热点扫描及连接示例

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';@ComponentV2
export 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
@ComponentV2
struct 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