Harmony OS WiFi编程——连接热点、创建热点

相关知识点

• WiFi的工作模式
  • AP模式：热点模式，提供无线接入服务，允许其它无线设备接入，提供数据访问，一般的无线路由/网桥工作在该模式。
  • STA模式：类似于无线终端，本身并不接受其他设备的接入，它可以连接到AP，一般无线网卡即工作在该模式。
• Harmony OS的WiFi相关API头文件位于foundation\communication\interfaces\kits\wifi_lite\wifiservice目录，该目录下有9个文件；
  • wifi_device.h中定义的是STA模式的主要接口，例如扫描其他热点、添加热点配置（热点名称、密码等）、连接其他热点；
  • wifi_hotspot.h中定义的是AP模式的主要接口，例如设置热点信息（热点名称、密码等）、查询连接的设备列表；
  • wifi_hotspot_config.h中定义了设置和获取当前工作在2.4G或者5G频段的接口SetBand和GetBand；
  • 另外6个文件中定义了上述接口相关的类型，例如扫描结果、热点配置、热点连接状态等；

STA模式编程指南

STA模式API

扫描WiFi热点

在Harmony OS上STA模式扫描其他WiFi热点，需要注意以下事项

1. 功能相关接口都有WifiErrorCode类型的返回值：

   • 需要接收并判断返回值是否为WIFI_SUCCESS，用于确认是否调用成功；
   • 不为WIFI_SUCCESS表示失败，通过枚举值查找错误原因；

2. EnableWifi接口使能STA模式之前：

   • 需要使用RegisterWifiEvent接口，向系统注册状态监听函数，用于接收状态通知，STA模式需要绑定如下两个回调函数；
     • OnWifiScanStateChanged用于绑定扫描状态监听函数，该回调函数有两个参数state和size；
       • state表示扫描状态，取值为0和1，1表示扫描动作完成；编程时可以与WifiEventState枚举值的WIFI_STATE_NOT_AVALIABLE，WIFI_STATE_AVALIABLE进行比较，避免魔法数字；
   • size表示扫描到的热点个数；
   • OnWifiConnectionChanged用于绑定WiFi连接状态监听函数，该回调函数有两个参数state和info；
     • state表示WiF