WLAN

说明： 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]点击或者复制转到。

导入模块

import wifi from '@ohos.wifi';

wifi.isWifiAc tive

isWifiActive(): boolean

查询WLAN是否已激活。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
boolean true:已激活， false:未激活。

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

wifi.scan

scan(): boolean

启动WLAN扫描。

需要权限： ohos.permission.SET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
boolean true:扫描操作执行成功， false:扫描操作执行失败。

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

wifi.getScanInfos

getScanInfos(): Promise>

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

需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
Promise< Array<[WifiScanInfo]> > 返回扫描到的热点列表。

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

wifi.getScanInfos

getScanInfos(callback: AsyncCallback>): void

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

需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
callback AsyncCallback< Array<[WifiScanInfo]>> 是扫描到的热点列表结果回调函数。

参数名	类型	必填	说明
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.addUntrustedConfig7+

addUntrustedConfig(config: WifiDeviceConfig): Promise

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

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
config [WifiDeviceConfig] 是 WLAN配置信息。
返回值：
类型说明
Promise 操作结果，ture: 成功， false: 失败。

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

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

WifiDeviceConfig

WLAN配置信息。

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

wifi.addUntrustedConfig7+

addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback): void

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

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
config [WifiDeviceConfig] 是 WLAN配置信息。
callback AsyncCallback 是操作结果，ture: 成功， false: 失败。

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

wifi.removeUntrustedConfig7+

removeUntrustedConfig(config: WifiDeviceConfig): Promise

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

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
config [WifiDeviceConfig] 是 WLAN配置信息。
返回值：
类型说明
Promise 操作结果，ture: 成功， false: 失败。

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

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

wifi.removeUntrustedConfig7+

removeUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback): void

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

需要权限： ohos.permission.SET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
config [WifiDeviceConfig] 是 WLAN配置信息。
callback AsyncCallback 是操作结果，ture: 成功， false: 失败。

参数名	类型	必填	说明
config	[WifiDeviceConfig]	是	WLAN配置信息。
callback	AsyncCallback	是	操作结果，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]。

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

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

wifi.getLinkedInfo

getLinkedInfo(): Promise

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
Promise<[WifiLinkedInfo]> WLAN连接的相关信息。

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

wifi.getLinkedInfo

getLinkedInfo(callback: AsyncCallback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名类型必填说明
callback AsyncCallback<[WifiLinkedInfo]> 是 WLAN连接信息结果回调函数。

参数名	类型	必填	说明
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.isConnected7+

isConnected(): boolean

查询WLAN是否已连接。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
boolean true:已连接， false:未连接。

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

wifi.isFeatureSupported7+

isFeatureSupported(featureId: number): boolean

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.Core
参数：
参数名 类型必填说明
featureId number 是特性ID值。
返回值：
类型说明
boolean true:支持， false:不支持。

参数名	类型	必填	说明
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.getIpInfo7+

getIpInfo(): IpInfo

获取IP信息。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
返回值：
类型说明
[IpInfo] IP信息。

类型	说明
[IpInfo]	IP信息。

IpInfo7+

IP信息。

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

wifi.getCountryCode7+

getCountryCode(): string

获取国家码信息。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.Core
返回值：
类型说明
string 国家码。

类型	说明
string	国家码。

wifi.getP2pLinkedInfo8+

getP2pLinkedInfo(): Promise

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
Promise<[WifiP2pLinkedInfo]> P2P连接信息。

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

wifi.getP2pLinkedInfo8+

getP2pLinkedInfo(callback: AsyncCallback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名类型必填说明
callback AsyncCallback<[WifiP2pLinkedInfo]> 是 P2P连接信息结果回调函数。

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

WifiP2pLinkedInfo8+

提供WLAN连接的相关信息。

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

P2pConnectState8+

表示P2P连接状态的枚举。

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

wifi.getCurrentGroup8+

getCurrentGroup(): Promise

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
Promise<[WifiP2pGroupInfo]> 当前组信息。

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

wifi.getCurrentGroup8+

getCurrentGroup(callback: AsyncCallback): void

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名类型必填说明
callback AsyncCallback<[WifiP2pGroupInfo]> 是当前组信息的回调函数。

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

WifiP2pGroupInfo8+

表示P2P群组相关信息。

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

WifiP2pDevice8+

表示P2P设备信息。

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

P2pDeviceStatus8+

表示设备状态的枚举。

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

wifi.getP2pPeerDevices8+

getP2pPeerDevices(): Promise

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
Promise<[WifiP2pDevice[]]> 对端设备列表信息。

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

wifi.getP2pPeerDevices8+

getP2pPeerDevices(callback: AsyncCallback): void

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名类型必填说明
callback AsyncCallback<[WifiP2pDevice[]]> 是对端设备列表信息回调函数。

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

wifi.createGroup8+

createGroup(config: WifiP2PConfig): boolean;

创建群组。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数：
参数名 类型必填说明
config [WifiP2PConfig] 是群组配置信息。
返回值：
类型说明
boolean true:创建群组操作执行成功， false:创建群组操作执行失败。

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

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

WifiP2PConfig8+

表示P2P配置信息。

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

GroupOwnerBand8+

表示群组带宽的枚举。

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

wifi.removeGroup8+

removeGroup(): boolean;

移除群组。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
boolean true:操作执行成功， false:操作执行失败。

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

wifi.p2pConnect8+

p2pConnect(config: WifiP2PConfig): boolean;

执行P2P连接。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数：
参数名 类型必填说明
config [WifiP2PConfig] 是连接配置信息。
返回值：
类型说明
boolean true:操作执行成功， false:操作执行失败。

参数名	类型	必填	说明
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.p2pCancelConnect8+

p2pCancelConnect(): boolean;

取消P2P连接。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
boolean true:取消连接操作执行成功， false:取消连接操作执行失败。

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

wifi.startDiscoverDevices8+

startDiscoverDevices(): boolean;

开始发现设备。

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
boolean true:操作执行成功， false:操作执行失败。

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

wifi.stopDiscoverDevices8+

stopDiscoverDevices(): boolean;

停止发现设备。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
返回值：
类型说明
boolean true:操作执行成功，操作执行失败。

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

wifi.on('wifiStateChange')7+

on(type: "wifiStateChange", callback: Callback): void

注册WLAN状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiStateChange"字符串。
callback Callback 是状态改变回调函数。
状态改变事件的枚举。
枚举值 说明
0 未激活。
1 已激活。
2 激活中。
3 去激活中。

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

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

wifi.off('wifiStateChange')7+

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

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiStateChange"字符串。
callback Callback 否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

参数名	类型	必填	说明
type	string	是	固定填"wifiStateChange"字符串。
callback	Callback	否	状态改变回调函数。如果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')7+

on(type: "wifiConnectionChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiConnectionChange"字符串。
callback Callback 是状态改变回调函数。
连接状态改变事件的枚举。
枚举值 说明
0 已断开。
1 已连接。

wifi.off('wifiConnectionChange')7+

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

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

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

参数

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

wifi.on('wifiScanStateChange')7+

on(type: "wifiScanStateChange", callback: Callback): void

注册扫描状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiScanStateChange"字符串。
callback Callback 是状态改变回调函数。
扫描状态改变事件的枚举。
枚举值 说明
0 扫描失败。
1 扫描成功。

wifi.off('wifiScanStateChange')7+

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

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

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

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

wifi.on('wifiRssiChange')7+

on(type: "wifiRssiChange", callback: Callback): void

注册RSSI状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiRssiChange"字符串。
callback Callback 是状态改变回调函数，返回以dBm为单位的RSSI值。

wifi.off('wifiRssiChange')7+

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

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.STA
参数
参数名 类型必填说明
type string 是固定填"wifiRssiChange"字符串。
callback Callback 否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('hotspotStateChange')7+

on(type: "hotspotStateChange", callback: Callback): void

注册热点状态改变事件。

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.AP.Core
参数
参数名 类型必填说明
type string 是固定填"hotspotStateChange"字符串。
callback Callback 是状态改变回调函数。
热点状态改变事件的枚举。
枚举值 说明
0 未激活。
1 已激活。
2 激活中。
3 去激活中。

wifi.off('hotspotStateChange')7+

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

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

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

参数

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

wifi.on('p2pStateChange')8+

on(type: "p2pStateChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pStateChange"字符串。
callback Callback 是状态改变回调函数。
P2P状态改变事件的枚举。
枚举值 说明
1 空闲。
2 打开中。
3 已打开。
4 关闭中。
5 已关闭。

wifi.off('p2pStateChange')8+

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

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pStateChange"字符串。
callback Callback 否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。
wifi.on('p2pConnectionChange')8+

on(type: "p2pConnectionChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pConnectionChange"字符串。
callback Callback<[WifiP2pLinkedInfo]> 是状态改变回调函数。

wifi.off('p2pConnectionChange')8+

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

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

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

参数

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

wifi.on('p2pDeviceChange')8+

on(type: "p2pDeviceChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pDeviceChange"字符串。
callback Callback<[WifiP2pDevice]> 是状态改变回调函数。

wifi.off('p2pDeviceChange')8+

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

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

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

参数

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

wifi.on('p2pPeerDeviceChange')8+

on(type: "p2pPeerDeviceChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pPeerDeviceChange"字符串。
callback Callback<[WifiP2pDevice[]]> 是状态改变回调函数。

wifi.off('p2pPeerDeviceChange')8+

off(type: "p2pPeerDeviceChange", callback?: Callback): void

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

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

参数

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

wifi.on('p2pPersistentGroupChange')8+

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

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pPersistentGroupChange"字符串。
callback Callback 是状态改变回调函数。

wifi.off('p2pPersistentGroupChange')8+

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

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

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

参数

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

wifi.on('p2pDiscoveryChange')8+

on(type: "p2pDiscoveryChange", callback: Callback): void

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

需要权限： ohos.permission.GET_WIFI_INFO
系统能力： SystemCapability.Communication.WiFi.P2P
参数
参数名 类型必填说明
type string 是固定填"p2pDiscoveryChange"字符串。
callback Callback 是状态改变回调函数。
发现设备状态改变事件的枚举。
枚举值 说明
0 初始状态。
1 发现成功。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

wifi.off('p2pDiscoveryChange')8+

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

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

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

参数

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

声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。举报投诉

接口

接口

+关注

关注
33

文章
8467

浏览量
150757
API

API

+关注

关注
2

文章
1478

浏览量
61764
WIFI

WIFI

+关注

关注
81

文章
5283

浏览量
203148
鸿蒙

鸿蒙

+关注

关注
57

文章
2305

浏览量
42698

【钛极小龟开发套件试用体验】SmartConfig连接WiFi

连接到指定WiFi.Wi-Fi是一种允许电子设备连接到一个无线局域网（WLAN）的技术，通常使用2.4GUHF或5G SHF ISM 射频频段。连

发表于 11-08 16:10

【HiSpark系列】鸿蒙设备学习--开发

\codeMacOS系统：~/OHOS/codeLinux系统：~/OHOS/code具体的开发细节，可以查看：Wi-Fi IoT开发：第一个示例程序：通过AT指令让设备

发表于 11-03 14:28

wlan和wifi的区别

很多人在上网时就会发现家里用的电脑无线上网是WLAN，而手机或是平板电脑上网又叫WIFI。都是一样的无线上网，怎么会有二个不同的名字，那么wlan和wifi的意思是什么呢？

发表于 09-11 10:01 •5144次阅读

wlan和wifi的区别？ wlan与wifi无线上网知识

文章中为大家介绍了什么wifi无线上网，但大家可能会有这样的疑问，听说最多的应该是WLAN无线上网，很多笔记本电脑使用的都是WLAN无线上网，那么wlan和

发表于 03-07 11:53 •11次下载

wlan和wifi的区别和关系分析

不知道大家注意到手机中无线局域网的名称没有，有的叫WiFi，有的叫WLAN，那么WLAN和WiFi到底是什么关系呢?

发表于 11-03 07:56 •1.2w次阅读

WIFI和WLAN的主要区别

从包含关系上来说，WIFI是WLAN的一个标准，WIFI包含于WLAN中，属于回采用WLAN协议中的一项新技术。

发表于 05-28 11:13 •2120次阅读

WiFi和WLAN的区别_wlan和wifi的哪个好

平常所说的WiFi，其实就是无线网络，我们平时都会说是连WiFi，但是无论是手机还是电脑上，连接网络那一栏，总是会显示WLAN，而没有显示WiFi

发表于 06-18 11:13 •6008次阅读

WiFi和WLAN有什么不同?

11月26日消息，我们通常上网的时候会说连接WiFi，但如果细心留意会发现手机连接显示是WLAN，那么WiFi和

发表于 11-26 14:40 •4326次阅读

基于鸿蒙系统+Hi3861的WiFi小车开发

本文简单介绍鸿蒙系统 + Hi3861 的WiFi小车开发，适用于开发润和Hi3861开发板的小伙伴们。

发表于 03-03 09:31 •5571次阅读

简单区分WiFi通信和WLAN通信

使用手机时，如果细心一点可以发现，在iPhone手机里面，对于无线网络的称呼是WiFi，而大量的安卓手机对无线网络的称呼是WLAN，于是很多人都把WiFi等同于WLAN，其实二者是不同

发表于 04-10 18:05 •906次阅读

WiFi就是WLAN吗 wlan和wifi的异同点

定义不同：WLAN是指无线局域网，可以用于指任何本地区域网络，而WiFi是一种无线局域网技术，一般用于指IEEE 802.11标准。

发表于 06-13 18:58 •2455次阅读

wlan和wifi的区别安全哪个好

WLAN和WiFi是两个广泛用于无线通信的术语。WLAN即无线局域网，是指在局域网范围内使用无线通信技术进行数据传输的网络。

发表于 01-16 17:16 •1342次阅读

WLAN是什么网 wlan与wifi有什么区别

的灵活性和便捷性，以及更广泛的覆盖范围。 WLAN与WiFi是相关的概念，但并不完全相同。WiFi（Wireless Fidelity）是无线局域网的一种技术标准，它使用无线电波来实现设备之间的

发表于 01-22 14:48 •6143次阅读

鸿蒙实战开发：【WLAN使用】

在eTS中WLAN的基本使用，包括禁用和启用WLAN、WLAN扫描和获取扫描结果、WLAN状态监听、WiFi

发表于 03-07 15:36 •505次阅读

鸿蒙开发通信与连接：【@ohos.wifiext (WLAN)】

使能WLAN热点。

发表于 06-22 10:08 •433次阅读

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

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

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

枚举值	说明
0	初始状态。
1	发现成功。`HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿`

搜索历史

鸿蒙开发通信与连接：【@ohos.wifi (WLAN)】

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.isWifiAc tive