首页 > 技术知识 > 正文

一、WLAN开发概述

无线局域网(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基础功能的主要接口:HarmonyOS网络连接开发:WLAN开发概述及基础功能介绍-开放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);

本文转载自一牛网,版权归原作者所有,仅供学习参考,如有侵权请联系删除

猜你喜欢