# WLAN > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** > 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 ```js 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<WifiScanInfo>> 获取扫描结果，使用promise方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。 - 系统能力： SystemCapability.Communication.WiFi.STA - 返回值： | **类型** | **说明** | | -------- | -------- | | Promise< Array<[WifiScanInfo](#wifiscaninfo)> > | 返回扫描到的热点列表。 | ## wifi.getScanInfos getScanInfos(callback: AsyncCallback<Array<WifiScanInfo>>): void 获取扫描结果，使用callback方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO以及ohos.permission.GET_WIFI_PEERS_MAC和ohos.permission.LOCATION权限中的至少一个。 - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | callback | AsyncCallback< Array<[WifiScanInfo](#wifiscaninfo)>> | 是 | 扫描到的热点列表结果回调函数。 | - 示例 ```js 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](#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<boolean> 添加不可信网络配置，使用promise方式作为异步方法。 - 需要权限： ohos.permission.SET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#WifiDeviceConfig) | 是 | WLAN配置信息。 | - 返回值： | **类型** | **说明** | | -------- | -------- | | Promise<boolean> | 操作结果，ture: 成功， false: 失败。 | ## WifiDeviceConfig WLAN配置信息。 | **参数名** | **类型** | **读写属性** | **说明** | | -------- | -------- | -------- | -------- | | ssid | string | 只读 | 热点的SSID，编码格式为UTF-8。 | | bssid | string | 只读 | 热点的BSSID。 | | preSharedKey | string | 只读 | 热点的密钥。 | | isHiddenSsid | boolean | 只读 | 是否是隐藏网络。 | | securityType | [WifiSecurityType](#WifiSecurityType) | 只读 | 加密类型。 | ## wifi.addUntrustedConfig7+ addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback<boolean>): void 添加不可信网络配置，使用callback方式作为异步方法。 - 需要权限： ohos.permission.SET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#WifiDeviceConfig) | 是 | WLAN配置信息。 | | callback | AsyncCallback<boolean> | 是 | 操作结果，ture: 成功， false: 失败。 | ## wifi.removeUntrustedConfig7+ removeUntrustedConfig(config: WifiDeviceConfig): Promise<boolean> 移除不可信网络配置，使用promise方式作为异步方法。 - 需要权限： ohos.permission.SET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#WifiDeviceConfig) | 是 | WLAN配置信息。 | - 返回值： | **类型** | **说明** | | -------- | -------- | | Promise<boolean> | 操作结果，ture: 成功， false: 失败。 | ## wifi.removeUntrustedConfig7+ removeUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback<boolean>): void 添加不可信网络配置，使用callback方式作为异步方法。 - 需要权限： ohos.permission.SET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#WifiDeviceConfig) | 是 | WLAN配置信息。 | | callback | AsyncCallback<boolean> | 是 | 操作结果，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<WifiLinkedInfo> 获取WLAN连接信息，使用promise方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 返回值： | 类型 | 说明 | | -------- | -------- | | Promise<[WifiLinkedInfo](#WifiLinkedInfo)> | WLAN连接的相关信息。 | ## wifi.getLinkedInfo getLinkedInfo(callback: AsyncCallback<WifiLinkedInfo>): void 获取WLAN连接信息，使用callback方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiLinkedInfo](#WifiLinkedInfo)> | 是 | WLAN连接信息结果回调函数。 | - 示例 ```js 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](#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](#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<WifiP2pLinkedInfo> 获取P2P连接信息，使用promise方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 返回值： | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pLinkedInfo](#WifiP2pLinkedInfo)> | P2P连接信息。 | ## wifi.getP2pLinkedInfo8+ getP2pLinkedInfo(callback: AsyncCallback<WifiP2pLinkedInfo>): void 获取P2P连接信息，使用callback方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pLinkedInfo](#WifiP2pLinkedInfo)> | 是 | P2P连接信息结果回调函数。 | ## WifiP2pLinkedInfo8+ 提供WLAN连接的相关信息。 | 参数名 | 类型 | 读写属性 | 说明 | | -------- | -------- | -------- | -------- | | connectState | [P2pConnectState](#P2pConnectState) | 只读 | P2P连接状态。 | | isGroupOwner | boolean | 只读 | 是否是群组。 | | groupOwnerAddr | string | 只读 | 群组MAC地址。 | ## P2pConnectState8+ 表示P2P连接状态的枚举。 | 名称 | 默认值 | 说明 | | -------- | -------- | -------- | | DISCONNECTED | 0 | 断开状态。 | | CONNECTED | 1 | 连接状态。 | ## wifi.getCurrentGroup8+ getCurrentGroup(): Promise<WifiP2pGroupInfo> 获取P2P当前组信息，使用promise方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION - 系统能力： SystemCapability.Communication.WiFi.P2P - 返回值： | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pGroupInfo](#WifiP2pGroupInfo)> | 当前组信息。 | ## wifi.getCurrentGroup8+ getCurrentGroup(callback: AsyncCallback<WifiP2pGroupInfo>): void 获取P2P当前组信息，使用callback方式作为异步方法。 - 需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pGroupInfo](#WifiP2pGroupInfo)> | 是 | 当前组信息的回调函数。 | ## WifiP2pGroupInfo8+ 表示P2P群组相关信息。 | 参数名 | 类型 | 读写属性 | 说明 | | -------- | -------- | -------- | -------- | | isP2pGo | boolean | 只读 | 是否是群组。 | | ownerInfo | [WifiP2pDevice](#WifiP2pDevice) | 只读 | 群组的设备信息。 | | passphrase | string | 只读 | 群组密钥。 | | interface | string | 只读 | 接口名称。 | | groupName | string | 只读 | 群组名称。 | | networkId | number | 只读 | 网络ID。 | | frequency | number | 只读 | 群组的频率。 | | clientDevices | [WifiP2pDevice[]](#WifiP2pDevice) | 只读 | 接入的设备列表信息。 | | goIpAddress | string | 只读 | 群组IP地址。 | ## WifiP2pDevice8+ 表示P2P设备信息。 | 参数名 | 类型 | 读写属性 | 说明 | | -------- | -------- | -------- | -------- | | deviceName | string | 只读 | 设备名称。 | | deviceAddress | string | 只读 | 设备MAC地址。 | | primaryDeviceType | string | 只读 | 主设备类型。 | | deviceStatus | [P2pDeviceStatus](#P2pDeviceStatus) | 只读 | 设备状态。 | | groupCapabilitys | 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[]](#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[]](#WifiP2pDevice)> | 是 | 对端设备列表信息回调函数。 | ## wifi.createGroup8+ createGroup(config: WifiP2PConfig): boolean; 创建群组。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数： | **参数名** | **类型** | 必填 | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiP2PConfig](#WifiP2PConfig) | 是 | 群组配置信息。 | - 返回值： | 类型 | 说明 | | -------- | -------- | | boolean | true:创建群组操作执行成功， false:创建群组操作执行失败。 | ## WifiP2PConfig8+ 表示P2P配置信息。 | 参数名 | 类型 | 读写属性 | 说明 | | -------- | -------- | -------- | -------- | | deviceAddress | string | 只读 | 设备名称。 | | netId | number | 只读 | 网络ID。创建群组时-1表示创建临时组，-2表示创建永久组。 | | passphrase | string | 只读 | 群组密钥。 | | groupName | string | 只读 | 群组名称。 | | goBand | [GroupOwnerBand](#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](#WifiP2PConfig) | 是 | 连接配置信息。 | - 返回值： | 类型 | 说明 | | -------- | -------- | | boolean | true:操作执行成功， false:操作执行失败。 | - 示例 ```js 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<number>): void 注册WLAN状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiStateChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - 状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 0 | 未激活。 | | 1 | 已激活。 | | 2 | 激活中。 | | 3 | 去激活中。 | ## wifi.off('wifiStateChange')7+ off(type: "wifiStateChange", callback?: Callback<number>): void 取消注册WLAN状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | - 示例 ```js 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<number>): void 注册WLAN连接状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiConnectionChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - 连接状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 0 | 已断开。 | | 1 | 已连接。 | ## wifi.off('wifiConnectionChange')7+ off(type: "wifiConnectionChange", callback?: Callback<number>): void 取消注册WLAN连接状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiConnectionChange"字符串。 | | callback | Callback<number> | 否 | 连接状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('wifiScanStateChange')7+ on(type: "wifiScanStateChange", callback: Callback<number>): void 注册扫描状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiScanStateChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - 扫描状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 0 | 扫描失败。 | | 1 | 扫描成功。 | ## wifi.off('wifiScanStateChange')7+ off(type: "wifiScanStateChange", callback?: Callback<number>): void 取消注册扫描状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiScanStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('wifiRssiChange')7+ on(type: "wifiRssiChange", callback: Callback<number>): void 注册RSSI状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiRssiChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数，返回以dBm为单位的RSSI值。 | ## wifi.off('wifiRssiChange')7+ off(type: "wifiRssiChange", callback?: Callback<number>): void 取消注册RSSI状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.STA - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiRssiChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('hotspotStateChange')7+ on(type: "hotspotStateChange", callback: Callback<number>): void 注册热点状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.AP.Core - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStateChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - 热点状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 0 | 未激活。 | | 1 | 已激活。 | | 2 | 激活中。 | | 3 | 去激活中。 | ## wifi.off('hotspotStateChange')7+ off(type: "hotspotStateChange", callback?: Callback<number>): void 取消注册热点状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.AP.Core - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('p2pStateChange')8+ on(type: "p2pStateChange", callback: Callback<number>): void 注册P2P开关状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pStateChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - P2P状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 1 | 空闲。 | | 2 | 打开中。 | | 3 | 已打开。 | | 4 | 关闭中。 | | 5 | 已关闭。 | ## wifi.off('p2pStateChange')8+ off(type: "p2pStateChange", callback?: Callback<number>): void 取消注册P2P开关状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('p2pConnectionChange')8+ on(type: "p2pConnectionChange", callback: Callback<WifiP2pLinkedInfo>): void 注册P2P连接状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pConnectionChange"字符串。 | | callback | Callback<[WifiP2pLinkedInfo](#WifiP2pLinkedInfo)> | 是 | 状态改变回调函数。 | ## wifi.off('p2pConnectionChange')8+ off(type: "p2pConnectionChange", callback?: Callback<WifiP2pLinkedInfo>): void 取消注册P2P连接状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pConnectionChange"字符串。 | | callback | Callback<[WifiP2pLinkedInfo](#WifiP2pLinkedInfo)> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('p2pDeviceChange')8+ on(type: "p2pDeviceChange", callback: Callback<WifiP2pDevice>): void 注册P2P设备状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO，ohos.permission.LOCATION - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice](#WifiP2pDevice)> | 是 | 状态改变回调函数。 | ## wifi.off('p2pDeviceChange')8+ off(type: "p2pDeviceChange", callback?: Callback<WifiP2pDevice>): void 取消注册P2P设备状态改变事件。 - 需要权限： ohos.permission.LOCATION - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice](#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[]](#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[]](#WifiP2pDevice)> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('p2pPersistentGroupChange')8+ on(type: "p2pPersistentGroupChange", callback: Callback<void>): void 注册P2P永久组状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pPersistentGroupChange"字符串。 | | callback | Callback<void> | 是 | 状态改变回调函数。 | ## wifi.off('p2pPersistentGroupChange')8+ off(type: "p2pPersistentGroupChange", callback?: Callback<void>): void 取消注册P2P永久组状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pPersistentGroupChange"字符串。 | | callback | Callback<void> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 | ## wifi.on('p2pDiscoveryChange')8+ on(type: "p2pDiscoveryChange", callback: Callback<number>): void 注册发现设备状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDiscoveryChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | - 发现设备状态改变事件的枚举。 | **枚举值** | **说明** | | -------- | -------- | | 0 | 初始状态。 | | 1 | 发现成功。 | ## wifi.off('p2pDiscoveryChange')8+ off(type: "p2pDiscoveryChange", callback?: Callback<number>): void 取消注册发现设备状态改变事件。 - 需要权限： ohos.permission.GET_WIFI_INFO - 系统能力： SystemCapability.Communication.WiFi.P2P - 参数 | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDiscoveryChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填，将去注册该事件关联的所有回调函数。 |