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

WLAN开发概述

无线局域网（Wireless Local Area Networks，WLAN），是通过无线电、红外光信号或者其他技术发送和接收数据的局域网，用户可以通过WLAN实现结点之间无物理连接的网络通讯。常用于用户携带可移动终端的办公、公众环境中。

HarmonyOS WLAN服务系统为用户提供WLAN基础功能、P2P（peer-to-peer）功能和WLAN消息通知的相应服务，让应用可以通过WLAN和其他设备互联互通。

约束与限制

本开发指南提供多个开发场景的指导，涉及多个API接口的调用。在调用API前，应用需要先申请对应的访问权限，具体请参照对应场景的开放能力介绍。

WLAN基础功能

场景介绍

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

1. 获取WLAN状态，查询WLAN是否打开。
2. 发起扫描并获取扫描结果。
3. 获取连接态详细信息，包括连接信息、IP信息等。
4. 获取设备国家码。
5. 获取设备是否支持指定的能力。

接口说明

WLAN基础功能由WifiDevice提供，其接口说明如下。

表1 WLAN基础功能的主要接口

接口名	描述	所需权限
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状态

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

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

发起扫描并获取结果

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

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

获取连接态详细信息

1. 调用WifiDevice的getInstance​(Context context)接口，获取WifiDevice实例，用于管理本机WLAN操作。
2. 调用isConnected​()接口获取当前连接状态。
3. 调用getLinkedInfo()接口获取连接信息。
4. 调用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();
}

获取设备国家码

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

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

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

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