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

news2024/11/24 1:17:10

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)。
    bandnumberWLAN接入点的频段。
  • 返回值:

    类型说明
    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不填,将去注册该事件关联的所有回调函数。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/1846396.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

java基于ssm+jsp KTV点歌系统

1管理员功能模块 管理员登录&#xff0c;通过填写注册时输入的用户名、密码进行登录&#xff0c;如图1所示。 图1管理员登录界面图 管理员登录进入KTV点歌系统可以查看个人中心、用户管理、歌曲库管理、歌曲类型管理、点歌信息管理等信息。 修改密码&#xff0c;在修改密码页…

【数据分享】《中国改革年鉴》1989-2022

最近老有同学过来询问《中国经济体制改革年鉴》、《中国改革年鉴》这两本数据的关系以及怎么获取这两本本数据。今天就在这里给大家分享一下这三本数据的具体情况。 《中国改革年鉴》由国家发展和改革委员会主管,中国经济体制改革研究会主办,中国经济体制改革杂志社编辑出版,是…

iOS开发工具-网络封包分析工具Charles

一、Charles简介 Charles 是在 Mac 下常用的网络封包截取工具&#xff0c;在做 移动开发时&#xff0c;我们为了调试与服务器端的网络通讯协议&#xff0c;常常需要截取网络封包来分析。 Charles 通过将自己设置成系统的网络访问代理服务器&#xff0c;使得所有的网络访问请求…

Lighthouse浮游菌采样器AC100H及操作使用介绍-中邦兴业

Lighthouse浮游菌采样器AC100H介绍 Lighthouse浮游菌采样器AC100是一款高性能的便携式浮游菌采样器&#xff0c;专为洁净室和无菌环境设计。它基于先进的光学技术和安德森撞击原理&#xff0c;实现了对微小浮游菌的高效采集。采样器内置了HEPA高效过滤器&#xff0c;能够过滤掉…

泽众云真机-平台即将升级支持华为机型HarmonyOS NEXT系统

具小编了解&#xff0c;泽众云真机即将升级支持华为机型HarmonyOS NEXT系统。有些人可能对HarmonyOS NEXT系统了解不多。 之前我们有个银行项目&#xff0c;客户要求测试华为HarmonyOS NEXT系统环境&#xff0c;当时我们云真机尚未有该系统的机型&#xff0c;然后技术人员向华为…

React的服务器端渲染(SSR)和客户端渲染(CSR)有什么区别?

React的服务器端渲染&#xff08;SSR&#xff09;和客户端渲染&#xff08;CSR&#xff09;是两种不同的页面渲染方式&#xff0c;它们各自有不同的特点和适用场景&#xff1a; 服务器端渲染&#xff08;SSR&#xff09; 页面渲染: 页面在服务器上生成&#xff0c;然后将完整的…

如何最简单的方式使用nodejs中的http-server发布轻量级的html网页

1、查看nodejs是否安装。 node 2、设置环境路径。 3、使用npm install http-server -g安装http-server >npm install http-server -g 5、启动http-server服务,查看是否正确安装。 http-server 6、查看是否能够正常运行。 5、创建文件夹&#xff0c;复制html、css、js、in…

使用Rsbuild构建基于Vue3+Vant4开发h5应用

一、介绍 1.1 Vant介绍 Vant 是一个轻量、可定制的移动端组件库&#xff0c;于 2017 年开源。 目前 Vant 官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本&#xff0c;并由社区团队维护 React 版本和支付宝小程序版本。 使用文档&#xff1a;快速上手 - Vant 4 (vant-u…

35、正则表达式

一、正则表达式命令 正则表达式&#xff1a;匹配的是文本内容&#xff0c;linux的文本三剑客都是针对文本内容。 ​ grep 过滤文本内容 ​ sed 针对文本内容进行增删改查 ​ awk 按行取列 文本三剑客----都是按照行进行匹配。 1.1、grep筛选&#xff1a; grep的作用就是…

Swift Combine — zip和combineLatest的理解与使用

Publisher 上还有一些其他的操作&#xff0c;比如 zip 和 combineLatest&#xff0c;能让我们在时序上对控制多个 Publisher 的结果进行类似 and 和 or 的合并&#xff0c;它们在构建复杂 Publisher 逻辑时也十分有用。 zip Publisher 中的 zip 和 Sequence 的 zip 相类似&am…

VERYCLOUD睿鸿股份亮相亚马逊云科技中国峰会2024

5月30日&#xff0c;为期两天的亚马逊云科技中国峰会在上海世博中心圆满落幕。 多位大咖现场分享&#xff0c;生成式AI时代的数据战略&#xff0c;企业级AI应用&#xff0c;最新技术、产品重磅发布&#xff0c;创新行业解决方案 …… 作为亚马逊云科技的生态合作伙伴&#x…

Docker:认识Docker Host/Container/none网络

文章目录 Docker Host网络认识Docker Host网络实际操作网络模式区别使用场景 Docker Container网络认识Docker Container网络操作实例使用场景 Docker None网络使用场景 Docker Host网络 认识Docker Host网络 Docker容器运行默认会分配独立的Network Namespace隔离子系统&…

计算机网络 交换机的安全配置

一、理论知识 1.交换机端口安全功能介绍 交换机端口安全功能是针对交换机端口进行安全属性的配置&#xff0c;以控制用户的安全接入。主要包括以下两种配置项&#xff1a; ①限制交换机端口的最大连接数&#xff1a;控制交换机端口连接的主机数量&#xff1b;防止用户进行恶…

微信小程序笔记 四!

协同工作和发布 - 协同工作 1. 了解权限管理需求 在中大型的公司里&#xff0c;人员的分工非常仔细&#xff1a;同一个小程序项目&#xff0c;一般会有不同岗位、不同角色的员工同时参与设计与开发。 此时出于管理需要&#xff0c;我们迫切需要对不同岗位、不同角色的员工的…

游戏录屏软件,游戏录屏,3款软件推荐

“最近迷上了电脑游戏&#xff0c;想把自己在游戏中的精彩瞬间给记录下来。看到网上其他人录制的游戏都十分高清且有趣。想问问大家都是用什么软件进行游戏录屏的&#xff1f;有推荐的软件吗&#xff1f;” 在游戏生活中&#xff0c;相信你也一定想要记录下和队友在游戏中的欢…

应用篇| 深入浅出LLM应用之RAG

相信很多人都使用过LLM大模型&#xff0c;但是现有大模型或多或少都有以下问题&#xff1a; LLM幻觉问题&#xff1a;从《【小白入门篇1】GPT到底是怎样练成&#xff1f;》我们知道虽然大模型现在能力很强,但是本质就是在做文字接龙,而且每次接龙都具有随机性, 导致模型有时候…

工商业光伏项目怎么做?

随着全球对可再生能源的关注度不断提高&#xff0c;工商业光伏项目已成为企业实现绿色转型、降低能耗成本的重要途径。本文将详细介绍工商业光伏项目的开发流程&#xff0c;以及项目实施过程中需要注意的关键点。 一、项目前期准备 在启动工商业光伏项目之前&#xff0c;首先要…

windows下的 GammaRay安装和使用教程

GammaRay功能&#xff1a; 可用于查看运行时的程序对象状态信息以及事件队列 安装步骤&#xff1a; 1.官网下载地址&#xff1a; GammaRay下载地址 下载对应的qt版本适配版本 2.解压包gammaray-2.11.2.zip 解压后新建一个build目录为接下来的编译做准备 3.打开Install.txt 看…

【自组网数据链电台】测试软件

版本1 版本2 版本3 版本4 版本5 版本6 版本7

苹果cms10影视网整站源码下载/苹果cms模板MXone Pro自适应影视电影网站模板

下载地址&#xff1a;苹果cms10影视网整站源码下载/苹果cms模板MXone Pro自适应影视电影网站模板 模板带有夜间模式、白天晚上自动切换&#xff0c;有观影记录、后台设置页。全新UI全新框架&#xff0c;加载响应速度更快&#xff0c;seo更好&#xff0c;去除多余页面优化代码。…