HarmonyOS学习路之开发篇—网络与连接（WLAN开发二）-阿里云开发者社区

不信任热点配置

场景介绍

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

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

设置第三方的热点配置。

删除第三方的热点配置。

接口说明

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!");
}

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

热门文章

最新文章

相关课程

相关电子书

相关实验场景

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

热门文章

最新文章

相关课程

相关电子书

相关实验场景

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