鸿蒙OS开发文档鸿蒙OS WLAN基础功能

2024-02-25 开发教程鸿蒙OS开发文档匿名 2℃

场景介绍

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

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

接口说明

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

接口名	描述	所需权限
getInstance(Context context)	获取WLAN功能管理对象实例，通过该实例调用 WLAN 基本功能 API。	NA
isWifiActive()	获取当前WLAN打开状态。	ohos.permission.GET_WIFI_INFO
scan()	发起 WLAN 扫描。	ohos.permission.SET_WIFI_INFOohos.permission.LOCATION
getScanInfoList()	获取上次扫描结果。	ohos.permission.GET_WIFI_INFOohos.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.LOCATIONohos.permission.GET_WIFI_INFO
isFeatureSupported(long featureId)	获取设备是否支持指定的特性。	ohos.permission.GET_WIFI_INFO

获取 WLAN 状态

调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

调用 isWifiActive()接口查询 WLAN 是否打开。

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

发起扫描并获取结果

调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

调用 scan() 接口发起扫描。

调用 getScanInfoList() 接口获取扫描结果。

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

获取连接态详细信息

调用 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<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();
   }

获取设备国家码

调用 WifiDevice 的 getInstance(Context context) 接口，获取 WifiDevic e实例，用于管理本机WLAN操作。

调用 getCountryCode() 接口获取设备的国家码。

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

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

调用 WifiDevice 的 getInstance(Context context)接口，获取 WifiDevice 实例，用于管理本机 WLAN 操作。

调用 isFeatureSupported(long featureId)接口判断设备是否支持指定的能力。

// 获取WLAN管理对象
   WifiDevice wifiDevice = WifiDevice.getInstance(context);
   // 获取当前设备是否支持指定的能力
   boolean isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_INFRA_5G);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_PASSPOINT);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_P2P);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_MOBILE_HOTSPOT);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AWARE);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_AP_STA);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SAE);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_WPA3_SUITE_B);
   isSupport = wifiDevice.isFeatureSupported(WifiUtils.WIFI_FEATURE_OWE);

上一节：鸿蒙OS WLAN概述

下一节：鸿蒙OS P2P功能章

"鸿蒙OS开发文档"的目录

鸿蒙OS开发文档 鸿蒙OS WLAN基础功能

场景介绍

接口说明

获取 WLAN 状态

发起扫描并获取结果

获取连接态详细信息

获取设备国家码

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

鸿蒙OS开发文档鸿蒙OS WLAN基础功能