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

jf_46214456 2024-06-22 543

电子说

1.3w人已加入

描述

WLAN

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

导入模块

import wifi from '@ohos.wifi';

wifi.isWifiActive

isWifiActive(): boolean

查询WLAN是否已激活。

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

wifi.scan

scan(): boolean

启动WLAN扫描。

  • 需要权限： ohos.permission.SET_WIFI_INFO，ohos.permission.LOCATION
  • 系统能力： SystemCapability.Communication.WiFi.STA
  • 返回值：
    类型说明
    booleantrue:扫描操作执行成功， 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]> >返回扫描到的热点列表。

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

  • 参数

    参数名类型必填说明
    callbackAsyncCallback< 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热点信息。

参数名类型读写属性说明
ssidstring只读热点的SSID，编码格式为UTF-8。
bssidstring只读热点的BSSID。
capabilitiesstring只读热点能力。
securityType[WifiSecurityType]只读WLAN加密类型。
rssinumber只读热点的信号强度(dBm)。
bandnumber只读WLAN接入点的频段。
frequencynumber只读WLAN接入点的频率。
channelWidthnumber只读WLAN接入点的带宽。
timestampnumber只读时间戳。

WifiSecurityType

表示加密类型的枚举。

名称默认值说明
WIFI_SEC_TYPE_INVALID0无效加密类型。
WIFI_SEC_TYPE_OPEN1开放加密类型。
WIFI_SEC_TYPE_WEP2Wired Equivalent Privacy (WEP)加密类型。
WIFI_SEC_TYPE_PSK3Pre-shared key (PSK)加密类型。
WIFI_SEC_TYPE_SAE4Simultaneous 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: 失败。

WifiDeviceConfig

WLAN配置信息。

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

wifi.addUntrustedConfig7+

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

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

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

wifi.removeUntrustedConfig7+

removeUntrustedConfig(config: WifiDeviceConfig): Promise

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

  • 需要权限： ohos.permission.SET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数

    参数名类型必填说明
    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配置信息。
    callbackAsyncCallback是操作结果，ture: 成功， false: 失败。

wifi.getSignalLevel

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

查询WLAN信号强度。

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数：

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

  • 返回值：

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

wifi.getLinkedInfo

getLinkedInfo(): Promise

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

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

wifi.getLinkedInfo

getLinkedInfo(callback: AsyncCallback): void

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数

    参数名类型必填说明
    callbackAsyncCallback<[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连接的相关信息。

参数名类型读写属性说明
ssidstring只读热点的SSID，编码格式为UTF-8。
bssidstring只读热点的BSSID。
rssinumber只读热点的信号强度(dBm)。
bandnumber只读WLAN接入点的频段。
linkSpeednumber只读WLAN接入点的速度。
frequencynumber只读WLAN接入点的频率。
isHiddenboolean只读WLAN接入点是否是隐藏网络。
isRestrictedboolean只读WLAN接入点是否限制数据量。
macAddressstring只读设备的MAC地址。
ipAddressnumber只读WLAN连接的IP地址。
connState[ConnState]只读WLAN连接状态。

ConnState

表示WLAN连接状态的枚举。

名称默认值说明
SCANNING0设备正在搜索可用的AP。
CONNECTING1正在建立WLAN连接。
AUTHENTICATING2WLAN连接正在认证中。
OBTAINING_IPADDR3正在获取WLAN连接的IP地址。
CONNECTED4WLAN连接已建立。
DISCONNECTING5WLAN连接正在断开。
DISCONNECTED6WLAN连接已断开。
UNKNOWN7WLAN连接建立失败。

wifi.isConnected7+

isConnected(): boolean

查询WLAN是否已连接。

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

wifi.isFeatureSupported7+

isFeatureSupported(featureId: number): boolean

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.Core

  • 参数：

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

  • 返回值：

    类型说明
    booleantrue:支持， false:不支持。

  • 特性ID值枚举。

    枚举值说明
    0x0001基础结构模式特性。
    0x00025 GHz带宽特性。
    0x0004GAS/ANQP特性。
    0x0008Wifi-Direct特性。
    0x0010Soft AP特性。
    0x0040Wi-Fi AWare组网特性。
    0x8000AP STA共存特性。
    0x8000000WPA3-Personal SAE特性。
    0x10000000WPA3-Enterprise Suite-B
    0x20000000增强开放特性。

wifi.getIpInfo7+

getIpInfo(): IpInfo

获取IP信息。

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

IpInfo7+

IP信息。

参数名类型读写属性说明
ipAddressnumber只读IP地址。
gatewaynumber只读网关。
netmasknumber只读掩码。
primaryDnsnumber只读主DNS服务器IP地址。
secondDnsnumber只读备DNS服务器IP地址。
serverIpnumber只读DHCP服务端IP地址。
leaseDurationnumber只读IP地址租用时长。

wifi.getCountryCode7+

getCountryCode(): string

获取国家码信息。

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

wifi.getP2pLinkedInfo8+

getP2pLinkedInfo(): Promise

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

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

wifi.getP2pLinkedInfo8+

getP2pLinkedInfo(callback: AsyncCallback): void

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

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

WifiP2pLinkedInfo8+

提供WLAN连接的相关信息。

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

P2pConnectState8+

表示P2P连接状态的枚举。

名称默认值说明
DISCONNECTED0断开状态。
CONNECTED1连接状态。

wifi.getCurrentGroup8+

getCurrentGroup(): Promise

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

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

wifi.getCurrentGroup8+

getCurrentGroup(callback: AsyncCallback): void

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

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

WifiP2pGroupInfo8+

表示P2P群组相关信息。

参数名类型读写属性说明
isP2pGoboolean只读是否是群组。
ownerInfo[WifiP2pDevice]只读群组的设备信息。
passphrasestring只读群组密钥。
interfacestring只读接口名称。
groupNamestring只读群组名称。
networkIdnumber只读网络ID。
frequencynumber只读群组的频率。
clientDevices[WifiP2pDevice[]]只读接入的设备列表信息。
goIpAddressstring只读群组IP地址。

WifiP2pDevice8+

表示P2P设备信息。

参数名类型读写属性说明
deviceNamestring只读设备名称。
deviceAddressstring只读设备MAC地址。
primaryDeviceTypestring只读主设备类型。
deviceStatus[P2pDeviceStatus]只读设备状态。
groupCapabilitiesnumber只读群组能力。

P2pDeviceStatus8+

表示设备状态的枚举。

名称默认值说明
CONNECTED0连接状态。
INVITED1邀请状态。
FAILED2失败状态。
AVAILABLE3可用状态。
UNAVAILABLE4不可用状态。

wifi.getP2pPeerDevices8+

getP2pPeerDevices(): Promise

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

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

wifi.getP2pPeerDevices8+

getP2pPeerDevices(callback: AsyncCallback): void

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

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

wifi.createGroup8+

createGroup(config: WifiP2PConfig): boolean;

创建群组。

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.P2P

  • 参数：

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

  • 返回值：

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

WifiP2PConfig8+

表示P2P配置信息。

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

GroupOwnerBand8+

表示群组带宽的枚举。

名称默认值说明
GO_BAND_AUTO0自动模式。
GO_BAND_2GHZ12GHZ。
GO_BAND_5GHZ25GHZ。

wifi.removeGroup8+

removeGroup(): boolean;

移除群组。

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

wifi.p2pConnect8+

p2pConnect(config: WifiP2PConfig): boolean;

执行P2P连接。

  • 需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION

  • 系统能力： SystemCapability.Communication.WiFi.P2P

  • 参数：

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

  • 返回值：

    类型说明
    booleantrue:操作执行成功， 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
  • 返回值：
    类型说明
    booleantrue:取消连接操作执行成功， false:取消连接操作执行失败。

wifi.startDiscoverDevices8+

startDiscoverDevices(): boolean;

开始发现设备。

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

wifi.stopDiscoverDevices8+

stopDiscoverDevices(): boolean;

停止发现设备。

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

wifi.on('wifiStateChange')7+

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

注册WLAN状态改变事件。

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数

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

  • 状态改变事件的枚举。

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

wifi.off('wifiStateChange')7+

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

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数

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

  • 参数

    参数名类型必填说明
    typestring是固定填"wifiConnectionChange"字符串。
    callbackCallback是状态改变回调函数。

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

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

wifi.off('wifiConnectionChange')7+

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

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

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

wifi.on('wifiScanStateChange')7+

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

注册扫描状态改变事件。

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.STA

  • 参数

    参数名类型必填说明
    typestring是固定填"wifiScanStateChange"字符串。
    callbackCallback是状态改变回调函数。

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

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

wifi.off('wifiScanStateChange')7+

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

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

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

wifi.on('wifiRssiChange')7+

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

注册RSSI状态改变事件。

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

wifi.off('wifiRssiChange')7+

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

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

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

wifi.on('hotspotStateChange')7+

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

注册热点状态改变事件。

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.AP.Core

  • 参数

    参数名类型必填说明
    typestring是固定填"hotspotStateChange"字符串。
    callbackCallback是状态改变回调函数。

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

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

wifi.off('hotspotStateChange')7+

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

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

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

wifi.on('p2pStateChange')8+

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

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.P2P

  • 参数

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

  • 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

  • 参数

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

    wifi.on('p2pConnectionChange')8+

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

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

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

wifi.off('p2pConnectionChange')8+

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

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

  • 需要权限： ohos.permission.GET_WIFI_INFO
  • 系统能力： SystemCapability.Communication.WiFi.P2P
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pConnectionChange"字符串。
    callbackCallback<[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
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pDeviceChange"字符串。
    callbackCallback<[WifiP2pDevice]>是状态改变回调函数。

wifi.off('p2pDeviceChange')8+

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

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

  • 需要权限： ohos.permission.LOCATION
  • 系统能力： SystemCapability.Communication.WiFi.P2P
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pDeviceChange"字符串。
    callbackCallback<[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
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pPeerDeviceChange"字符串。
    callbackCallback<[WifiP2pDevice[]]>是状态改变回调函数。

wifi.off('p2pPeerDeviceChange')8+

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

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

  • 需要权限： ohos.permission.LOCATION
  • 系统能力： SystemCapability.Communication.WiFi.P2P
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pPeerDeviceChange"字符串。
    callbackCallback<[WifiP2pDevice[]]>否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。

wifi.on('p2pPersistentGroupChange')8+

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

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

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

wifi.off('p2pPersistentGroupChange')8+

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

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

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

wifi.on('p2pDiscoveryChange')8+

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

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

  • 系统能力： SystemCapability.Communication.WiFi.P2P

  • 参数

    参数名类型必填说明
    typestring是固定填"p2pDiscoveryChange"字符串。
    callbackCallback是状态改变回调函数。

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

    枚举值说明
    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
  • 参数
    参数名类型必填说明
    typestring是固定填"p2pDiscoveryChange"字符串。
    callbackCallback否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。
打开APP阅读更多精彩内容
声明：本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人，不代表电子发烧友网立场。文章及其配图仅供工程师学习之用，如有内容侵权或者其他违规问题，请联系本站处理。 举报投诉

全部0条评论

快来发表一下你的评论吧 !

下载APP
|投诉反馈|电子发烧友网
© 2021 elecfans.com
湘ICP备2023018690号
×
20
完善资料，
赚取积分