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

最新推荐文章于 2024-07-25 20:17:04 发布
最新推荐文章于 2024-07-25 20:17:04 发布
阅读量684 收藏 26
点赞数 25
分类专栏： 鸿蒙开发学习笔录 文章标签： harmonyos OpenHarmony 鸿蒙 鸿蒙开发 程序员 WLAN 通讯
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/139862789
版权

WLAN

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

导入模块

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<Array>

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

  • 需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。

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

  • 返回值：

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

wifi.getScanInfos

getScanInfos(callback: AsyncCallback<Array>): 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<WifiP2pDevice[]>

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

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

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

  • 返回值：

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

wifi.getP2pPeerDevices8+

getP2pPeerDevices(callback: AsyncCallback<WifiP2pDevice[]>): 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<WifiP2pDevice[]>): 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<WifiP2pDevice[]>): 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发现成功。

wifi.off(‘p2pDiscoveryChange’)8+

off(type: “p2pDiscoveryChange”, callback?: Callback): void

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

  • 需要权限： ohos.permission.GET_WIFI_INFO

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

  • 参数

    参数名类型必填说明
    typestring是固定填"p2pDiscoveryChange"字符串。
    callbackCallback否状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。
爱桥代码的程序媛
关注
  • 25
    点赞
  • 踩
  • 26
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
系统鸿蒙OS的基础,鸿蒙OS WLAN基础功能
weixin_33752006的博客
06-02 563
场景介绍应用或者其他模块可以通过接口完成以下功能：获取 WLAN 状态，查询 WLAN 是否打开。发起扫描并获取扫描结果。获取连接态详细信息，包括连接信息、IP信息等。获取设备国家码。获取设备是否支持指定的能力。接口说明WifiDevice 提供 WLAN 的基本功能，其接口说明如下。接口名描述所需权限getInstance(Contextcontext)获取WLAN功能管理对象实例，通过该实例...
Android---用Wi-Fi来建立对等连接
瞎猫碰到死耗子
04-08 1257
WiFi对等API（P2P）不需要连接到网络或热点（Android的WiFi P2P框架符合WiFi编程指导规范），就允许应用程序连接到附近的设备。WiFiP2P允许应用程序快速的查找附近的设备，并与其交互。在连接范围上超过了蓝牙的能力。 本文介绍如何使用WiFi P2P来查找和连接附近的设备。 建立应用程序权限 为了使用WiFi P2P，要在应用程序的清单文件中添加CHANGE
鸿蒙南向开发实战：轻量系统-运行（基于Hi3861开发板）
shudaoshanQAQ的博客
04-17 1127
使开发板实现联网功能
HarmonyOS 鸿蒙应用开发 (七、HTTP网络组件 axios 介绍及封装使用)
热门推荐
独行猫a 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS)
01-27 1万+
在HarmonyOS（OpenHarmony）中，@ohos/net.http 是官方提供的一个用于进行HTTP通信的基础模块。开发者可以利用这个模块发送和接收HTTP请求与响应，实现应用程序与服务器之间的数据交互。文档中心--HTTP数据请求。
JS实现华为账号授权服务，一键登录！
m0_58367536的博客
10-26 980
鸿蒙应用使用华为账号授权服务
鸿蒙开发通信与连接：【@ohos.wifiext (WLAN)】
2301_76813281的博客
06-21 749
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。该文档中的接口只供非通用类型产品使用，如路由器等，对于常规类型产品，不应该使用这些接口。
鸿蒙开发实战：【网络管理-Socket连接】
m0_62167422的博客
03-19 662
本示例主要演示了Socket在网络通信方面的应用，展示了Socket在两端设备的连接验证、聊天通信方面的应用。
华为手表开发：WATCH 3 Pro（13）websocket 请求数据到服务器
二等碗
04-11 1155
华为手表开发：WATCH 3 Pro（13）websocket 请求数据到服务器，鸿蒙开发 socket，这里 核心代码，不一定必须放置在 app.js ，我这边是为了让项目更好理解。弄完上面的代码，就是手表端的全部了，如果要测试连接，还差一个服务端，可以看java专区的文章：Java WebSocket Demo ，案例手把手教学 记录（11）ws://127.0.0.1:6088 ： 这个是websocket 的服务端地址，记得更换到自己使用的地址。
鸿蒙（HarmonyOS）性能优化实战-合理使用IPC通信
maniuT的博客
04-24 977
合理使用IPC通信对于优化应用程序性能至关重要。通过场景分析、逻辑优化和合理的权衡，可以确保IPC通信不成为应用性能的瓶颈，从而提供更出色的用户体验。
C#使用wlanapi.dll主动扫描周边wifi并连接。
11-13
总的来说，使用`wlanapi.dll`与C#结合，可以让你的应用程序具备主动扫描和连接WiFi网络的能力，这对于开发网络管理工具或者物联网设备的通信控制具有重要意义。尽管这需要对Win32 API有一定的理解和实践，但通过学习...
通信与网络中的wlan和wifi的区别
10-21
很多人在上网时就会发现家里用的电脑无线上网是WLAN,而手机或是平板电脑上网又叫WIFI.都是一样的无线上网，怎么会有二个不同的名字，那么wlan和wifi的意思是什么呢？wlan和wifi的的区别又在那里？下面我们就介绍一下...
数据通信与计算机网络实验：WLAN的建立.docx
10-29
数据通信与计算机网络是信息技术领域的核心组成部分，它们涉及如何在不同设备之间有效地传输和交换信息。本实验专注于无线局域网络（WLAN）的构建，这是计算机网络中的一个重要子领域，特别是随着移动设备的普及，...
华为鸿蒙HarmonyOS开发者资料大全鸿蒙系统开发资料汇总.zip
06-16
鸿蒙HarmonyOS开发者资料大全鸿蒙系统开发资料汇总,包括如下： DevEco Studio 1.0 使用指南.pdf HarmonyOS-NFC开发指南.pdf HarmonyOS应用开发之页面开发.pdf HarmonyOS开发必备基础知识.pdf WLAN开发指南.pdf 图像...
CCK 11Mbps 的编码表：按照 802.11 WLAN 标准的规定，生成 CCK 11Mbps 编码表的 Matlab 代码-matlab开发
06-01
该例程生成 CCK 11Mbps... 用于生成 802.11 WLAN 标准中指定的 CCK 11Mbps 编码表的 Matlab 代码 代码非常简单。 希望你觉得它很有用。 如果您需要任何其他信息，请给我发邮件。 邮箱：Kiran.Chandrashekhar@gmail.com
鸿蒙界面开发
qq_46025779的博客
07-23 1472
界面开发界面开发-布局思路属性方法字体颜色文字溢出省略号、行高Image图片组件输入框与按钮综合实训设计资源-svg图标欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题，有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段漂亮的代码片生成一个适合你的列表创建一个表格设定内容居中、居左、居右创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能，丰富你的文章UML 图表FLowchart流程图导出与导入导出导入MarkdownText-to-HTML。
【HarmonyOS】应用推送使用个推SDK如何实现？
最新发布
我的小窝
07-25 663
鸿蒙应用如何使用个推SDK实现推送功能？
HarmonyOS鸿蒙应用开发-ZRouter让系统路由表变得更简单
学习，思考，输出
07-22 707
ZRouter是基于Navigation系统路由表和Hvigor插件实现的动态路由方案。系统路由表是API 12起开始支持的，可以帮助我们实现动态路由的功能，其目的是为了解决多个业务模块（HAR/HSP）之间解耦问题，从而实现业务的复用和功能的扩展。首先在目标模块中的module.json5文件中配置路由表文件route_map.json的指引；然后在resources/base/profile目录下创建route_map.json文件，用于配置每个页面路由的信息；
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值