
HarmonyOS之深入解析WLAN的功能和使用
一、WLAN 简介
二、WLAN 基础功能
① 应用场景
② API 说明
WLAN 基础功能由 WifiDevice 提供,其接口说明如下:
接口名 | 描述 | 所需权限 |
---|---|---|
getInstance(Context context) | 获取WLAN功能管理对象实例,通过该实例调用WLAN基本功能API | NA |
isWifiActive() | 获取当前WLAN打开状态 | ohos.permission.GET_WIFI_INFO |
scan() | 发起WLAN扫描 | ohos.permission.SET_WIFI_INFO ohos.permission.LOCATION |
getScanInfoList() | 获取上次扫描结果 | ohos.permission.GET_WIFI_INFO ohos.permission.LOCATION |
isConnected() | 获取当前WLAN连接状态 | ohos.permission.GET_WIFI_INFO |
getLinkedInfo() | 获取当前的WLAN连接信息 | ohos.permission.GET_WIFI_INFO |
getIpInfo() | 获取当前连接的WLAN IP信息 | ohos.permission.GET_WIFI_INFO |
getSignalLevel(int rssi, int band) | 通过RSSI与频段计算信号格数 | NA |
getCountryCode() | 获取设备的国家码 | ohos.permission.LOCATION ohos.permission.GET_WIFI_INFO |
isFeatureSupported(long featureId) | 获取设备是否支持指定的特性 | ohos.permission.GET_WIFI_INFO |
③ 获取 WLAN 状态c
调用 WifiDevice 的 getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 isWifiActive() 接口查询 WLAN 是否打开。
④ 发起扫描并获取结果
调用 WifiDevice的getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 scan() 接口发起扫描。
调用 getScanInfoList() 接口获取扫描结果。
⑤ 获取连接态详细信息
调用 WifiDevice 的 getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 isConnected() 接口获取当前连接状态。
调用 getLinkedInfo() 接口获取连接信息。
调用 getIpInfo() 接口获取IP信息。
⑥ 获取设备国家码
调用 WifiDevice 的 getInstance(Context context)接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 getCountryCode() 接口获取设备的国家码。
⑦ 判断设备是否支持指定的能力
调用 WifiDevice 的 getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 isFeatureSupported(long featureId) 接口判断设备是否支持指定的能力。
三、不信任热点配置
① 应用场景
应用可以添加指定的热点,其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点,自动连接该热点。
应用或者其他模块可以通过接口完成以下功能:
设置第三方的热点配置。
删除第三方的热点配置。
② API 说明
WifiDevice 提供 WLAN 的不信任热点配置功能,其接口说明如下:
接口名 | 描述 | 所需权限 |
---|---|---|
getInstance(Context context) | 获取WLAN功能管理对象实例,通过该实例调用不信任热点配置的API | NA |
addUntrustedConfig(WifiDeviceConfig config) | 添加不信任热点配置,选网优先级低于已保存热点 | ohos.permission.SET_WIFI_INFO |
removeUntrustedConfig(WifiDeviceConfig config) | 删除不信任热点配置 | ohos.permission.SET_WIFI_INFO |
③ 添加不信任热点配置
调用 WifiDevice 的 getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 addUntrustedConfig(WifiDeviceConfig config) 接口,设置三方添加的不信任配置。
④ 删除不信任热点配置
调用 WifiDevice 的 getInstance(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
调用 removeUntrustedConfig(WifiDeviceConfig config) 接口,删除三方添加的不信任配置。
四、P2P 功能
① 应用场景
WLAN P2P 功能用于设备与设备之间的点对点数据传输。
应用可以通过接口完成以下功能:
发现对端设备。
建立与移除群组。
向对端设备发起连接。
获取 P2P 相关信息。
② API 说明
WifiP2pController 提供 WLAN P2P 功能,接口说明如下:
接口名 | 描述 | 所需权限 |
---|---|---|
init(EventRunner eventRunner, WifiP2pCallback callback) | 初始化P2P的信使,当且仅当信使被成功初始化,P2P的其他功能才可以正常使用 | ohos.permission.GET_WIFI_INFO ohos.permission.SET_WIFI_INFO |
discoverDevices(WifiP2pCallback callback) | 搜索附近可用的P2P设备 | ohos.permission.GET_WIFI_INFO |
stopDeviceDiscovery(WifiP2pCallback callback) | 停止搜索附近的P2P设备 | ohos.permission.GET_WIFI_INFO |
createGroup(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback) | 建立P2P群组 | ohos.permission.GET_WIFI_INFO |
removeGroup(WifiP2pCallback callback) | 移除P2P群组 | ohos.permission.GET_WIFI_INFO |
requestP2pInfo(int requestType, WifiP2pCallback callback) | 请求P2P相关信息,如群组信息、连接信息、设备信息等 | ohos.permission.GET_WIFI_INFO |
connect(WifiP2pConfig wifiP2pConfig, WifiP2pCallback callback) | 向指定设备发起连接 | ohos.permission.GET_WIFI_INFO |
cancelConnect(WifiP2pCallback callback) | 取消向指定设备发起的连接 | ohos.permission.GET_WIFI_INFO |
③ 启动与停止 P2P 搜索
调用 WifiP2pController 的 getInstance(Context context) 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
发起 P2P 搜索。
获取 P2P 搜索回调信息。
停止 P2P 搜索。
④ 创建与移除群组
调用 WifiP2pController的getInstance(Context context) 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
创建 P2P 群组。
移除 P2P 群组。
⑤ 发起 P2P 连接
调用 WifiP2pController的getInstance(Context context) 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
调用 requestP2pInfo() 查询 P2P 可用设备信息。
根据场景不同,从可用设备信息中选择目标设备。
调用 connect 接口发起连接。
⑥ 请求 P2P 相关信息
调用 WifiP2pController 的 getInstance() 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
调用 init() 初始化 P2P 控制器实例。
调用 requestP2pInfo() 查询 P2P 群组信息。
调用 requestP2pInfo() 查询 P2P 设备信息。
根据场景不同,可以调用 requestP2pInfo 获取需要的信息。
五、WLAN 消息通知
① 应用场景
WLAN 消息通知(Notification)是 HarmonyOS 内部或者与应用之间跨进程通讯的机制,注册者在注册消息通知后,一旦符合条件的消息被发出,注册者即可接收到该消息并获取消息中附带的信息。
② API 说明
WLAN 消息通知的相关广播介绍:
描述 | 通知名 | 附加参数 |
---|---|---|
WLAN状态 | usual.event.wifi.POWER_STATE | active_state |
WLAN扫描 | usual.event.wifi.SCAN_FINISHED | scan_state |
WLAN RSSI变化 | usual.event.wifi.RSSI_VALUE | rssi_value |
WLAN连接状态 | usual.event.wifi.CONN_STATE | conn_state |
Hotspot状态 | usual.event.wifi.HOTSPOT_STATE | hotspot_active_state |
Hotspot连接状态 | usual.event.wifi.WIFI_HS_STA_JOIN usual.event.wifi.WIFI_HS_STA_LEAVE |
- |
P2P状态 | usual.event.wifi.p2p.STATE_CHANGE | p2p_state |
P2P连接状态 | usual.event.wifi.p2p.CONN_STATE_CHANGE | linked_info net_info group_info |
P2P设备列表变化 | usual.event.wifi.p2p.DEVICES_CHANGE | - |
P2P搜索状态变化 | usual.event.wifi.p2p.PEER_DISCOVERY_STATE_CHANGE | peers_discovery |
P2P当前设备变化 | usual.event.wifi.p2p.CURRENT_DEVICE_CHANGE | p2p_device |
③ 开发步骤
构建消息通知接收者 WifiEventSubscriber。
注册 WLAN 变化消息。
WifiEventSubscriber 接收并处理 WLAN 广播消息。
