WLAN

導入模塊

import wifiManager from '@ohos.wifiManager';

wifi.isWifiActive9+

isWifiActive(): boolean

查詢WLAN是否已使能。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.scan9+

scan(): void

啟動WLAN掃描。

需要權限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.getScanResults9+

getScanResults(): Promise<Array<WifiScanInfo>>

獲取掃描結(jié)果，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或 ohos.permission.LOCATION)

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.getScanResults9+

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

獲取掃描結(jié)果，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或 ohos.permission.LOCATION)

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

示例：

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);
    }
});

WifiScanInfo9+

WLAN熱點信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

WifiSecurityType9+

表示加密類型的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.Core

WifiInfoElem9+

WLAN熱點信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

WifiChannelWidth9+

表示帶寬類型的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

wifi.getScanResultsSync9+

getScanResultsSync(): Array<WifiScanInfo>

獲取掃描結(jié)果，使用同步方式返回結(jié)果。

需要權限： ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或 ohos.permission.LOCATION)

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

WifiDeviceConfig9+

WLAN配置信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

wifi.addCandidateConfig9+

addCandidateConfig(config: WifiDeviceConfig): Promise<number>

添加候選網(wǎng)絡配置，使用Promise異步回調(diào)。

需要權限： ohos.permission.SET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

返回值：

wifi.addCandidateConfig9+

addCandidateConfig(config: WifiDeviceConfig, callback: AsyncCallback<number>): void

添加候選網(wǎng)絡配置，使用callback異步回調(diào)。

需要權限： ohos.permission.SET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.removeCandidateConfig9+

removeCandidateConfig(networkId: number): Promise<void>

移除候選網(wǎng)絡配置，使用Promise異步回調(diào)。

需要權限： ohos.permission.SET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

返回值：

wifi.removeCandidateConfig9+

removeCandidateConfig(networkId: number, callback: AsyncCallback<void>): void

移除候選網(wǎng)絡配置，使用callback異步回調(diào)。

需要權限： ohos.permission.SET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.getCandidateConfigs9+

getCandidateConfigs(): Array<WifiDeviceConfig>

獲取候選網(wǎng)絡配置。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.connectToCandidateConfig9+

connectToCandidateConfig(networkId: number): void

連接到候選網(wǎng)絡。

需要權限： ohos.permission.SET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.getSignalLevel9+

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

查詢WLAN信號強度。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

返回值：

wifi.getLinkedInfo9+

getLinkedInfo(): Promise<WifiLinkedInfo>

獲取WLAN連接信息，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.getLinkedInfo9+

getLinkedInfo(callback: AsyncCallback<WifiLinkedInfo>): void

獲取WLAN連接信息，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

示例：

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");
});

WifiLinkedInfo9+

提供WLAN連接的相關信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

ConnState9+

表示W(wǎng)LAN連接狀態(tài)的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

wifi.isConnected9+

isConnected(): boolean

查詢WLAN是否已連接。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

wifi.isFeatureSupported9+

isFeatureSupported(featureId: number): boolean

判斷設備是否支持相關WLAN特性。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.Core

參數(shù)：

返回值：

wifi.getIpInfo9+

getIpInfo(): IpInfo

獲取IP信息。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

返回值：

IpInfo9+

IP信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

wifi.getCountryCode9+

getCountryCode(): string

獲取國家碼信息。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.Core

返回值：

wifi.getP2pLinkedInfo9+

getP2pLinkedInfo(): Promise<WifiP2pLinkedInfo>

獲取P2P連接信息，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

WifiP2pLinkedInfo9+

提供WLAN連接的相關信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

P2pConnectState9+

表示P2P連接狀態(tài)的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

wifi.getP2pLinkedInfo9+

getP2pLinkedInfo(callback: AsyncCallback<WifiP2pLinkedInfo>): void

獲取P2P連接信息，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.getCurrentGroup9+

getCurrentGroup(): Promise<WifiP2pGroupInfo>

獲取P2P當前組信息，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.getCurrentGroup9+

getCurrentGroup(callback: AsyncCallback<WifiP2pGroupInfo>): void

獲取P2P當前組信息，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.getP2pPeerDevices9+

getP2pPeerDevices(): Promise<WifiP2pDevice[]>

獲取P2P對端設備列表信息，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.getP2pPeerDevices9+

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

獲取P2P對端設備列表信息，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

WifiP2pDevice9+

表示P2P設備信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

P2pDeviceStatus9+

表示設備狀態(tài)的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

wifi.getP2pLocalDevice9+

getP2pLocalDevice(): Promise<WifiP2pDevice>

獲取P2P本端設備信息，使用Promise異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.getP2pLocalDevice9+

getP2pLocalDevice(callback: AsyncCallback<WifiP2pDevice>): void

獲取P2P本端設備信息，使用callback異步回調(diào)。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.createGroup9+

createGroup(config: WifiP2PConfig): void

創(chuàng)建群組。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

返回值：

WifiP2PConfig9+

表示P2P配置信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

GroupOwnerBand9+

表示群組帶寬的枚舉。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

wifi.removeGroup9+

removeGroup(): void

移除群組。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.p2pConnect9+

p2pConnect(config: WifiP2PConfig): void

執(zhí)行P2P連接。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

返回值：

示例：

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 = () => {
    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.p2pCancelConnect9+

p2pCancelConnect(): void

取消P2P連接。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.startDiscoverDevices9+

startDiscoverDevices(): void

開始發(fā)現(xiàn)設備。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

wifi.stopDiscoverDevices9+

stopDiscoverDevices(): void

停止發(fā)現(xiàn)設備。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

返回值：

WifiP2pGroupInfo9+

表示P2P群組相關信息。

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

wifi.on('wifiStateChange')9+

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

注冊WLAN狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

狀態(tài)改變事件的枚舉：

wifi.off('wifiStateChange')9+

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

取消注冊WLAN狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

示例：

import wifi from '@ohos.wifi';

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

// Register event
wifi.on("wifiStateChange", recvPowerNotifyFunc);

// Unregister event
wifi.off("wifiStateChange", recvPowerNotifyFunc);

wifi.on('wifiConnectionChange')9+

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

注冊WLAN連接狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

連接狀態(tài)改變事件的枚舉：

wifi.off('wifiConnectionChange')9+

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

取消注冊WLAN連接狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.on('wifiScanStateChange')9+

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

注冊掃描狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

掃描狀態(tài)改變事件的枚舉：

wifi.off('wifiScanStateChange')9+

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

取消注冊掃描狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.on('wifiRssiChange')9+

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

注冊RSSI狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.off('wifiRssiChange')9+

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

取消注冊RSSI狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.STA

參數(shù)：

wifi.on('hotspotStateChange')9+

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

注冊熱點狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.AP.Core

參數(shù)：

熱點狀態(tài)改變事件的枚舉：

wifi.off('hotspotStateChange')9+

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

取消注冊熱點狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.AP.Core

參數(shù)：

wifi.on('p2pStateChange')9+

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

注冊P2P開關狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

P2P狀態(tài)改變事件的枚舉：

wifi.off('p2pStateChange')9+

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

取消注冊P2P開關狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.on('p2pConnectionChange')9+

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

注冊P2P連接狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.off('p2pConnectionChange')9+

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

取消注冊P2P連接狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.on('p2pDeviceChange')9+

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

注冊P2P設備狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.off('p2pDeviceChange')9+

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

取消注冊P2P設備狀態(tài)改變事件。

需要權限： ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.on('p2pPeerDeviceChange')9+

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

注冊P2P對端設備狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.off('p2pPeerDeviceChange')9+

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

取消注冊P2P對端設備狀態(tài)改變事件。

需要權限： ohos.permission.LOCATION

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.on('p2pPersistentGroupChange')9+

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

注冊P2P永久組狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.off('p2pPersistentGroupChange')9+

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

取消注冊P2P永久組狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

wifi.on('p2pDiscoveryChange')9+

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

注冊發(fā)現(xiàn)設備狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：

發(fā)現(xiàn)設備狀態(tài)改變事件的枚舉：

wifi.off('p2pDiscoveryChange')9+

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

取消注冊發(fā)現(xiàn)設備狀態(tài)改變事件。

需要權限： ohos.permission.GET_WIFI_INFO

系統(tǒng)能力： SystemCapability.Communication.WiFi.P2P

參數(shù)：