HarmonyOS

文章40 |   阅读 26857 |   点赞0

来源:https://blog.csdn.net/forever_wj/category_11128883.html

HarmonyOS之深入解析WLAN的功能和使用

x33g5p2x  于2022-03-07 转载在 其他  
字(13.4k)|赞(0)|评价(0)|浏览(649)
一、WLAN 简介
  • 无线局域网(Wireless Local Area Networks,WLAN),是通过无线电、红外光信号或者其他技术发送和接收数据的局域网,用户可以通过 WLAN 实现结点之间无物理连接的网络通讯。常用于用户携带可移动终端的办公、公众环境中。
  • HarmonyOS WLAN 服务系统为用户提供 WLAN 基础功能、P2P(peer-to-peer)功能和 WLAN 消息通知的相应服务,让应用可以通过 WLAN 和其他设备互联互通。
  • 本开发指南提供多个开发场景的指导,涉及多个 API 接口的调用。在调用 API 前,应用需要先申请对应的访问权限。
二、WLAN 基础功能
① 应用场景
  • 获取 WLAN 状态,查询 WLAN 是否打开。
  • 发起扫描并获取扫描结果。
  • 获取连接态详细信息,包括连接信息、IP 信息等。
  • 获取设备国家码。
  • 获取设备是否支持指定的能力。
② 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 状态
  • 调用 WifiDevice 的 getInstance​(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 isWifiActive​() 接口查询 WLAN 是否打开。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 调用获取WLAN开关状态接口
  4. boolean isWifiActive = wifiDevice.isWifiActive(); // 若WLAN打开,则返回true,否则返回false
④ 发起扫描并获取结果
  • 调用 WifiDevice的getInstance​(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 scan​() 接口发起扫描。
  • 调用 getScanInfoList​() 接口获取扫描结果。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 调用WLAN扫描接口
  4. boolean isScanSuccess = wifiDevice.scan();
  5. // 调用获取扫描结果
  6. List<WifiScanInfo> scanInfos = wifiDevice.getScanInfoList();
⑤ 获取连接态详细信息
  • 调用 WifiDevice 的 getInstance​(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 isConnected​() 接口获取当前连接状态。
  • 调用 getLinkedInfo() 接口获取连接信息。
  • 调用 getIpInfo() 接口获取IP信息。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 调用WLAN连接状态接口,确定当前设备是否连接WLAN
  4. boolean isConnected = wifiDevice.isConnected();
  5. if (isConnected) {
  6. // 获取WLAN连接信息
  7. Optional<WifiLinkedInfo> linkedInfo = wifiDevice.getLinkedInfo();
  8. // 获取连接信息中的SSID
  9. String ssid = linkedInfo.get().getSsid();
  10. // 获取WLAN的IP信息
  11. Optional<IpInfo> ipInfo = wifiDevice.getIpInfo();
  12. // 获取IP信息中的IP地址与网关
  13. int ipAddress = ipInfo.get().getIpAddress();
  14. int gateway = ipInfo.get().getGateway();
  15. }
⑥ 获取设备国家码
  • 调用 WifiDevice 的 getInstance​(Context context)接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 getCountryCode​() 接口获取设备的国家码。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 获取当前设备的国家码
  4. String countryCode = wifiDevice.getCountryCode();
⑦ 判断设备是否支持指定的能力
  • 调用 WifiDevice 的 getInstance​(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 isFeatureSupported​(long featureId) 接口判断设备是否支持指定的能力。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 获取当前设备是否支持指定的能力
  4. boolean isSupportInfra = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA);
  5. isSupportInfra5g = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA_5G);
  6. isSupportPasspoint = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_PASSPOINT);
  7. isSupportP2p = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_P2P);
  8. isSupportHotspot = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_MOBILE_HOTSPOT);
  9. isSupportAware = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AWARE);
  10. isSupportApSta = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AP_STA);
  11. isSupportWpa3Sae = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SAE);
  12. isSupportWpa3SuiteB = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SUITE_B);
  13. isSupportOwe = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_OWE);
三、不信任热点配置
① 应用场景
  • 应用可以添加指定的热点,其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点,自动连接该热点。
  • 应用或者其他模块可以通过接口完成以下功能:
    • 设置第三方的热点配置。
    • 删除第三方的热点配置。
② 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) 接口,设置三方添加的不信任配置。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 设置三方添加的不信任配置
  4. WifiDeviceConfig config = new WifiDeviceConfig();
  5. config.setSsid("untrusted-exist");
  6. config.setPreSharedKey("123456789");
  7. config.setHiddenSsid(false);
  8. config.setSecurityType(WifiSecurity.PSK);
  9. boolean isSuccess = wifiDevice.addUntrustedConfig(config);
④ 删除不信任热点配置
  • 调用 WifiDevice 的 getInstance​(Context context) 接口,获取 WifiDevice 实例,用于管理本机 WLAN 操作。
  • 调用 removeUntrustedConfig(WifiDeviceConfig config) 接口,删除三方添加的不信任配置。
  1. // 获取WLAN管理对象
  2. WifiDevice wifiDevice = WifiDevice.getInstance(context);
  3. // 设置删除三方添加的不信任配置
  4. WifiDeviceConfig config = new WifiDeviceConfig();
  5. config.setSsid("untrusted-exist");
  6. config.setPreSharedKey("123456789");
  7. config.setHiddenSsid(false);
  8. config.setSecurityType(WifiSecurity.PSK);
  9. boolean isSuccess = wifiDevice.removeUntrustedConfig(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 搜索。
  1. try {
  2. // 获取P2P管理对象
  3. WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
  4. // 初始化P2P管理对象,用于建立P2P信使等行为
  5. wifiP2pController.init(EventRunner.create(true), null);
  6. // 创建P2P回调对象
  7. P2pDiscoverCallBack p2pDiscoverCallBack = new P2pDiscoverCallBack();
  8. // 发起P2P搜索
  9. wifiP2pController.discoverDevices(p2pDiscoverCallBack);
  10. // 停止P2P搜索
  11. wifiP2pController.stopDeviceDiscovery(p2pDiscoverCallBack);
  12. } catch (RemoteException re) {
  13. HiLog.error(LABEL, "exception happened.");
  14. }
  15. // 获取P2P启动与停止搜索的回调信息(失败或者成功)
  16. private class P2pDiscoverCallBack extends WifiP2pCallback {
  17. @Override
  18. public void eventExecFail(int reason) {
  19. HiLog.warn(LABEL, "discoverDevices eventExecFail reason : %{public}d", reason);
  20. }
  21. @Override
  22. public void eventExecOk() {
  23. HiLog.info(LABEL, "discoverDevices eventExecOk");
  24. }
  25. }
④ 创建与移除群组
  • 调用 WifiP2pController的getInstance​(Context context) 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
  • 调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
  • 创建 P2P 群组。
  • 移除 P2P 群组。
  1. try {
  2. // 获取P2P管理对象
  3. WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
  4. // 初始化P2P管理对象,用于建立P2P信使等行为
  5. wifiP2pController.init(EventRunner.create(true), null);
  6. // 创建用于P2P建组需要的配置
  7. WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE");
  8. wifiP2pConfig.setDeviceAddress("02:02:02:02:03:04");
  9. wifiP2pConfig.setGroupOwnerBand(0);
  10. // 创建P2P回调对象
  11. P2pCreateGroupCallBack p2pCreateGroupCallBack = new P2pCreateGroupCallBack();
  12. // 创建P2P群组
  13. wifiP2pController.createGroup(wifiP2pConfig, p2pCreateGroupCallBack);
  14. // 移除P2P群组
  15. wifiP2pController.removeGroup(p2pCreateGroupCallBack);
  16. } catch (RemoteException re) {
  17. HiLog.error(LABEL, "exception happened.");
  18. }
  19. private class P2pCreateGroupCallBack extends WifiP2pCallback {
  20. @Override
  21. public void eventExecFail(int reason) {
  22. HiLog.warn(LABEL, "CreateGroup eventExecFail reason : %{public}d", reason);
  23. }
  24. @Override
  25. public void eventExecOk() {
  26. HiLog.info(LABEL, "CreateGroup eventExecOk");
  27. }
  28. }
⑤ 发起 P2P 连接
  • 调用 WifiP2pController的getInstance​(Context context) 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
  • 调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
  • 调用 requestP2pInfo() 查询 P2P 可用设备信息。
  • 根据场景不同,从可用设备信息中选择目标设备。
  • 调用 connect 接口发起连接。
  1. try {
  2. // 获取P2P管理对象
  3. WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
  4. // 初始化P2P管理对象,用于建立P2P信使等行为
  5. wifiP2pController.init(EventRunner.create(true), null);
  6. // 查询可用P2P设备信息,通过回调获取P2P设备信息
  7. P2pRequestPeersCallBack p2pRequestPeersCallBack = new P2pRequestPeersCallBack();
  8. wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, p2pRequestPeersCallBack);
  9. } catch (RemoteException re) {
  10. HiLog.error(LABEL, "exception happened.");
  11. }
  12. private class P2pRequestPeersCallBack extends WifiP2pCallback {
  13. @Override
  14. public void eventP2pDevicesList(List<WifiP2pDevice> devices) {
  15. HiLog.info(LABEL, "eventP2pDevicesList when start connect group");
  16. // 根据场景不同,选择不同的设备进行连接,通过MAC地址搜索到指定设备
  17. WifiP2pConfig wifiP2pConfig = getSameP2pConfigFromDevices(devices);
  18. try {
  19. if (wifiP2pConfig != null) {
  20. // 向指定的设备发起连接
  21. wifiP2pController.connect(wifiP2pConfig, null);
  22. }
  23. } catch (RemoteException re) {
  24. HiLog.error(LABEL, "exception happened in connect.");
  25. }
  26. }
  27. }
  28. private WifiP2pConfig getSameP2pConfigFromDevices(List<WifiP2pDevice> devices) {
  29. if (devices == null || devices.isEmpty()) {
  30. return null;
  31. }
  32. for (int i = 0; i < devices.size(); i++) {
  33. WifiP2pDevice p2pDevice = devices.get(i);
  34. HiLog.info(LABEL, "p2pDevice.getDeviceAddress() : %{private}s", p2pDevice.getDeviceAddress());
  35. if (p2pDevice.getDeviceAddress() != null
  36. && p2pDevice.getDeviceAddress().equals(TARGET_P2P_MAC_ADDRESS)) {
  37. HiLog.info(LABEL, "received same mac address");
  38. WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE"); // 根据实际情况配置名字和密码
  39. wifiP2pConfig.setDeviceAddress(p2pDevice.getDeviceAddress());
  40. return wifiP2pConfig;
  41. }
  42. }
  43. return null;
  44. }
⑥ 请求 P2P 相关信息
  • 调用 WifiP2pController 的 getInstance​() 接口,获取 P2P 控制器实例,用于管理 P2P 操作。
  • 调用 init() 初始化 P2P 控制器实例。
  • 调用 requestP2pInfo() 查询 P2P 群组信息。
  • 调用 requestP2pInfo() 查询 P2P 设备信息。
  • 根据场景不同,可以调用 requestP2pInfo 获取需要的信息。
  1. try {
  2. // 获取P2P管理对象
  3. WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
  4. // 初始化P2P管理对象,用于建立P2P信使等行为
  5. wifiP2pController.init(EventRunner.create(true), null);
  6. // 查询可用P2P群组信息,通过回调获取P2P群组信息
  7. P2pRequestGroupInfoCallBack p2pRequestGroupInfoCallBack = new P2pRequestGroupInfoCallBack();
  8. wifiP2pController.requestP2pInfo(WifiP2pController.GROUP_INFO_REQUEST, p2pRequestGroupInfoCallBack);
  9. // 查询可用P2P设备信息,通过回调获取P2P设备信息
  10. P2pRequestDeviceInfoCallBack p2pRequestDeviceInfoCallBack = new P2pRequestDeviceInfoCallBack();
  11. wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_INFO_REQUEST, p2pRequestDeviceInfoCallBack);
  12. // 通过调用requestP2pInfo接口,可以查询以下关键信息
  13. wifiP2pController.requestP2pInfo(WifiP2pController.NETWORK_INFO_REQUEST, callback); // 网络信息
  14. wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, callback); // 设备列表信息
  15. } catch (RemoteException re) {
  16. HiLog.error(LABEL, "exception happened.");
  17. }
  18. // 群组信息回调
  19. private class P2pRequestGroupInfoCallBack extends WifiP2pCallback {
  20. @Override
  21. public void eventP2pGroup(WifiP2pGroup group) {
  22. HiLog.info(LABEL, "P2pRequestGroupInfoCallBack eventP2pGroup");
  23. doSthFor(group);
  24. }
  25. }
  26. // 设备信息回调
  27. private class P2pRequestDeviceInfoCallBack extends WifiP2pCallback {
  28. @Override
  29. public void eventP2pDevice(WifiP2pDevice p2pDevice) {
  30. HiLog.info(LABEL, "P2pRequestDeviceInfoCallBack eventP2pDevice");
  31. doSthFor(p2pDevice);
  32. }
  33. }
五、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<br>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<br>net_info<br>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 广播消息。
  1. // 构建消息接收者/注册者
  2. class WifiEventSubscriber extends CommonEventSubscriber {
  3. WifiEventSubscriber(CommonEventSubscribeInfo info) {
  4. super(info);
  5. }
  6. @Override
  7. public void onReceiveEvent(CommonEventData commonEventData) {
  8. if (commonEventData == null || commonEventData.getIntent() == null) {
  9. return;
  10. }
  11. if (WifiEvents.EVENT_ACTIVE_STATE.equals(commonEventData.getIntent().getAction())) {
  12. // 获取附带参数
  13. IntentParams params = commonEventData.getIntent().getParams();
  14. if (params == null) {
  15. return;
  16. }
  17. int wifiState= (int) params.getParam(WifiEvents.PARAM_ACTIVE_STATE);
  18. if (wifiState== WifiEvents.STATE_ACTIVE) { // 处理WLAN被打开消息
  19. HiLog.info(LABEL, "Receive WifiEvents.STATE_ACTIVE %{public}d", wifiState);
  20. } else if (wifiState == WifiEvents.STATE_INACTIVE) { // 处理WLAN被关闭消息
  21. HiLog.info(LABEL, "Receive WifiEvents.STATE_INACTIVE %{public}d", wifiState);
  22. } else { // 处理WLAN异常状态
  23. HiLog.warn(LABEL,"Unknown wifi state");
  24. }
  25. }
  26. }
  27. }
  28. // 注册消息
  29. MatchingSkills match = new MatchingSkills();
  30. // 增加获取WLAN状态变化消息
  31. match.addEvent(WifiEvents.EVENT_ACTIVE_STATE);
  32. CommonEventSubscribeInfo subscribeInfo = new CommonEventSubscribeInfo(match);
  33. subscribeInfo.setPriority(100);
  34. WifiEventSubscriber subscriber = new WifiEventSubscriber(subscribeInfo);
  35. try {
  36. CommonEventManager.subscribeCommonEvent(subscriber);
  37. } catch (RemoteException e) {
  38. HiLog.warn(LABEL, "subscribe in wifi events failed!");
  39. }

相关文章