WLAN开发概述
无线局域网（Wireless Local Area Networks，WLAN），是通过无线电、红外光信号或者其他技术发送和接收数据的局域网，用户可以通过WLAN实现结点之间无物理连接的网络通讯。常用于用户携带可移动终端的办公、公众环境中。
HarmonyOS WLAN服务系统为用户提供WLAN基础功能、P2P（peer-to-peer）功能和WLAN消息通知的相应服务，让应用可以通过WLAN和其他设备互联互通。
约束与限制
本开发指南提供多个开发场景的指导，涉及多个API接口的调用。在调用API前，应用需要先申请对应的访问权限，具体请参照对应场景的开放能力介绍。
WLAN基础功能
场景介绍
应用或者其他模块可以通过接口完成以下功能：
获取WLAN状态，查询WLAN是否打开。
发起扫描并获取扫描结果。
获取连接态详细信息，包括连接信息、IP信息等。
获取设备国家码。
获取设备是否支持指定的能力。
接口说明
WLAN基础功能由WifiDevice提供，其接口说明如下。
表1 WLAN基础功能的主要接口
获取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);
![120. [HarmonyOS NEXT 实战案例：教育应用] 基础篇 - 垂直分割布局打造课程学习平台](https://ucc.alicdn.com/f7blgaeddhq3u/developer-article1666855/20250612/a814d1eb10664fa4a19a64e9a0cff6a7.webp?x-oss-process=image/format,webp/resize,h_160,m_lfit)
![122.[HarmonyOS NEXT 实战案例：教育应用] 高级篇 - 课程学习平台的高级布局与自适应设计](https://ucc.alicdn.com/f7blgaeddhq3u/developer-article1666857/20250612/c8108123db17449dadb6c34f889abd18.webp?x-oss-process=image/format,webp/resize,h_160,m_lfit)
