HarmonyOS学习路之开发篇—网络与连接（WLAN开发 二）

不信任热点配置

场景介绍

应用可以添加指定的热点，其选网优先级低于已保存热点。如果扫描后判断该热点为最合适热点，自动连接该热点。

应用或者其他模块可以通过接口完成以下功能：

1. 设置第三方的热点配置。
2. 删除第三方的热点配置。

接口说明

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

表1 不信任热点配置功能的主要接口

接口名	描述	所需权限
getInstance(Context context)	获取WLAN功能管理对象实例，通过该实例调用不信任热点配置的API。	NA
addUntrustedConfig​(WifiDeviceConfig config)	添加不信任热点配置，选网优先级低于已保存热点。	ohos.permission.SET_WIFI_INFO
removeUntrustedConfig(WifiDeviceConfig config)	删除不信任热点配置。	ohos.permission.SET_WIFI_INFO

添加不信任热点配置

1. 调用WifiDevice的getInstance​(Context context)接口，获取WifiDevice实例，用于管理本机WLAN操作。
2. 调用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);

删除不信任热点配置

1. 调用WifiDevice的getInstance​(Context context)接口，获取WifiDevice实例，用于管理本机WLAN操作。
2. 调用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功能用于设备与设备之间的点对点数据传输，应用可以通过接口完成以下功能：

1. 发现对端设备。
2. 建立与移除群组。
3. 向对端设备发起连接。
4. 获取P2P相关信息。

接口说明

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

表1 WifiP2pController的主要接口

接口名	描述	所需权限
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搜索的开发步骤

1. 调用WifiP2pController的getInstance​(Context context)接口，获取P2P控制器实例，用于管理P2P操作。
2. 调用init(EventRunner eventRunner, WifiP2pCallback callback)初始化P2P控制器实例。
3. 发起P2P搜索。
4. 获取P2P搜索回调信息。
5. 停止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");
    }
}

创建与移除群组的开发步骤

1. 调用WifiP2pController的getInstance​(Context context)接口，获取P2P控制器实例，用于管理P2P操作。
2. 调用init(EventRunner eventRunner, WifiP2pCallback callback)初始化P2P控制器实例。
3. 创建P2P群组。
4. 移除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连接的开发步骤

1. 调用WifiP2pController的getInstance​(Context context)接口，获取P2P控制器实例，用于管理P2P操作。
2. 调用init(EventRunner eventRunner, WifiP2pCallback callback)初始化P2P控制器实例。
3. 调用requestP2pInfo()查询P2P可用设备信息。
4. 根据场景不同，从可用设备信息中选择目标设备。
5. 调用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 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 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相关信息的开发步骤

1. 调用WifiP2pController的getInstance​()接口，获取P2P控制器实例，用于管理P2P操作。
2. 调用init()初始化P2P控制器实例。
3. 调用requestP2pInfo()查询P2P群组信息。
4. 调用requestP2pInfo()查询P2P设备信息。
5. 根据场景不同，可以调用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消息通知的相关广播介绍

描述	通知名	附加参数
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

开发步骤

1. 构建消息通知接收者WifiEventSubscriber。
2. 注册WLAN变化消息。
3. 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!");
}