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

文章
8682

瀏覽量
151613
API

API

+關注

關注
2

文章
1509

瀏覽量
62246
WIFI

WIFI

+關注

關注
81

文章
5306

瀏覽量
204338
鴻蒙

鴻蒙

+關注

關注
57

文章
2386

瀏覽量
42957

【鈦極小龜開發套件試用體驗】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 ?5178次閱讀

wlan和wifi的區別？ wlan與wifi無線上網知識

文章中為大家介紹了什么wifi無線上網，但大家可能會有這樣的疑問，聽說最多的應該是WLAN無線上網，很多筆記本電腦使用的都是WLAN無線上網，那么wlan和

發表于 03-07 11:53 ?11次下載

wlan和wifi的區別和關系分析

不知道大家注意到手機中無線局域網的名稱沒有，有的叫WiFi，有的叫WLAN，那么WLAN和WiFi到底是什么關系呢?

發表于 11-03 07:56 ?1.3w次閱讀

WIFI和WLAN的主要區別

從包含關系上來說，WIFI是WLAN的一個標準，WIFI包含于WLAN中，屬于回采用WLAN協議中的一項新技術。

發表于 05-28 11:13 ?2178次閱讀

WiFi和WLAN的區別_wlan和wifi的哪個好

平常所說的WiFi，其實就是無線網絡，我們平時都會說是連WiFi，但是無論是手機還是電腦上，連接網絡那一欄，總是會顯示WLAN，而沒有顯示WiFi

發表于 06-18 11:13 ?6164次閱讀

WiFi和WLAN有什么不同?

11月26日消息，我們通常上網的時候會說連接WiFi，但如果細心留意會發現手機連接顯示是WLAN，那么WiFi和

發表于 11-26 14:40 ?4448次閱讀

基于鴻蒙系統+Hi3861的WiFi小車開發

本文簡單介紹鴻蒙系統 + Hi3861 的WiFi小車開發，適用于開發潤和Hi3861開發板的小伙伴們。

發表于 03-03 09:31 ?5779次閱讀

簡單區分WiFi通信和WLAN通信

使用手機時，如果細心一點可以發現，在iPhone手機里面，對于無線網絡的稱呼是WiFi，而大量的安卓手機對無線網絡的稱呼是WLAN，于是很多人都把WiFi等同于WLAN，其實二者是不同

發表于 04-10 18:05 ?976次閱讀

WiFi就是WLAN嗎 wlan和wifi的異同點

定義不同：WLAN是指無線局域網，可以用于指任何本地區域網絡，而WiFi是一種無線局域網技術，一般用于指IEEE 802.11標準。

發表于 06-13 18:58 ?2724次閱讀

wlan和wifi的區別安全哪個好

WLAN和WiFi是兩個廣泛用于無線通信的術語。WLAN即無線局域網，是指在局域網范圍內使用無線通信技術進行數據傳輸的網絡。

發表于 01-16 17:16 ?1590次閱讀

WLAN是什么網 wlan與wifi有什么區別

的靈活性和便捷性，以及更廣泛的覆蓋范圍。 WLAN與WiFi是相關的概念，但并不完全相同。WiFi（Wireless Fidelity）是無線局域網的一種技術標準，它使用無線電波來實現設備之間的

發表于 01-22 14:48 ?6481次閱讀

鴻蒙實戰開發：【WLAN使用】

在eTS中WLAN的基本使用，包括禁用和啟用WLAN、WLAN掃描和獲取掃描結果、WLAN狀態監聽、WiFi

發表于 03-07 15:36 ?651次閱讀

鴻蒙開發通信與連接：【@ohos.wifiext (WLAN)】

使能WLAN熱點。

發表于 06-22 10:08 ?551次閱讀

參數名	類型	必填	說明
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