您好,欢迎来到花生壳b2b外贸网信息发布平台!
18951535724

HarmonyOS实战:Wi-Fi热点自动扫描与连接全流程代码解析

   2026-11-14 网络整理佚名1160
核心提示:文章浏览阅读1.7k次,点赞23次,收藏9次。本文聚焦鸿蒙NEXT开发,介绍了Wifi热点扫描及连接功能。先阐述了Wifi热点在鸿蒙系统中的重要性及相关API

鸿蒙NEXT开发实战往期必看文章:

一分钟了解”纯血版!鸿蒙HarmonyOS Next应用开发!

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线!(从零基础入门到精通)

HarmonyOS NEXT应用开发案例实践总结合(持续更新......)

HarmonyOS NEXT应用开发性能优化实践总结(持续更新......)

1. Wifi热点简介

Wifi热点是移动设备接入网络的重要形式,特别是在不具备固定网络接入点的情况下,可以通过Wifi热点灵活方便的接入网络,因此在日常生活中具有广泛的应用。鸿蒙系统也提供了方便的Wifi管理API,支持热点扫描,热点连接等功能,相关的能力归属于系统相关Kit开放能力中的Connectivity Kit(短距通信服务),使用如下的代码导入模块:

import { wifiManager } from '@kit.ConnectivityKit';

本文将通过一个示例演示扫描Wifi热点以及连接指定热点的功能,相关的主要Wifi能力接口如下所示:

//返回扫描到的热点列表
function getScanInfoList(): Array;
//查询WLAN信号强度。
function getSignalLevel(rssi: number, band: number): number;
//添加候选网络配置
function addCandidateConfig(config: WifiDeviceConfig): Promise;
//连接到自己添加的候选网络(如果当前已经连接到热点,需要先断开连接)。
function connectToCandidateConfig(networkId: number): void;

2. Wifi热点扫描及连接演示

本示例运行后的界面如图所示:

android 扫描wifi热点_鸿蒙NEXT开发 Wifi热点扫描 连接指定热点

单击“扫描热点”按钮,会扫描附近的热点,界面如下所示:

鸿蒙NEXT开发 Wifi热点扫描 连接指定热点_android 扫描wifi热点

这里列出了热点的名称、是否加密、网络制式以及信号强度。要连接某一个特定热点,单击热点后面的"连接"按钮即可,不过要注意的是,如果当前手机已经连接了一个热点,需要先断开连接才能连接新的热点,假设已经断开了Wifi连接,在某一个标识加密的热点后面单击"连接"按钮,会出现密码输入框,输入密码后,再单击"连接"按钮,会出现“连接至指定的候选WLAN”的弹出窗口,如图所示:

android 扫描wifi热点_鸿蒙NEXT开发 Wifi热点扫描 连接指定热点

单击弹出窗口的"连接"按钮,即可连接到指定的热点,如图所示:

android 扫描wifi热点_鸿蒙NEXT开发 Wifi热点扫描 连接指定热点

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 {
    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)

鸿蒙NEXT开发 Wifi热点扫描 连接指定热点_android 扫描wifi热点

 
举报收藏 0打赏 0评论 0
更多>相关评论
暂时没有评论,来说点什么吧
更多>同类百科知识
推荐图文
推荐百科知识