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

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

转载作者：知者更新时间：2024-03-13 05:05:45

一、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 提供，其接口说明如下：

③ 获取 WLAN 状态

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 isWifiActive() 接口查询 WLAN 是否打开。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 调用获取WLAN开关状态接口
	boolean isWifiActive = wifiDevice.isWifiActive(); // 若WLAN打开，则返回true，否则返回false

④ 发起扫描并获取结果

调用 WifiDevice的getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 scan() 接口发起扫描。
调用 getScanInfoList() 接口获取扫描结果。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 调用WLAN扫描接口
	boolean isScanSuccess = wifiDevice.scan();
	// 调用获取扫描结果
	List<WifiScanInfo> scanInfos = wifiDevice.getScanInfoList();

⑤ 获取连接态详细信息

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 isConnected() 接口获取当前连接状态。
调用 getLinkedInfo() 接口获取连接信息。
调用 getIpInfo() 接口获取IP信息。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 调用WLAN连接状态接口,确定当前设备是否连接WLAN
	boolean isConnected = wifiDevice.isConnected();
	if (isConnected) {
	    // 获取WLAN连接信息
	    Optional<WifiLinkedInfo> linkedInfo = wifiDevice.getLinkedInfo();
	    // 获取连接信息中的SSID
	    String ssid = linkedInfo.get().getSsid();
	    // 获取WLAN的IP信息
	    Optional<IpInfo> ipInfo = wifiDevice.getIpInfo();
	    // 获取IP信息中的IP地址与网关
	    int ipAddress = ipInfo.get().getIpAddress();
	    int gateway = ipInfo.get().getGateway();
	}

⑥ 获取设备国家码

调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 getCountryCode() 接口获取设备的国家码。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 获取当前设备的国家码
	String countryCode = wifiDevice.getCountryCode();

⑦ 判断设备是否支持指定的能力

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 isFeatureSupported(long featureId) 接口判断设备是否支持指定的能力。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 获取当前设备是否支持指定的能力
	boolean isSupportInfra = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA);
	isSupportInfra5g = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA_5G);
	isSupportPasspoint = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_PASSPOINT);
	isSupportP2p = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_P2P);
	isSupportHotspot = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_MOBILE_HOTSPOT);
	isSupportAware = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AWARE);
	isSupportApSta = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AP_STA);
	isSupportWpa3Sae = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SAE);
	isSupportWpa3SuiteB = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SUITE_B);
	isSupportOwe = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_OWE);

三、不信任热点配置

① 应用场景

应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。
应用或者其他模块可以通过接口完成以下功能：
- 设置第三方的热点配置。
- 删除第三方的热点配置。

② API 说明

WifiDevice 提供 WLAN 的不信任热点配置功能，其接口说明如下：

③ 添加不信任热点配置

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 addUntrustedConfig(WifiDeviceConfig config) 接口，设置三方添加的不信任配置。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 设置三方添加的不信任配置
	WifiDeviceConfig config = new WifiDeviceConfig();
	config.setSsid("untrusted-exist");
	config.setPreSharedKey("123456789");
	config.setHiddenSsid(false);
	config.setSecurityType(WifiSecurity.PSK);
	boolean isSuccess = wifiDevice.addUntrustedConfig(config);

④ 删除不信任热点配置

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。
调用 removeUntrustedConfig(WifiDeviceConfig config) 接口，删除三方添加的不信任配置。

// 获取WLAN管理对象
	WifiDevice wifiDevice = WifiDevice.getInstance(context);
	// 设置删除三方添加的不信任配置
	WifiDeviceConfig config = new WifiDeviceConfig();
	config.setSsid("untrusted-exist");
	config.setPreSharedKey("123456789");
	config.setHiddenSsid(false);
	config.setSecurityType(WifiSecurity.PSK);
	boolean isSuccess = wifiDevice.removeUntrustedConfig(config);

四、P2P 功能

① 应用场景

WLAN P2P 功能用于设备与设备之间的点对点数据传输。
应用可以通过接口完成以下功能：
- 发现对端设备。
- 建立与移除群组。
- 向对端设备发起连接。
- 获取 P2P 相关信息。

② API 说明

WifiP2pController 提供 WLAN P2P 功能，接口说明如下：

③ 启动与停止 P2P 搜索

调用 WifiP2pController 的 getInstance(Context context) 接口，获取 P2P 控制器实例，用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
发起 P2P 搜索。
获取 P2P 搜索回调信息。
停止 P2P 搜索。

try {
	    // 获取P2P管理对象
	    WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
	    // 初始化P2P管理对象，用于建立P2P信使等行为
	    wifiP2pController.init(EventRunner.create(true), null);
	    // 创建P2P回调对象
	    P2pDiscoverCallBack p2pDiscoverCallBack = new P2pDiscoverCallBack();
	    // 发起P2P搜索
	    wifiP2pController.discoverDevices(p2pDiscoverCallBack);
	    // 停止P2P搜索
	    wifiP2pController.stopDeviceDiscovery(p2pDiscoverCallBack);
	} catch (RemoteException re) {
	    HiLog.error(LABEL, "exception happened.");
	}
	
	// 获取P2P启动与停止搜索的回调信息（失败或者成功）
	private class P2pDiscoverCallBack extends WifiP2pCallback {
	    @Override
	    public void eventExecFail(int reason) {
	        HiLog.warn(LABEL, "discoverDevices eventExecFail reason : %{public}d", reason);
	    }
	
	    @Override
	    public void eventExecOk() {
	        HiLog.info(LABEL, "discoverDevices eventExecOk");
	    }
	}

④ 创建与移除群组

调用 WifiP2pController的getInstance(Context context) 接口，获取 P2P 控制器实例，用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
创建 P2P 群组。
移除 P2P 群组。

try {
	    // 获取P2P管理对象
	    WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
	    // 初始化P2P管理对象，用于建立P2P信使等行为
	    wifiP2pController.init(EventRunner.create(true), null);
	    // 创建用于P2P建组需要的配置
	    WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE");
	    wifiP2pConfig.setDeviceAddress("02:02:02:02:03:04");
	    wifiP2pConfig.setGroupOwnerBand(0);
	    // 创建P2P回调对象
	    P2pCreateGroupCallBack p2pCreateGroupCallBack = new P2pCreateGroupCallBack();
	    // 创建P2P群组
	    wifiP2pController.createGroup(wifiP2pConfig, p2pCreateGroupCallBack);
	    // 移除P2P群组
	    wifiP2pController.removeGroup(p2pCreateGroupCallBack);
	} catch (RemoteException re) {
	    HiLog.error(LABEL, "exception happened.");
	}
	
	private class P2pCreateGroupCallBack extends WifiP2pCallback {
	    @Override
	    public void eventExecFail(int reason) {
	        HiLog.warn(LABEL, "CreateGroup eventExecFail reason : %{public}d", reason);
	    }
	
	    @Override
	    public void eventExecOk() {
	        HiLog.info(LABEL, "CreateGroup eventExecOk");
	    }
	}

⑤ 发起 P2P 连接

调用 WifiP2pController的getInstance(Context context) 接口，获取 P2P 控制器实例，用于管理 P2P 操作。
调用 init(EventRunner eventRunner, WifiP2pCallback callback) 初始化 P2P 控制器实例。
调用 requestP2pInfo() 查询 P2P 可用设备信息。
根据场景不同，从可用设备信息中选择目标设备。
调用 connect 接口发起连接。

try {
	    // 获取P2P管理对象
	    WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
	    // 初始化P2P管理对象，用于建立P2P信使等行为
	    wifiP2pController.init(EventRunner.create(true), null);
	    // 查询可用P2P设备信息，通过回调获取P2P设备信息
	    P2pRequestPeersCallBack p2pRequestPeersCallBack = new P2pRequestPeersCallBack();
	    wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, p2pRequestPeersCallBack);
	} catch (RemoteException re) {
	    HiLog.error(LABEL, "exception happened.");
	}
	
	private class P2pRequestPeersCallBack extends WifiP2pCallback {
	    @Override
	    public void eventP2pDevicesList(List<WifiP2pDevice> devices) {
	        HiLog.info(LABEL, "eventP2pDevicesList when start connect group");
	        // 根据场景不同，选择不同的设备进行连接，通过MAC地址搜索到指定设备
	        WifiP2pConfig wifiP2pConfig = getSameP2pConfigFromDevices(devices);
	        try {
	            if (wifiP2pConfig != null) {
	                // 向指定的设备发起连接
	                wifiP2pController.connect(wifiP2pConfig, null);
	            }
	        } catch (RemoteException re) {
	            HiLog.error(LABEL, "exception happened in connect.");
	        }
	    }
	}
	
	private WifiP2pConfig getSameP2pConfigFromDevices(List<WifiP2pDevice> devices) {
	    if (devices == null || devices.isEmpty()) {
	        return null;
	    }
	    for (int i = 0; i < devices.size(); i++) {
	        WifiP2pDevice p2pDevice = devices.get(i);
	        HiLog.info(LABEL, "p2pDevice.getDeviceAddress() : %{private}s", p2pDevice.getDeviceAddress());
	        if (p2pDevice.getDeviceAddress() != null
	                && p2pDevice.getDeviceAddress().equals(TARGET_P2P_MAC_ADDRESS)) {
	            HiLog.info(LABEL, "received same mac address");
	            WifiP2pConfig wifiP2pConfig = new WifiP2pConfig("DEFAULT_GROUP_NAME", "DEFAULT_PASSPHRASE"); // 根据实际情况配置名字和密码
	            wifiP2pConfig.setDeviceAddress(p2pDevice.getDeviceAddress());
	            return wifiP2pConfig;
	        }
	    }
	    return null;
	}

⑥ 请求 P2P 相关信息

调用 WifiP2pController 的 getInstance() 接口，获取 P2P 控制器实例，用于管理 P2P 操作。
调用 init() 初始化 P2P 控制器实例。
调用 requestP2pInfo() 查询 P2P 群组信息。
调用 requestP2pInfo() 查询 P2P 设备信息。
根据场景不同，可以调用 requestP2pInfo 获取需要的信息。

try {
	    // 获取P2P管理对象
	    WifiP2pController wifiP2pController = WifiP2pController.getInstance(this);
	    // 初始化P2P管理对象，用于建立P2P信使等行为
	    wifiP2pController.init(EventRunner.create(true), null);
	    // 查询可用P2P群组信息，通过回调获取P2P群组信息
	    P2pRequestGroupInfoCallBack p2pRequestGroupInfoCallBack = new P2pRequestGroupInfoCallBack();
	    wifiP2pController.requestP2pInfo(WifiP2pController.GROUP_INFO_REQUEST, p2pRequestGroupInfoCallBack);
	    // 查询可用P2P设备信息，通过回调获取P2P设备信息
	    P2pRequestDeviceInfoCallBack p2pRequestDeviceInfoCallBack = new P2pRequestDeviceInfoCallBack();
	    wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_INFO_REQUEST, p2pRequestDeviceInfoCallBack);
	    // 通过调用requestP2pInfo接口，可以查询以下关键信息
	    wifiP2pController.requestP2pInfo(WifiP2pController.NETWORK_INFO_REQUEST, callback); // 网络信息
	    wifiP2pController.requestP2pInfo(WifiP2pController.DEVICE_LIST_REQUEST, callback); // 设备列表信息
	} catch (RemoteException re) {
	    HiLog.error(LABEL, "exception happened.");
	}
	
	// 群组信息回调
	private class P2pRequestGroupInfoCallBack extends WifiP2pCallback {
	    @Override
	    public void eventP2pGroup(WifiP2pGroup group) {
	        HiLog.info(LABEL, "P2pRequestGroupInfoCallBack eventP2pGroup");
	        doSthFor(group);
	    }
	}
	// 设备信息回调
	private class P2pRequestDeviceInfoCallBack extends WifiP2pCallback {
	    @Override
	    public void eventP2pDevice(WifiP2pDevice p2pDevice) {
	        HiLog.info(LABEL, "P2pRequestDeviceInfoCallBack eventP2pDevice");
	        doSthFor(p2pDevice);
	    }
	}

五、WLAN 消息通知

① 应用场景

WLAN 消息通知（Notification）是 HarmonyOS 内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。

② API 说明

WLAN 消息通知的相关广播介绍：

③ 开发步骤

构建消息通知接收者 WifiEventSubscriber。
注册 WLAN 变化消息。
WifiEventSubscriber 接收并处理 WLAN 广播消息。

// 构建消息接收者/注册者
	class WifiEventSubscriber extends CommonEventSubscriber {
	    WifiEventSubscriber(CommonEventSubscribeInfo info) {
	        super(info);
	    }
	
	    @Override
	    public void onReceiveEvent(CommonEventData commonEventData) {
	        if (commonEventData == null || commonEventData.getIntent() == null) {
	            return;
	        }
	        if (WifiEvents.EVENT_ACTIVE_STATE.equals(commonEventData.getIntent().getAction())) {
	            // 获取附带参数
	            IntentParams params = commonEventData.getIntent().getParams();
	            if (params == null) {
	                return;
	            }
	            int wifiState= (int) params.getParam(WifiEvents.PARAM_ACTIVE_STATE);
	            
	            if (wifiState== WifiEvents.STATE_ACTIVE) { // 处理WLAN被打开消息
	                HiLog.info(LABEL, "Receive WifiEvents.STATE_ACTIVE %{public}d", wifiState);
	            } else if (wifiState == WifiEvents.STATE_INACTIVE) { // 处理WLAN被关闭消息  
	                HiLog.info(LABEL, "Receive WifiEvents.STATE_INACTIVE %{public}d", wifiState);
	            } else { // 处理WLAN异常状态
	                HiLog.warn(LABEL,"Unknown wifi state");
	            }
	        }
	    }
	}
	
	// 注册消息
	MatchingSkills match = new MatchingSkills();
	// 增加获取WLAN状态变化消息
	match.addEvent(WifiEvents.EVENT_ACTIVE_STATE);
	CommonEventSubscribeInfo subscribeInfo = new CommonEventSubscribeInfo(match);
	subscribeInfo.setPriority(100); 
	WifiEventSubscriber subscriber = new WifiEventSubscriber(subscribeInfo);
	
	try {
	    CommonEventManager.subscribeCommonEvent(subscriber);
	} catch (RemoteException e) {
	    HiLog.warn(LABEL, "subscribe in wifi events failed!");
	}

文章推荐： HarmonyOS之AI能力·语音播报

文章推荐： HCIA-HarmonyOS Application Developer 应用方向认证资料

文章推荐： HarmonyOS学习路之开发基础——快速入门(实现页面跳转)

android - R(android) 到 HarmonyOs 和 Displaymetrics 到 HarmonyOS 和一些常量的替代包是什么？
我应该如何处理导致一些问题的常量。？ import static android.net.ConnectivityManager.TYPE_BLUETOOTH; import
HarmonyOS 第三方登录之QQ登录
前言因为鸿蒙系统刚出不久，官方的第三方登录SDK还没出来，下面就介绍下在鸿蒙应用中实现QQ登录的方法(支持唤起QQ安卓客户端进行授权) 前期准备登录QQ开放平台 >
HarmonyOS ArkUI之开发基础（网络请求）
简介前段时间一直研究ArkUI中的声明式开发，开发了一些demo，但都是界面相关的，相对来说比较基础，也比较简单。所以研究一下其他的，现在成熟的APP都会有网络交互，所以记录一篇网络
HarmonyOS ArkUI之自定义组件侧滑菜单（JS）
前言鸿蒙这次API7更新除了新增TS声明式开发之外，还有JS开发也增加了很多API，JS开发自定义组件越来越方便了。本项目基于ArkUI中JS扩展的类Web开发范式，关于
HarmonyOS ArkUI之仿微信图片选择
前言本项目就是基于ArkUI中的声明式编程开发，语言ETS(Extended Type Script)，代码都在ets文件中编写，这个文件用于描述 UI 布局、样式、事件交互和页面逻辑。
鸿蒙系统(HarmonyOS)全局弹窗实现
全局弹窗相对于自定义弹窗有以下优点：封装更彻底，一行代码就能调用跟组件耦合度低，只需要传入组件的UIContext对象，不需要跟自定义弹窗一样需要在组件内部实例化CustomDialo
wearables - HarmonyOS 可穿戴振动器未激活
我正在使用 JS 框架创建一个 HarmonyOS 可穿戴应用程序，我想使用振动器。 watch 肯定有一个振动器，因为当我在设置应用程序中使用滚动条时我能感觉到它。所以我申请了 system_gr
HarmonyOS 项目实战之通讯录Demo(JS)
1 简介通讯录demo主要分为联系人界面、设置紧急联系人、服务卡片3个模块，分为Java和JS两个版本，本篇主要讲解用尽可能的用纯JS去实现，实在无法实现的地方采用JS与Java结合
HarmonyOS ArkUI之列表下拉刷新、加载更多（TS）
简介本项目界面搭建基于ArkUI中TS扩展的声明式开发范式，关于语法和概念直接看官网官方文档地址：基于TS扩展的声明式开发范式1、基于TS扩展的声明式开发范式2
HarmonyOS 分布式多端应用一站式开发平台（DevEco Studio 安装）
DevEco Studio 下载、安装教程 DevEco Studio 下载下载地址运行环境操作系统：Windows 10 64位内存：8GB及以上硬盘：100GB及以上分辨率：1580*
java - 如何在 HarmonyOS 中检测自定义组件中的双击？
我正在使用 Java SDK 在 HarmonyOS 中创建一个自定义组件，我必须在其中双击执行一些任务。但我无法检测到双击事件。在 Android 中，借助手势检测器类我们可以检测双击事件如下
HCIA-HarmonyOS Application Developer 应用方向认证资料
看到在 51CTO HarmonyOS社区张老师发了关于设备方向的认证资料，我给大家准备了应用方向的认证资料。因为认证刚开始发布，现阶段去考相对来说是挺简单的，但是还是得把大纲的东西全部弄会。官网
java - RxJava observeOn Android/HarmonyOS 主线程
我正在开发华为 HarmonyOS 应用程序，我正在尝试使用 RxJava 为后台任务实现一个基类。我的问题是我不知道如何在主线程上观察。在常规 Android 上，我会使用 AndroidSche
flutter - 从 Flutter 项目生成 HarmonyOS(华为)构建
我正在做一个 Flutter 项目。其中，我们要生成 Android、iOS 和 HarmonyOS(华为)的构建版本。但我不确定 Flutter 是否支持这个操作系统。我浏览了互联网上的一些东西，但
java - Harmonyos 中 view.postDelayed(Runnable action, long delayMillis) 的等价物是什么？
我正在使用 Java SDK 在 HarmonyOS 中创建一个自定义组件，我必须在组件实例延迟一段时间后执行一些任务。在 Android 中，我们有 postDelayed(Runnable ac

知者

个人简介

我是一名优秀的程序员,十分优秀！

作者热门文章

滴滴打车优惠券免费领取

全站热门文章

首页

博学

6Ren·AI

商城

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

一、WLAN 简介

二、WLAN 基础功能

① 应用场景

② API 说明

③ 获取 WLAN 状态

④ 发起扫描并获取结果

⑤ 获取连接态详细信息

⑥ 获取设备国家码

⑦ 判断设备是否支持指定的能力

三、不信任热点配置

① 应用场景

② API 说明

③ 添加不信任热点配置

④ 删除不信任热点配置

四、P2P 功能

① 应用场景

② API 说明

③ 启动与停止 P2P 搜索

④ 创建与移除群组

⑤ 发起 P2P 连接

⑥ 请求 P2P 相关信息

五、WLAN 消息通知

① 应用场景

② API 说明

③ 开发步骤