WLAN
说明: 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import wifi from '@ohos.wifi';
wifi.isWifiActive
isWifiActive(): boolean
查询WLAN是否已激活。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
返回值:
类型 说明 boolean true:已激活, false:未激活。
wifi.scan
scan(): boolean
启动WLAN扫描。
-
需要权限: ohos.permission.SET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.STA
-
返回值:
类型 说明 boolean true:扫描操作执行成功, 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
-
参数
参数名 类型 必填 说明 callback AsyncCallback< Array<[WifiScanInfo]>> 是 扫描到的热点列表结果回调函数。 -
示例
import wifi from '@ohos.wifi'; wifi.getScanInfos((err, result) => { if (err) { console.error("get scan info error"); return; } var len = Object.keys(result).length; console.log("wifi received scan info: " + len); for (var i = 0; i < len; ++i) { console.info("ssid: " + result[i].ssid); console.info("bssid: " + result[i].bssid); console.info("capabilities: " + result[i].capabilities); console.info("securityType: " + result[i].securityType); console.info("rssi: " + result[i].rssi); console.info("band: " + result[i].band); console.info("frequency: " + result[i].frequency); console.info("channelWidth: " + result[i].channelWidth); console.info("timestamp: " + result[i].timestamp); } }); wifi.getScanInfos().then(result => { var len = Object.keys(result).length; console.log("wifi received scan info: " + len); for (var i = 0; i < len; ++i) { console.info("ssid: " + result[i].ssid); console.info("bssid: " + result[i].bssid); console.info("capabilities: " + result[i].capabilities); console.info("securityType: " + result[i].securityType); console.info("rssi: " + result[i].rssi); console.info("band: " + result[i].band); console.info("frequency: " + result[i].frequency); console.info("channelWidth: " + result[i].channelWidth); console.info("timestamp: " + result[i].timestamp); } });
WifiScanInfo
WLAN热点信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
ssid | string | 只读 | 热点的SSID,编码格式为UTF-8。 |
bssid | string | 只读 | 热点的BSSID。 |
capabilities | string | 只读 | 热点能力。 |
securityType | [WifiSecurityType] | 只读 | WLAN加密类型。 |
rssi | number | 只读 | 热点的信号强度(dBm)。 |
band | number | 只读 | WLAN接入点的频段。 |
frequency | number | 只读 | WLAN接入点的频率。 |
channelWidth | number | 只读 | WLAN接入点的带宽。 |
timestamp | number | 只读 | 时间戳。 |
WifiSecurityType
表示加密类型的枚举。
名称 | 默认值 | 说明 |
---|---|---|
WIFI_SEC_TYPE_INVALID | 0 | 无效加密类型。 |
WIFI_SEC_TYPE_OPEN | 1 | 开放加密类型。 |
WIFI_SEC_TYPE_WEP | 2 | Wired Equivalent Privacy (WEP)加密类型。 |
WIFI_SEC_TYPE_PSK | 3 | Pre-shared key (PSK)加密类型。 |
WIFI_SEC_TYPE_SAE | 4 | Simultaneous Authentication of Equals (SAE)加密类型。 |
wifi.addUntrustedConfig7+
addUntrustedConfig(config: WifiDeviceConfig): Promise
添加不可信网络配置,使用promise方式作为异步方法。
-
需要权限: ohos.permission.SET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 config [WifiDeviceConfig] 是 WLAN配置信息。 -
返回值:
类型 说明 Promise 操作结果,ture: 成功, false: 失败。
WifiDeviceConfig
WLAN配置信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
ssid | string | 只读 | 热点的SSID,编码格式为UTF-8。 |
bssid | string | 只读 | 热点的BSSID。 |
preSharedKey | string | 只读 | 热点的密钥。 |
isHiddenSsid | boolean | 只读 | 是否是隐藏网络。 |
securityType | [WifiSecurityType] | 只读 | 加密类型。 |
wifi.addUntrustedConfig7+
addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback): void
添加不可信网络配置,使用callback方式作为异步方法。
-
需要权限: ohos.permission.SET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 config [WifiDeviceConfig] 是 WLAN配置信息。 callback AsyncCallback 是 操作结果,ture: 成功, false: 失败。
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配置信息。 callback AsyncCallback 是 操作结果,ture: 成功, false: 失败。
wifi.getSignalLevel
getSignalLevel(rssi: number, band: number): number
查询WLAN信号强度。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数:
参数名 类型 必填 说明 rssi number 是 热点的信号强度(dBm)。 band number 是 WLAN接入点的频段。 -
返回值:
类型 说明 number 信号强度,取值范围为[0, 4]。
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
-
参数
参数名 类型 必填 说明 callback AsyncCallback<[WifiLinkedInfo]> 是 WLAN连接信息结果回调函数。 -
示例
import wifi from '@ohos.wifi'; wifi.getLinkedInfo((err, data) => { if (err) { console.error("get linked info error"); return; } console.info("get wifi linked info: " + JSON.stringify(data)); }); wifi.getLinkedInfo().then(data => { console.info("get wifi linked info: " + JSON.stringify(data)); }).catch(error => { console.info("get linked info error"); });
WifiLinkedInfo
提供WLAN连接的相关信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
ssid | string | 只读 | 热点的SSID,编码格式为UTF-8。 |
bssid | string | 只读 | 热点的BSSID。 |
rssi | number | 只读 | 热点的信号强度(dBm)。 |
band | number | 只读 | WLAN接入点的频段。 |
linkSpeed | number | 只读 | WLAN接入点的速度。 |
frequency | number | 只读 | WLAN接入点的频率。 |
isHidden | boolean | 只读 | WLAN接入点是否是隐藏网络。 |
isRestricted | boolean | 只读 | WLAN接入点是否限制数据量。 |
macAddress | string | 只读 | 设备的MAC地址。 |
ipAddress | number | 只读 | WLAN连接的IP地址。 |
connState | [ConnState] | 只读 | WLAN连接状态。 |
ConnState
表示WLAN连接状态的枚举。
名称 | 默认值 | 说明 |
---|---|---|
SCANNING | 0 | 设备正在搜索可用的AP。 |
CONNECTING | 1 | 正在建立WLAN连接。 |
AUTHENTICATING | 2 | WLAN连接正在认证中。 |
OBTAINING_IPADDR | 3 | 正在获取WLAN连接的IP地址。 |
CONNECTED | 4 | WLAN连接已建立。 |
DISCONNECTING | 5 | WLAN连接正在断开。 |
DISCONNECTED | 6 | WLAN连接已断开。 |
UNKNOWN | 7 | WLAN连接建立失败。 |
wifi.isConnected7+
isConnected(): boolean
查询WLAN是否已连接。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
返回值:
类型 说明 boolean true:已连接, false:未连接。
wifi.isFeatureSupported7+
isFeatureSupported(featureId: number): boolean
判断设备是否支持相关WLAN特性。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.Core
-
参数:
参数名 类型 必填 说明 featureId number 是 特性ID值。 -
返回值:
类型 说明 boolean true:支持, false:不支持。 -
特性ID值枚举。
枚举值 说明 0x0001 基础结构模式特性。 0x0002 5 GHz带宽特性。 0x0004 GAS/ANQP特性。 0x0008 Wifi-Direct特性。 0x0010 Soft AP特性。 0x0040 Wi-Fi AWare组网特性。 0x8000 AP STA共存特性。 0x8000000 WPA3-Personal SAE特性。 0x10000000 WPA3-Enterprise Suite-B 0x20000000 增强开放特性。
wifi.getIpInfo7+
getIpInfo(): IpInfo
获取IP信息。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
返回值:
类型 说明 [IpInfo] IP信息。
IpInfo7+
IP信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
ipAddress | number | 只读 | IP地址。 |
gateway | number | 只读 | 网关。 |
netmask | number | 只读 | 掩码。 |
primaryDns | number | 只读 | 主DNS服务器IP地址。 |
secondDns | number | 只读 | 备DNS服务器IP地址。 |
serverIp | number | 只读 | DHCP服务端IP地址。 |
leaseDuration | number | 只读 | IP地址租用时长。 |
wifi.getCountryCode7+
getCountryCode(): string
获取国家码信息。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.Core
-
返回值:
类型 说明 string 国家码。
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
-
参数
参数名 类型 必填 说明 callback AsyncCallback<[WifiP2pLinkedInfo]> 是 P2P连接信息结果回调函数。
WifiP2pLinkedInfo8+
提供WLAN连接的相关信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
connectState | [P2pConnectState] | 只读 | P2P连接状态。 |
isGroupOwner | boolean | 只读 | 是否是群组。 |
groupOwnerAddr | string | 只读 | 群组MAC地址。 |
P2pConnectState8+
表示P2P连接状态的枚举。
名称 | 默认值 | 说明 |
---|---|---|
DISCONNECTED | 0 | 断开状态。 |
CONNECTED | 1 | 连接状态。 |
wifi.getCurrentGroup8+
getCurrentGroup(): Promise
获取P2P当前组信息,使用promise方式作为异步方法。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
返回值:
类型 说明 Promise<[WifiP2pGroupInfo]> 当前组信息。
wifi.getCurrentGroup8+
getCurrentGroup(callback: AsyncCallback): void
获取P2P当前组信息,使用callback方式作为异步方法。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 callback AsyncCallback<[WifiP2pGroupInfo]> 是 当前组信息的回调函数。
WifiP2pGroupInfo8+
表示P2P群组相关信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
isP2pGo | boolean | 只读 | 是否是群组。 |
ownerInfo | [WifiP2pDevice] | 只读 | 群组的设备信息。 |
passphrase | string | 只读 | 群组密钥。 |
interface | string | 只读 | 接口名称。 |
groupName | string | 只读 | 群组名称。 |
networkId | number | 只读 | 网络ID。 |
frequency | number | 只读 | 群组的频率。 |
clientDevices | [WifiP2pDevice[]] | 只读 | 接入的设备列表信息。 |
goIpAddress | string | 只读 | 群组IP地址。 |
WifiP2pDevice8+
表示P2P设备信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
deviceName | string | 只读 | 设备名称。 |
deviceAddress | string | 只读 | 设备MAC地址。 |
primaryDeviceType | string | 只读 | 主设备类型。 |
deviceStatus | [P2pDeviceStatus] | 只读 | 设备状态。 |
groupCapabilities | number | 只读 | 群组能力。 |
P2pDeviceStatus8+
表示设备状态的枚举。
名称 | 默认值 | 说明 |
---|---|---|
CONNECTED | 0 | 连接状态。 |
INVITED | 1 | 邀请状态。 |
FAILED | 2 | 失败状态。 |
AVAILABLE | 3 | 可用状态。 |
UNAVAILABLE | 4 | 不可用状态。 |
wifi.getP2pPeerDevices8+
getP2pPeerDevices(): Promise<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
-
参数
参数名 类型 必填 说明 callback AsyncCallback<[WifiP2pDevice[]]> 是 对端设备列表信息回调函数。
wifi.createGroup8+
createGroup(config: WifiP2PConfig): boolean;
创建群组。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数:
参数名 类型 必填 说明 config [WifiP2PConfig] 是 群组配置信息。 -
返回值:
类型 说明 boolean true:创建群组操作执行成功, false:创建群组操作执行失败。
WifiP2PConfig8+
表示P2P配置信息。
参数名 | 类型 | 读写属性 | 说明 |
---|---|---|---|
deviceAddress | string | 只读 | 设备地址。 |
netId | number | 只读 | 网络ID。创建群组时-1表示创建临时组,-2表示创建永久组。 |
passphrase | string | 只读 | 群组密钥。 |
groupName | string | 只读 | 群组名称。 |
goBand | [GroupOwnerBand] | 只读 | 群组带宽。 |
GroupOwnerBand8+
表示群组带宽的枚举。
名称 | 默认值 | 说明 |
---|---|---|
GO_BAND_AUTO | 0 | 自动模式。 |
GO_BAND_2GHZ | 1 | 2GHZ。 |
GO_BAND_5GHZ | 2 | 5GHZ。 |
wifi.removeGroup8+
removeGroup(): boolean;
移除群组。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
返回值:
类型 说明 boolean true:操作执行成功, false:操作执行失败。
wifi.p2pConnect8+
p2pConnect(config: WifiP2PConfig): boolean;
执行P2P连接。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数:
参数名 类型 必填 说明 config [WifiP2PConfig] 是 连接配置信息。 -
返回值:
类型 说明 boolean true:操作执行成功, false:操作执行失败。 -
示例
import wifi from '@ohos.wifi'; var recvP2pConnectionChangeFunc = result => { console.info("p2p connection change receive event: " + JSON.stringify(result)); wifi.getP2pLinkedInfo((err, data) => { if (err) { console.error('failed to get getP2pLinkedInfo: ' + JSON.stringify(err)); return; } console.info("get getP2pLinkedInfo: " + JSON.stringify(data)); }); } wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc); var recvP2pDeviceChangeFunc = result => { console.info("p2p device change receive event: " + JSON.stringify(result)); } wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc); var recvP2pPeerDeviceChangeFunc = result => { console.info("p2p peer device change receive event: " + JSON.stringify(result)); wifi.getP2pPeerDevices((err, data) => { if (err) { console.error('failed to get peer devices: ' + JSON.stringify(err)); return; } console.info("get peer devices: " + JSON.stringify(data)); var len = Object.keys(data).length; for (var i = 0; i < len; ++i) { if (data[i].deviceName === "my_test_device") { console.info("p2p connect to test device: " + data[i].deviceAddress); var config = { "deviceAddress":data[i].deviceAddress, "netId":-2, "passphrase":"", "groupName":"", "goBand":0, } wifi.p2pConnect(config); } } }); } wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); var recvP2pPersistentGroupChangeFunc = result => { console.info("p2p persistent group change receive event"); wifi.getCurrentGroup((err, data) => { if (err) { console.error('failed to get current group: ' + JSON.stringify(err)); return; } console.info("get current group: " + JSON.stringify(data)); }); } wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); setTimeout(function() {wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);}, 125 * 1000); console.info("start discover devices -> " + wifi.startDiscoverDevices());
wifi.p2pCancelConnect8+
p2pCancelConnect(): boolean;
取消P2P连接。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
返回值:
类型 说明 boolean true:取消连接操作执行成功, false:取消连接操作执行失败。
wifi.startDiscoverDevices8+
startDiscoverDevices(): boolean;
开始发现设备。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
返回值:
类型 说明 boolean true:操作执行成功, false:操作执行失败。
wifi.stopDiscoverDevices8+
stopDiscoverDevices(): boolean;
停止发现设备。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
返回值:
类型 说明 boolean true:操作执行成功,操作执行失败。
wifi.on(‘wifiStateChange’)7+
on(type: “wifiStateChange”, callback: Callback): void
注册WLAN状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiStateChange"字符串。 callback Callback 是 状态改变回调函数。 -
状态改变事件的枚举。
枚举值 说明 0 未激活。 1 已激活。 2 激活中。 3 去激活中。
wifi.off(‘wifiStateChange’)7+
off(type: “wifiStateChange”, callback?: Callback): void
取消注册WLAN状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiStateChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。 -
示例
import wifi from '@ohos.wifi'; var WIFI_POWER_STATE = "wifiStateChange"; var recvPowerNotifyFunc = result => { console.info("Receive power state change event: " + result); } // Register event wifi.on(WIFI_POWER_STATE, recvPowerNotifyFunc); // Unregister event wifi.off(WIFI_POWER_STATE, recvPowerNotifyFunc);
wifi.on(‘wifiConnectionChange’)7+
on(type: “wifiConnectionChange”, callback: Callback): void
注册WLAN连接状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiConnectionChange"字符串。 callback Callback 是 状态改变回调函数。 -
连接状态改变事件的枚举。
枚举值 说明 0 已断开。 1 已连接。
wifi.off(‘wifiConnectionChange’)7+
off(type: “wifiConnectionChange”, callback?: Callback): void
取消注册WLAN连接状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiConnectionChange"字符串。 callback Callback 否 连接状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘wifiScanStateChange’)7+
on(type: “wifiScanStateChange”, callback: Callback): void
注册扫描状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiScanStateChange"字符串。 callback Callback 是 状态改变回调函数。 -
扫描状态改变事件的枚举。
枚举值 说明 0 扫描失败。 1 扫描成功。
wifi.off(‘wifiScanStateChange’)7+
off(type: “wifiScanStateChange”, callback?: Callback): void
取消注册扫描状态改变事件。
- 需要权限: ohos.permission.GET_WIFI_INFO
- 系统能力: SystemCapability.Communication.WiFi.STA
- 参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
type | string | 是 | 固定填"wifiScanStateChange"字符串。 |
callback | Callback | 否 | 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。 |
wifi.on(‘wifiRssiChange’)7+
on(type: “wifiRssiChange”, callback: Callback): void
注册RSSI状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiRssiChange"字符串。 callback Callback 是 状态改变回调函数,返回以dBm为单位的RSSI值。
wifi.off(‘wifiRssiChange’)7+
off(type: “wifiRssiChange”, callback?: Callback): void
取消注册RSSI状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.STA
-
参数
参数名 类型 必填 说明 type string 是 固定填"wifiRssiChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘hotspotStateChange’)7+
on(type: “hotspotStateChange”, callback: Callback): void
注册热点状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.AP.Core
-
参数
参数名 类型 必填 说明 type string 是 固定填"hotspotStateChange"字符串。 callback Callback 是 状态改变回调函数。 -
热点状态改变事件的枚举。
枚举值 说明 0 未激活。 1 已激活。 2 激活中。 3 去激活中。
wifi.off(‘hotspotStateChange’)7+
off(type: “hotspotStateChange”, callback?: Callback): void
取消注册热点状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.AP.Core
-
参数
参数名 类型 必填 说明 type string 是 固定填"hotspotStateChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘p2pStateChange’)8+
on(type: “p2pStateChange”, callback: Callback): void
注册P2P开关状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pStateChange"字符串。 callback Callback 是 状态改变回调函数。 -
P2P状态改变事件的枚举。
枚举值 说明 1 空闲。 2 打开中。 3 已打开。 4 关闭中。 5 已关闭。
wifi.off(‘p2pStateChange’)8+
off(type: “p2pStateChange”, callback?: Callback): void
取消注册P2P开关状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pStateChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。 wifi.on(‘p2pConnectionChange’)8+
on(type: “p2pConnectionChange”, callback: Callback): void
注册P2P连接状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pConnectionChange"字符串。 callback Callback<[WifiP2pLinkedInfo]> 是 状态改变回调函数。
wifi.off(‘p2pConnectionChange’)8+
off(type: “p2pConnectionChange”, callback?: Callback): void
取消注册P2P连接状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pConnectionChange"字符串。 callback Callback<[WifiP2pLinkedInfo]> 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘p2pDeviceChange’)8+
on(type: “p2pDeviceChange”, callback: Callback): void
注册P2P设备状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pDeviceChange"字符串。 callback Callback<[WifiP2pDevice]> 是 状态改变回调函数。
wifi.off(‘p2pDeviceChange’)8+
off(type: “p2pDeviceChange”, callback?: Callback): void
取消注册P2P设备状态改变事件。
-
需要权限: ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pDeviceChange"字符串。 callback Callback<[WifiP2pDevice]> 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘p2pPeerDeviceChange’)8+
on(type: “p2pPeerDeviceChange”, callback: Callback<WifiP2pDevice[]>): void
注册P2P对端设备状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO,ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pPeerDeviceChange"字符串。 callback Callback<[WifiP2pDevice[]]> 是 状态改变回调函数。
wifi.off(‘p2pPeerDeviceChange’)8+
off(type: “p2pPeerDeviceChange”, callback?: Callback<WifiP2pDevice[]>): void
取消注册P2P对端设备状态改变事件。
-
需要权限: ohos.permission.LOCATION
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pPeerDeviceChange"字符串。 callback Callback<[WifiP2pDevice[]]> 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘p2pPersistentGroupChange’)8+
on(type: “p2pPersistentGroupChange”, callback: Callback): void
注册P2P永久组状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pPersistentGroupChange"字符串。 callback Callback 是 状态改变回调函数。
wifi.off(‘p2pPersistentGroupChange’)8+
off(type: “p2pPersistentGroupChange”, callback?: Callback): void
取消注册P2P永久组状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pPersistentGroupChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。
wifi.on(‘p2pDiscoveryChange’)8+
on(type: “p2pDiscoveryChange”, callback: Callback): void
注册发现设备状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pDiscoveryChange"字符串。 callback Callback 是 状态改变回调函数。 -
发现设备状态改变事件的枚举。
枚举值 说明 0 初始状态。 1 发现成功。
wifi.off(‘p2pDiscoveryChange’)8+
off(type: “p2pDiscoveryChange”, callback?: Callback): void
取消注册发现设备状态改变事件。
-
需要权限: ohos.permission.GET_WIFI_INFO
-
系统能力: SystemCapability.Communication.WiFi.P2P
-
参数
参数名 类型 必填 说明 type string 是 固定填"p2pDiscoveryChange"字符串。 callback Callback 否 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。