WLAN

说明： 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import wifi from '@ohos.wifi';

wifi.isWifiActive

isWifiActive(): boolean

查询WLAN是否已激活。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
boolean	true:已激活， false:未激活。

wifi.scan

scan(): boolean

启动WLAN扫描。

需要权限： ohos.permission.SET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
boolean	true:扫描操作执行成功， false:扫描操作执行失败。

wifi.getScanInfos

getScanInfos(): Promise<Array<WifiScanInfo>>

获取扫描结果，使用promise方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
Promise< Array<WifiScanInfo> >	返回扫描到的热点列表。

wifi.getScanInfos

getScanInfos(callback: AsyncCallback<Array<WifiScanInfo>>): void

获取扫描结果，使用callback方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
callback	AsyncCallback< Array<WifiScanInfo>>	是	扫描到的热点列表结果回调函数。

示例

import wifi from '@ohos.wifi';

wifi.getScanInfos((err, result) => {
    if (err) {
        console.error("get scan info error");
        return;
    }

    var len = Object.keys(result).length;
    console.log("wifi received scan info: " + len);
    for (var i = 0; i < len; ++i) {
        console.info("ssid: " + result[i].ssid);
        console.info("bssid: " + result[i].bssid);
        console.info("capabilities: " + result[i].capabilities);
        console.info("securityType: " + result[i].securityType);
        console.info("rssi: " + result[i].rssi);
        console.info("band: " + result[i].band);
        console.info("frequency: " + result[i].frequency);
        console.info("channelWidth: " + result[i].channelWidth);
        console.info("timestamp: " + result[i].timestamp);
    }
});

wifi.getScanInfos().then(result => {
    var len = Object.keys(result).length;
    console.log("wifi received scan info: " + len);
    for (var i = 0; i < len; ++i) {
        console.info("ssid: " + result[i].ssid);
        console.info("bssid: " + result[i].bssid);
        console.info("capabilities: " + result[i].capabilities);
        console.info("securityType: " + result[i].securityType);
        console.info("rssi: " + result[i].rssi);
        console.info("band: " + result[i].band);
        console.info("frequency: " + result[i].frequency);
        console.info("channelWidth: " + result[i].channelWidth);
        console.info("timestamp: " + result[i].timestamp);
    }
});

WifiScanInfo

WLAN热点信息。

参数名	类型	读写属性	说明
ssid	string	只读	热点的SSID，编码格式为UTF-8。
bssid	string	只读	热点的BSSID。
capabilities	string	只读	热点能力。
securityType	WifiSecurityType	只读	WLAN加密类型。
rssi	number	只读	热点的信号强度(dBm)。
band	number	只读	WLAN接入点的频段。
frequency	number	只读	WLAN接入点的频率。
channelWidth	number	只读	WLAN接入点的带宽。
timestamp	number	只读	时间戳。

WifiSecurityType

表示加密类型的枚举。

名称	默认值	说明
WIFI_SEC_TYPE_INVALID	0	无效加密类型。
WIFI_SEC_TYPE_OPEN	1	开放加密类型。
WIFI_SEC_TYPE_WEP	2	Wired Equivalent Privacy (WEP)加密类型。
WIFI_SEC_TYPE_PSK	3	Pre-shared key (PSK)加密类型。
WIFI_SEC_TYPE_SAE	4	Simultaneous Authentication of Equals (SAE)加密类型。

wifi.addUntrustedConfig⁷⁺

addUntrustedConfig(config: WifiDeviceConfig): Promise<boolean>

添加不可信网络配置，使用promise方式作为异步方法。

说明：此接口为预留接口，3.1 Release 版本暂不支持。
需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。

返回值：

类型	说明
Promise<boolean>	操作结果，ture: 成功， false: 失败。

WifiDeviceConfig

WLAN配置信息。

参数名	类型	读写属性	说明
ssid	string	只读	热点的SSID，编码格式为UTF-8。
bssid	string	只读	热点的BSSID。
preSharedKey	string	只读	热点的密钥。
isHiddenSsid	boolean	只读	是否是隐藏网络。
securityType	WifiSecurityType	只读	加密类型。

wifi.addUntrustedConfig⁷⁺

addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback<boolean>): void

添加不可信网络配置，使用callback方式作为异步方法。

说明：此接口为预留接口，3.1 Release 版本暂不支持。
需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。
callback	AsyncCallback<boolean>	是	操作结果，ture: 成功， false: 失败。

wifi.removeUntrustedConfig⁷⁺

removeUntrustedConfig(config: WifiDeviceConfig): Promise<boolean>

移除不可信网络配置，使用promise方式作为异步方法。

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。

返回值：

类型	说明
Promise<boolean>	操作结果，ture: 成功， false: 失败。

wifi.removeUntrustedConfig⁷⁺

removeUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback<boolean>): void

移除不可信网络配置，使用callback方式作为异步方法。

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。
callback	AsyncCallback<boolean>	是	操作结果，ture: 成功， false: 失败。

wifi.getSignalLevel

getSignalLevel(rssi: number, band: number): number

查询WLAN信号强度。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数：

参数名	类型	必填	说明
rssi	number	是	热点的信号强度(dBm)。
band	number	是	WLAN接入点的频段。

返回值：

类型	说明
number	信号强度，取值范围为[0, 4]。

wifi.getLinkedInfo

getLinkedInfo(): Promise<WifiLinkedInfo>

获取WLAN连接信息，使用promise方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
Promise<WifiLinkedInfo>	WLAN连接的相关信息。

wifi.getLinkedInfo

getLinkedInfo(callback: AsyncCallback<WifiLinkedInfo>): void

获取WLAN连接信息，使用callback方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
callback	AsyncCallback<WifiLinkedInfo>	是	WLAN连接信息结果回调函数。

示例

import wifi from '@ohos.wifi';

wifi.getLinkedInfo((err, data) => {
    if (err) {
        console.error("get linked info error");
        return;
    }
    console.info("get wifi linked info: " + JSON.stringify(data));
});

wifi.getLinkedInfo().then(data => {
    console.info("get wifi linked info: " + JSON.stringify(data));
}).catch(error => {
    console.info("get linked info error");
});

WifiLinkedInfo

提供WLAN连接的相关信息。

参数名	类型	读写属性	说明
ssid	string	只读	热点的SSID，编码格式为UTF-8。
bssid	string	只读	热点的BSSID。
rssi	number	只读	热点的信号强度(dBm)。
band	number	只读	WLAN接入点的频段。
linkSpeed	number	只读	WLAN接入点的速度。
frequency	number	只读	WLAN接入点的频率。
isHidden	boolean	只读	WLAN接入点是否是隐藏网络。
isRestricted	boolean	只读	WLAN接入点是否限制数据量。
macAddress	string	只读	设备的MAC地址。
ipAddress	number	只读	WLAN连接的IP地址。
connState	ConnState	只读	WLAN连接状态。

ConnState

表示WLAN连接状态的枚举。

名称	默认值	说明
SCANNING	0	设备正在搜索可用的AP。
CONNECTING	1	正在建立WLAN连接。
AUTHENTICATING	2	WLAN连接正在认证中。
OBTAINING_IPADDR	3	正在获取WLAN连接的IP地址。
CONNECTED	4	WLAN连接已建立。
DISCONNECTING	5	WLAN连接正在断开。
DISCONNECTED	6	WLAN连接已断开。
UNKNOWN	7	WLAN连接建立失败。

wifi.isConnected⁷⁺

isConnected(): boolean

查询WLAN是否已连接。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
boolean	true:已连接， false:未连接。

wifi.isFeatureSupported⁷⁺

isFeatureSupported(featureId: number): boolean

判断设备是否支持相关WLAN特性。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.Core
参数：

参数名	类型	必填	说明
featureId	number	是	特性ID值。

返回值：

类型	说明
boolean	true:支持， false:不支持。

特性ID值枚举。

枚举值	说明
0x0001	基础结构模式特性。
0x0002	5 GHz带宽特性。
0x0004	GAS/ANQP特性。
0x0008	Wifi-Direct特性。
0x0010	Soft AP特性。
0x0040	Wi-Fi AWare组网特性。
0x8000	AP STA共存特性。
0x8000000	WPA3-Personal SAE特性。
0x10000000	WPA3-Enterprise Suite-B
0x20000000	增强开放特性。

wifi.getIpInfo⁷⁺

getIpInfo(): IpInfo

获取IP信息。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：

类型	说明
IpInfo	IP信息。

IpInfo⁷⁺

IP信息。

参数名	类型	读写属性	说明
ipAddress	number	只读	IP地址。
gateway	number	只读	网关。
netmask	number	只读	掩码。
primaryDns	number	只读	主DNS服务器IP地址。
secondDns	number	只读	备DNS服务器IP地址。
serverIp	number	只读	DHCP服务端IP地址。
leaseDuration	number	只读	IP地址租用时长。

wifi.getCountryCode⁷⁺

getCountryCode(): string

获取国家码信息。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.Core
返回值：

类型	说明
string	国家码。

wifi.getP2pLinkedInfo⁸⁺

getP2pLinkedInfo(): Promise<WifiP2pLinkedInfo>

获取P2P连接信息，使用promise方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
Promise<WifiP2pLinkedInfo>	P2P连接信息。

wifi.getP2pLinkedInfo⁸⁺

getP2pLinkedInfo(callback: AsyncCallback<WifiP2pLinkedInfo>): void

获取P2P连接信息，使用callback方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
callback	AsyncCallback<WifiP2pLinkedInfo>	是	P2P连接信息结果回调函数。

WifiP2pLinkedInfo⁸⁺

提供WLAN连接的相关信息。

参数名	类型	读写属性	说明
connectState	P2pConnectState	只读	P2P连接状态。
isGroupOwner	boolean	只读	是否是群组。
groupOwnerAddr	string	只读	群组MAC地址。

P2pConnectState⁸⁺

表示P2P连接状态的枚举。

名称	默认值	说明
DISCONNECTED	0	断开状态。
CONNECTED	1	连接状态。

wifi.getCurrentGroup⁸⁺

getCurrentGroup(): Promise<WifiP2pGroupInfo>

获取P2P当前组信息，使用promise方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
Promise<WifiP2pGroupInfo>	当前组信息。

wifi.getCurrentGroup⁸⁺

getCurrentGroup(callback: AsyncCallback<WifiP2pGroupInfo>): void

获取P2P当前组信息，使用callback方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
callback	AsyncCallback<WifiP2pGroupInfo>	是	当前组信息的回调函数。

WifiP2pGroupInfo⁸⁺

表示P2P群组相关信息。

参数名	类型	读写属性	说明
isP2pGo	boolean	只读	是否是群组。
ownerInfo	WifiP2pDevice	只读	群组的设备信息。
passphrase	string	只读	群组密钥。
interface	string	只读	接口名称。
groupName	string	只读	群组名称。
networkId	number	只读	网络ID。
frequency	number	只读	群组的频率。
clientDevices	WifiP2pDevice[]	只读	接入的设备列表信息。
goIpAddress	string	只读	群组IP地址。

WifiP2pDevice⁸⁺

表示P2P设备信息。

参数名	类型	读写属性	说明
deviceName	string	只读	设备名称。
deviceAddress	string	只读	设备MAC地址。
primaryDeviceType	string	只读	主设备类型。
deviceStatus	P2pDeviceStatus	只读	设备状态。
groupCapabilities	number	只读	群组能力。

P2pDeviceStatus⁸⁺

表示设备状态的枚举。

名称	默认值	说明
CONNECTED	0	连接状态。
INVITED	1	邀请状态。
FAILED	2	失败状态。
AVAILABLE	3	可用状态。
UNAVAILABLE	4	不可用状态。

wifi.getP2pPeerDevices⁸⁺

getP2pPeerDevices(): Promise<WifiP2pDevice[]>

获取P2P对端设备列表信息，使用promise方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
Promise<WifiP2pDevice[]>	对端设备列表信息。

wifi.getP2pPeerDevices⁸⁺

getP2pPeerDevices(callback: AsyncCallback<WifiP2pDevice[]>): void

获取P2P对端设备列表信息，使用callback方式作为异步方法。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
callback	AsyncCallback<WifiP2pDevice[]>	是	对端设备列表信息回调函数。

wifi.createGroup⁸⁺

createGroup(config: WifiP2PConfig): boolean;

创建群组。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数：

参数名	类型	必填	说明
config	WifiP2PConfig	是	群组配置信息。

返回值：

类型	说明
boolean	true:创建群组操作执行成功， false:创建群组操作执行失败。

WifiP2PConfig⁸⁺

表示P2P配置信息。

参数名	类型	读写属性	说明
deviceAddress	string	只读	设备地址。
netId	number	只读	网络ID。创建群组时-1表示创建临时组，-2表示创建永久组。
passphrase	string	只读	群组密钥。
groupName	string	只读	群组名称。
goBand	GroupOwnerBand	只读	群组带宽。

GroupOwnerBand⁸⁺

表示群组带宽的枚举。

名称	默认值	说明
GO_BAND_AUTO	0	自动模式。
GO_BAND_2GHZ	1	2GHZ。
GO_BAND_5GHZ	2	5GHZ。

wifi.removeGroup⁸⁺

removeGroup(): boolean;

移除群组。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
boolean	true:操作执行成功， false:操作执行失败。

wifi.p2pConnect⁸⁺

p2pConnect(config: WifiP2PConfig): boolean;

执行P2P连接。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数：

参数名	类型	必填	说明
config	WifiP2PConfig	是	连接配置信息。

返回值：

类型	说明
boolean	true:操作执行成功， false:操作执行失败。

示例

import wifi from '@ohos.wifi';

var recvP2pConnectionChangeFunc = result => {
    console.info("p2p connection change receive event: " + JSON.stringify(result));
    wifi.getP2pLinkedInfo((err, data) => {
        if (err) {
            console.error('failed to get getP2pLinkedInfo: ' + JSON.stringify(err));
            return;
        }
        console.info("get getP2pLinkedInfo: " + JSON.stringify(data));
    });
}
wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc);

var recvP2pDeviceChangeFunc = result => {
    console.info("p2p device change receive event: " + JSON.stringify(result));
}
wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc);

var recvP2pPeerDeviceChangeFunc = result => {
    console.info("p2p peer device change receive event: " + JSON.stringify(result));
    wifi.getP2pPeerDevices((err, data) => {
        if (err) {
            console.error('failed to get peer devices: ' + JSON.stringify(err));
            return;
        }
        console.info("get peer devices: " + JSON.stringify(data));
        var len = Object.keys(data).length;
        for (var i = 0; i < len; ++i) {
            if (data[i].deviceName === "my_test_device") {
                console.info("p2p connect to test device: " + data[i].deviceAddress);
                var config = {
                    "deviceAddress":data[i].deviceAddress,
                    "netId":-2,
                    "passphrase":"",
                    "groupName":"",
                    "goBand":0,
                }
                wifi.p2pConnect(config);
            }
        }
    });
}
wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);

var recvP2pPersistentGroupChangeFunc = result => {
    console.info("p2p persistent group change receive event");

    wifi.getCurrentGroup((err, data) => {
        if (err) {
            console.error('failed to get current group: ' + JSON.stringify(err));
            return;
        }
        console.info("get current group: " + JSON.stringify(data));
    });
}
wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);

setTimeout(function() {wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);}, 125 * 1000);
console.info("start discover devices -> " + wifi.startDiscoverDevices());

wifi.p2pCancelConnect⁸⁺

p2pCancelConnect(): boolean;

取消P2P连接。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
boolean	true:取消连接操作执行成功， false:取消连接操作执行失败。

wifi.startDiscoverDevices⁸⁺

startDiscoverDevices(): boolean;

开始发现设备。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
boolean	true:操作执行成功， false:操作执行失败。

wifi.stopDiscoverDevices⁸⁺

stopDiscoverDevices(): boolean;

停止发现设备。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：

类型	说明
boolean	true:操作执行成功，操作执行失败。

wifi.on('wifiStateChange')⁷⁺

on(type: "wifiStateChange", callback: Callback<number>): void

注册WLAN状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiStateChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

状态改变事件的枚举。

枚举值	说明
0	未激活。
1	已激活。
2	激活中。
3	去激活中。

wifi.off('wifiStateChange')⁷⁺

off(type: "wifiStateChange", callback?: Callback<number>): void

取消注册WLAN状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiStateChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

示例

import wifi from '@ohos.wifi';

var WIFI_POWER_STATE = "wifiStateChange";
var recvPowerNotifyFunc = result => {
    console.info("Receive power state change event: " + result);
}

// Register event
wifi.on(WIFI_POWER_STATE, recvPowerNotifyFunc);

// Unregister event
wifi.off(WIFI_POWER_STATE, recvPowerNotifyFunc);

wifi.on('wifiConnectionChange')⁷⁺

on(type: "wifiConnectionChange", callback: Callback<number>): void

注册WLAN连接状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiConnectionChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

连接状态改变事件的枚举。

枚举值	说明
0	已断开。
1	已连接。

wifi.off('wifiConnectionChange')⁷⁺

off(type: "wifiConnectionChange", callback?: Callback<number>): void

取消注册WLAN连接状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiConnectionChange"字符串。
callback	Callback<number>	否	连接状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('wifiScanStateChange')⁷⁺

on(type: "wifiScanStateChange", callback: Callback<number>): void

注册扫描状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiScanStateChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

扫描状态改变事件的枚举。

枚举值	说明
0	扫描失败。
1	扫描成功。

wifi.off('wifiScanStateChange')⁷⁺

off(type: "wifiScanStateChange", callback?: Callback<number>): void

取消注册扫描状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiScanStateChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('wifiRssiChange')⁷⁺

on(type: "wifiRssiChange", callback: Callback<number>): void

注册RSSI状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiRssiChange"字符串。
callback	Callback<number>	是	状态改变回调函数，返回以dBm为单位的RSSI值。

wifi.off('wifiRssiChange')⁷⁺

off(type: "wifiRssiChange", callback?: Callback<number>): void

取消注册RSSI状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数

参数名	类型	必填	说明
type	string	是	固定填"wifiRssiChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('hotspotStateChange')⁷⁺

on(type: "hotspotStateChange", callback: Callback<number>): void

注册热点状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.AP.Core
参数

参数名	类型	必填	说明
type	string	是	固定填"hotspotStateChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

热点状态改变事件的枚举。

枚举值	说明
0	未激活。
1	已激活。
2	激活中。
3	去激活中。

wifi.off('hotspotStateChange')⁷⁺

off(type: "hotspotStateChange", callback?: Callback<number>): void

取消注册热点状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.AP.Core
参数

参数名	类型	必填	说明
type	string	是	固定填"hotspotStateChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pStateChange')⁸⁺

on(type: "p2pStateChange", callback: Callback<number>): void

注册P2P开关状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pStateChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

P2P状态改变事件的枚举。

枚举值	说明
1	空闲。
2	打开中。
3	已打开。
4	关闭中。
5	已关闭。

wifi.off('p2pStateChange')⁸⁺

off(type: "p2pStateChange", callback?: Callback<number>): void

取消注册P2P开关状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pStateChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pConnectionChange')⁸⁺

on(type: "p2pConnectionChange", callback: Callback<WifiP2pLinkedInfo>): void

注册P2P连接状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pConnectionChange"字符串。
callback	Callback<WifiP2pLinkedInfo>	是	状态改变回调函数。

wifi.off('p2pConnectionChange')⁸⁺

off(type: "p2pConnectionChange", callback?: Callback<WifiP2pLinkedInfo>): void

取消注册P2P连接状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pConnectionChange"字符串。
callback	Callback<WifiP2pLinkedInfo>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pDeviceChange')⁸⁺

on(type: "p2pDeviceChange", callback: Callback<WifiP2pDevice>): void

注册P2P设备状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pDeviceChange"字符串。
callback	Callback<WifiP2pDevice>	是	状态改变回调函数。

wifi.off('p2pDeviceChange')⁸⁺

off(type: "p2pDeviceChange", callback?: Callback<WifiP2pDevice>): void

取消注册P2P设备状态改变事件。

需要权限： ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pDeviceChange"字符串。
callback	Callback<WifiP2pDevice>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pPeerDeviceChange')⁸⁺

on(type: "p2pPeerDeviceChange", callback: Callback<WifiP2pDevice[]>): void

注册P2P对端设备状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pPeerDeviceChange"字符串。
callback	Callback<WifiP2pDevice[]>	是	状态改变回调函数。

wifi.off('p2pPeerDeviceChange')⁸⁺

off(type: "p2pPeerDeviceChange", callback?: Callback<WifiP2pDevice[]>): void

取消注册P2P对端设备状态改变事件。

需要权限： ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pPeerDeviceChange"字符串。
callback	Callback<WifiP2pDevice[]>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pPersistentGroupChange')⁸⁺

on(type: "p2pPersistentGroupChange", callback: Callback<void>): void

注册P2P永久组状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pPersistentGroupChange"字符串。
callback	Callback<void>	是	状态改变回调函数。

wifi.off('p2pPersistentGroupChange')⁸⁺

off(type: "p2pPersistentGroupChange", callback?: Callback<void>): void

取消注册P2P永久组状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pPersistentGroupChange"字符串。
callback	Callback<void>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pDiscoveryChange')⁸⁺

on(type: "p2pDiscoveryChange", callback: Callback<number>): void

注册发现设备状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pDiscoveryChange"字符串。
callback	Callback<number>	是	状态改变回调函数。

发现设备状态改变事件的枚举。

枚举值	说明
0	初始状态。
1	发现成功。

wifi.off('p2pDiscoveryChange')⁸⁺

off(type: "p2pDiscoveryChange", callback?: Callback<number>): void

取消注册发现设备状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数

参数名	类型	必填	说明
type	string	是	固定填"p2pDiscoveryChange"字符串。
callback	Callback<number>	否	状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

WLAN

导入模块

wifi.isWifiActive

wifi.scan

wifi.getScanInfos

wifi.getScanInfos

WifiScanInfo

WifiSecurityType

wifi.addUntrustedConfig7+

WifiDeviceConfig

wifi.addUntrustedConfig7+

wifi.removeUntrustedConfig7+

wifi.removeUntrustedConfig7+

wifi.getSignalLevel

wifi.getLinkedInfo

wifi.getLinkedInfo

WifiLinkedInfo

ConnState

wifi.isConnected7+

wifi.isFeatureSupported7+

wifi.getIpInfo7+

IpInfo7+

wifi.getCountryCode7+

wifi.getP2pLinkedInfo8+

wifi.getP2pLinkedInfo8+

WifiP2pLinkedInfo8+

P2pConnectState8+

wifi.getCurrentGroup8+

wifi.getCurrentGroup8+

WifiP2pGroupInfo8+

WifiP2pDevice8+

P2pDeviceStatus8+

wifi.getP2pPeerDevices8+

wifi.getP2pPeerDevices8+

wifi.createGroup8+

WifiP2PConfig8+

GroupOwnerBand8+

wifi.removeGroup8+

wifi.p2pConnect8+

wifi.p2pCancelConnect8+

wifi.startDiscoverDevices8+

wifi.stopDiscoverDevices8+

wifi.on('wifiStateChange')7+

wifi.off('wifiStateChange')7+

wifi.on('wifiConnectionChange')7+

wifi.off('wifiConnectionChange')7+

wifi.on('wifiScanStateChange')7+

wifi.off('wifiScanStateChange')7+

wifi.on('wifiRssiChange')7+

wifi.off('wifiRssiChange')7+

wifi.on('hotspotStateChange')7+

wifi.off('hotspotStateChange')7+

wifi.on('p2pStateChange')8+

wifi.off('p2pStateChange')8+

wifi.on('p2pConnectionChange')8+

wifi.off('p2pConnectionChange')8+

wifi.on('p2pDeviceChange')8+

wifi.off('p2pDeviceChange')8+

wifi.on('p2pPeerDeviceChange')8+

wifi.off('p2pPeerDeviceChange')8+

wifi.on('p2pPersistentGroupChange')8+

wifi.off('p2pPersistentGroupChange')8+

wifi.on('p2pDiscoveryChange')8+

wifi.off('p2pDiscoveryChange')8+

wifi.addUntrustedConfig⁷⁺

wifi.addUntrustedConfig⁷⁺

wifi.removeUntrustedConfig⁷⁺

wifi.removeUntrustedConfig⁷⁺

wifi.isConnected⁷⁺

wifi.isFeatureSupported⁷⁺

wifi.getIpInfo⁷⁺

IpInfo⁷⁺

wifi.getCountryCode⁷⁺

wifi.getP2pLinkedInfo⁸⁺

wifi.getP2pLinkedInfo⁸⁺

WifiP2pLinkedInfo⁸⁺

P2pConnectState⁸⁺

wifi.getCurrentGroup⁸⁺

wifi.getCurrentGroup⁸⁺

WifiP2pGroupInfo⁸⁺

WifiP2pDevice⁸⁺

P2pDeviceStatus⁸⁺

wifi.getP2pPeerDevices⁸⁺

wifi.getP2pPeerDevices⁸⁺

wifi.createGroup⁸⁺

WifiP2PConfig⁸⁺

GroupOwnerBand⁸⁺

wifi.removeGroup⁸⁺

wifi.p2pConnect⁸⁺

wifi.p2pCancelConnect⁸⁺

wifi.startDiscoverDevices⁸⁺

wifi.stopDiscoverDevices⁸⁺

wifi.on('wifiStateChange')⁷⁺

wifi.off('wifiStateChange')⁷⁺

wifi.on('wifiConnectionChange')⁷⁺

wifi.off('wifiConnectionChange')⁷⁺

wifi.on('wifiScanStateChange')⁷⁺

wifi.off('wifiScanStateChange')⁷⁺

wifi.on('wifiRssiChange')⁷⁺

wifi.off('wifiRssiChange')⁷⁺

wifi.on('hotspotStateChange')⁷⁺

wifi.off('hotspotStateChange')⁷⁺

wifi.on('p2pStateChange')⁸⁺

wifi.off('p2pStateChange')⁸⁺

wifi.on('p2pConnectionChange')⁸⁺

wifi.off('p2pConnectionChange')⁸⁺

wifi.on('p2pDeviceChange')⁸⁺

wifi.off('p2pDeviceChange')⁸⁺

wifi.on('p2pPeerDeviceChange')⁸⁺

wifi.off('p2pPeerDeviceChange')⁸⁺

wifi.on('p2pPersistentGroupChange')⁸⁺

wifi.off('p2pPersistentGroupChange')⁸⁺

wifi.on('p2pDiscoveryChange')⁸⁺

wifi.off('p2pDiscoveryChange')⁸⁺