不信任热点配置
场景介绍
应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。
应用或者其他模块可以通过接口完成以下功能：
设置第三方的热点配置。
删除第三方的热点配置。
接口说明
WifiDevice提供WLAN的不信任热点配置功能，其接口说明如下。
表1 不信任热点配置功能的主要接口
添加不信任热点配置
调用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相关信息。
接口说明
WifiP2pController提供WLAN P2P功能，接口说明如下。
表1 WifiP2pController的主要接口
启动与停止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内部或者与应用之间跨进程通讯的机制，注册者在注册消息通知后，一旦符合条件的消息被发出，注册者即可接收到该消息并获取消息中附带的信息。
接口说明
表1 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!"); }
