无线局域网(Wireless Local Area Networks,WLAN),是通过无线电、红外光信号或者其他技术发送和接收数据的局域网,用户可以通过WLAN实现结点之间无物理连接的网络通讯。常用于用户携带可移动终端的办公、公众环境中。
HarmonyOS WLAN服务系统为用户提供WLAN基础功能、P2P(peer-to-peer)功能和WLAN消息通知的相应服务,让应用可以通过WLAN和其他设备互联互通。 约束与限制本开发指南提供多个开发场景的指导,涉及多个API接口的调用。在调用API前,应用需要先申请对应的访问权限,具体请参照对应场景的开放能力介绍。
二、WLAN基础功能1、场景介绍应用或者其他模块可以通过接口完成以下功能:
获取WLAN状态,查询WLAN是否打开。发起扫描并获取扫描结果。获取连接态详细信息,包括连接信息、IP信息等。获取设备国家码。获取设备是否支持指定的能力。 2、接口说明WLAN基础功能由wifidevice提供,其接口说明如下
表1 WLAN基础功能的主要接口: 3、获取WLAN状态调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
调用isWifiActive()接口查询WLAN是否打开。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 调用获取WLAN开关状态接口
boolean isWifiActive = wifiDevice.isWifiActive(); // 若WLAN打开,则返回true,否则返回false 4、发起扫描并获取结果调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
调用scan()接口发起扫描。
调用getScanInfoList()接口获取扫描结果。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 调用WLAN扫描接口
boolean isScanSuccess = wifiDevice.scan();
// 调用获取扫描结果
List scanInfos = wifiDevice.getScanInfoList(); 5、获取连接态详细信息调用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 linkedInfo = wifiDevice.getLinkedInfo();
// 获取连接信息中的SSID
String ssid = linkedInfo.get().getSsid();
// 获取WLAN的IP信息
Optional ipInfo = wifiDevice.getIpInfo();
// 获取IP信息中的IP地址与网关
int ipAddress = ipInfo.get().getIpAddress();
int gateway = ipInfo.get().getGateway();
} 6、获取设备国家码调用WifiDevice的getInstance(Context context)接口,获取WifiDevice实例,用于管理本机WLAN操作。
调用getCountryCode()接口获取设备的国家码。
// 获取WLAN管理对象
WifiDevice wifiDevice = WifiDevice.getInstance(context);
// 获取当前设备的国家码
String countryCode = wifiDevice.getCountryCode(); 7、判断设备是否支持指定的能力调用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);本文转载自一牛网,版权归原作者所有,仅供学习参考,如有侵权请联系删除
免责声明:文章内容来自互联网,本站不对其真实性负责,也不承担任何法律责任,如有侵权等情况,请与本站联系删除。
转载请注明出处:HarmonyOS网络连接开发:WLAN开发概述及基础功能介绍-开放wlan https://www.yhzz.com.cn/a/9944.html