# @ohos.wifiManager (WLAN) 该模块主要提供WLAN基础功能、P2P(peer-to-peer)功能和WLAN消息通知的相应服务,让应用可以通过WLAN和其他设备互联互通。 > **说明:** > 本模块首批接口从API version 6开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 ## 导入模块 ```js import wifiManager from '@ohos.wifiManager'; ``` ## wifiManager.enableWifi9+ enableWifi(): void 使能WLAN,异步接口,是否打开成功需要注册并监听wifiStateChange的回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION 仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.enableWifi(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.disableWifi9+ disableWifi(): void 去使能WLAN,异步接口,是否关闭成功需要注册并监听wifiStateChange的回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.disableWifi(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.isWifiActive9+ isWifiActive(): boolean 查询WLAN是否已使能。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:已使能, false:未使能。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let isWifiActive = wifiManager.isWifiActive(); console.info("isWifiActive:" + isWifiActive); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.scan9+ scan(): void 启动WLAN扫描。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.scan(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.startScan10+ startScan(): void **系统接口:** 此接口为系统接口。 启动WLAN扫描。 **需要权限:** ohos.permission.SET_WIFI_INFO 和ohos.permission.MANAGE_WIFI_CONNECTION **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.startScan(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getScanResults9+ getScanResults(): Promise<Array<WifiScanInfo>> 获取扫描结果,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或(ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION)) **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | Promise< Array<[WifiScanInfo](#wifiscaninfo)> > | Promise对象。返回扫描到的热点列表。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| ## wifiManager.getScanResults9+ getScanResults(callback: AsyncCallback<Array<WifiScanInfo>>): void 获取扫描结果,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或 (ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION)) **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | callback | AsyncCallback< Array<[WifiScanInfo](#wifiscaninfo)>> | 是 | 回调函数。当成功时,err为0,data为扫描到的热点;否则err为非0值,data为空。 | | Array<[WifiScanInfo](#wifiscaninfo)> | 返回扫描到的热点列表。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getScanResults((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); } }); wifiManager.getScanResults().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); } }); ``` ## wifiManager.getScanResultsSync9+ getScanResultsSync():  Array<[WifiScanInfo](#wifiscaninfo)> 获取扫描结果,使用同步方式返回结果。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 (ohos.permission.GET_WIFI_PEERS_MAC 或 (ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION)) **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | |  Array<[WifiScanInfo](#wifiscaninfo)> | 扫描结果数组。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let scanInfoList = wifiManager.getScanResultsSync(); console.info("scanInfoList:" + JSON.stringify(scanInfoList)); let len = Object.keys(scanInfoList).length; console.log("wifi received scan info: " + len); if(len > 0){ for (var i = 0; i < len; ++i) { console.info("ssid: " + scanInfoList[i].ssid); console.info("bssid: " + scanInfoList[i].bssid); console.info("capabilities: " + scanInfoList[i].capabilities); console.info("securityType: " + scanInfoList[i].securityType); console.info("rssi: " + scanInfoList[i].rssi); console.info("band: " + scanInfoList[i].band); console.info("frequency: " + scanInfoList[i].frequency); console.info("channelWidth: " + scanInfoList[i].channelWidth); console.info("timestamp: " + scanInfoList[i].timestamp); } } }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getScanInfoList10+ getScanInfoList(): Array<WifiScanInfo>; 获取扫描结果。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | Array<[WifiScanInfo](#wifiscaninfo)> | 返回扫描到的热点列表。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的bssid为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let scanInfoList = wifiManager.getScanInfoList(); console.info("scanInfoList:" + JSON.stringify(scanInfoList)); let len = Object.keys(scanInfoList).length; console.log("wifi received scan info: " + len); if(len > 0){ for (var i = 0; i < len; ++i) { console.info("ssid: " + scanInfoList[i].ssid); console.info("bssid: " + scanInfoList[i].bssid); console.info("capabilities: " + scanInfoList[i].capabilities); console.info("securityType: " + scanInfoList[i].securityType); console.info("rssi: " + scanInfoList[i].rssi); console.info("band: " + scanInfoList[i].band); console.info("frequency: " + scanInfoList[i].frequency); console.info("channelWidth: " + scanInfoList[i].channelWidth); console.info("timestamp: " + scanInfoList[i].timestamp); } } }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## WifiScanInfo9+ WLAN热点信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | ssid | string | 是 | 否 | 热点的SSID,编码格式为UTF-8。 | | bssid | string | 是 | 否 | 热点的BSSID。 | | bssidType10+| DeviceAddressType | 是 | 否 | 热点的BSSID类型。 | | capabilities | string | 是 | 否 | 热点能力。 | | securityType | [WifiSecurityType](#wifisecuritytype) | 是 | 否 | WLAN加密类型。 | | rssi | number | 是 | 否 | 热点的信号强度(dBm)。 | | band | number | 是 | 否 | WLAN接入点的频段。 | | frequency | number | 是 | 否 | WLAN接入点的频率。 | | channelWidth | number | 是 | 否 | WLAN接入点的带宽。 | | centerFrequency0 | number | 是 | 否 | 热点的中心频率。 | | centerFrequency1 | number | 是 | 否 | 热点的中心频率。如果热点使用两个不重叠的WLAN信道,则返回两个中心频率,分别用centerFrequency0和centerFrequency1表示。 | | infoElems | Array<[WifiInfoElem](#wifiinfoelem9)> | 是 | 否 | 信息元素。 | | timestamp | number | 是 | 否 | 时间戳。 | ## DeviceAddressType 10+ wifi 设备地址(mac/bissid)类型。 **系统能力:** SystemCapability.Communication.WiFi.Core | **名称** | **值** | **说明** | | -------- | -------- | -------- | | RANDOM_DEVICE_ADDRESS | 0 | 随机设备地址。 | | REAL_DEVICE_ADDRESS | 1 | 真实设备地址。 | ## WifiSecurityType9+ 表示加密类型的枚举。 **系统能力:** SystemCapability.Communication.WiFi.Core | **名称** | **值** | **说明** | | -------- | -------- | -------- | | 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_SEC_TYPE_EAP9+ | 5 | EAP加密类型。 | | WIFI_SEC_TYPE_EAP_SUITE_B9+ | 6 | Suite-B 192位加密类型。 | | WIFI_SEC_TYPE_OWE9+ | 7 | 机会性无线加密类型。 | | WIFI_SEC_TYPE_WAPI_CERT9+ | 8 | WAPI-Cert加密类型。 | | WIFI_SEC_TYPE_WAPI_PSK9+ | 9 | WAPI-PSK加密类型。 | ## WifiBandType10+ 表示WIFI频段类型的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **值** | **说明** | | -------- | -------- | -------- | | WIFI_BAND_NONE | 0 | 无效频段类型。 | | WIFI_BAND_2G | 1 | 2.4G频段类型。 | | WIFI_BAND_5G | 2 | 5G频段类型。 | | WIFI_BAND_6G | 3 | 6G频段类型。 | | WIFI_BAND_60G | 4 | 60G频段类型。 | ## WifiStandard10+ 表示WIFI标准的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **值** | **说明** | | -------- | -------- | -------- | | WIFI_STANDARD_UNDEFINED | 0 | 无效WIFI标准类型。 | | WIFI_STANDARD_11A | 1 | 802.11a WiFi标准类型。 | | WIFI_STANDARD_11B | 2 | 802.11b WiFi标准类型。 | | WIFI_STANDARD_11G | 3 | 802.11g WiFi标准类型。 | | WIFI_STANDARD_11N | 4 | 802.11n WiFi标准类型。 | | WIFI_STANDARD_11AC | 5 | 802.11ac WiFi标准类型。 | | WIFI_STANDARD_11AX | 6 | 802.11ax WiFi标准类型。 | | WIFI_STANDARD_11AD | 7 | 802.11ad WiFi标准类型。 | ## WifiInfoElem9+ WLAN热点信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | eid | number | 是 | 否 | 元素ID。 | | content | Uint8Array | 是 | 否 | 元素内容。 | ## WifiChannelWidth9+ 表示带宽类型的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **值** | **说明** | | -------- | -------- | -------- | | WIDTH_20MHZ | 0 | 20MHZ。 | | WIDTH_40MHZ | 1 | 40MHZ。 | | WIDTH_80MHZ | 2 | 80MHZ。 | | WIDTH_160MHZ | 3 | 160MHZ。 | | WIDTH_80MHZ_PLUS | 4 | 80MHZ+。 | | WIDTH_INVALID | 5 | 无效值 | ## wifiManager.setScanAlwaysAllowed10+ setScanAlwaysAllowed(isScanAlwaysAllowed: boolean): void 设置是否始终允许扫描。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | isScanAlwaysAllowed | boolean | 是 | 是否始终允许扫描。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| ```js import wifiManager from '@ohos.wifiManager'; try { let isScanAlwaysAllowed = true; wifiManager.setScanAlwaysAllowed(isScanAlwaysAllowed); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getScanAlwaysAllowed10+ getScanAlwaysAllowed(): boolean 获取是否始终允许扫描。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean| 是否始终允许扫描。 true 表示允许触发扫描,false表示在禁用wifi时不允许触发扫描| **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let isScanAlwaysAllowed = wifiManager.getScanAlwaysAllowed(); console.info("isScanAlwaysAllowed:" + isScanAlwaysAllowed); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.addDeviceConfig9+ addDeviceConfig(config: WifiDeviceConfig): Promise<number> 添加网络配置,使用Promise异步回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。如果bssidType未指定值,则bssidType默认为随机设备地址类型。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | Promise<number> | Promise对象。返回添加的网络配置ID,如果值为-1表示添加失败。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 0 } wifiManager.addDeviceConfig(config).then(result => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## WifiDeviceConfig9+ WLAN配置信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | ssid | string | 是 | 否 | 热点的SSID,编码格式为UTF-8。 | | bssid | string | 是 | 否 | 热点的BSSID。 | | bssidType10+ | DeviceAddressType | 是 | 否 | 热点的BSSID类型。 | | preSharedKey | string | 是 | 否 | 热点的密钥。 | | isHiddenSsid | boolean | 是 | 否 | 是否是隐藏网络。 | | securityType | [WifiSecurityType](#wifisecuritytype) | 是 | 否 | 加密类型。 | | creatorUid | number | 是 | 否 | 创建用户的ID。
**系统接口:** 此接口为系统接口。 | | disableReason | number | 是 | 否 | 禁用原因。
**系统接口:** 此接口为系统接口。 | | netId | number | 是 | 否 | 分配的网络ID。
**系统接口:** 此接口为系统接口。 | | randomMacType | number | 是 | 否 | 随机MAC类型。
**系统接口:** 此接口为系统接口。 | | randomMacAddr | string | 是 | 否 | 随机MAC地址。
**系统接口:** 此接口为系统接口。 | | ipType | [IpType](#iptype9) | 是 | 否 | IP地址类型。
**系统接口:** 此接口为系统接口。 | | staticIp | [IpConfig](#ipconfig9) | 是 | 否 | 静态IP配置信息。
**系统接口:** 此接口为系统接口。 | | eapConfig10+ | [WifiEapConfig](#wifieapconfig10) | 是 | 否 | 可扩展身份验证协议配置。 | | proxyConfig10+ | WifiProxyConfig | 是 | 否 | 代理配置。
**系统接口:** 此接口为系统接口。| ## IpType9+ 表示IP类型的枚举。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | STATIC | 0 | 静态IP。 | | DHCP | 1 | 通过DHCP获取。 | | UNKNOWN | 2 | 未指定。 | ## IpConfig9+ IP配置信息。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | ipAddress | number | 是 | 否 | IP地址。 | | gateway | number | 是 | 否 | 网关。 | | prefixLength | number | 是 | 否 | 掩码。 | | dnsServers | number[] | 是 | 否 | DNS服务器。 | | domains | Array<string> | 是 | 否 | 域信息。 | ## WifiEapConfig10+ 可扩展身份验证协议配置信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | eapMethod | [EapMethod](#eapmethod10) | 是 | 否 | EAP认证方式。 | | phase2Method | [Phase2Method](#phase2method10) | 是 | 否 | 第二阶段认证方式。 | | identity | string | 是 | 否 | 身份信息。 | | anonymousIdentity | string | 是 | 否 | 匿名身份。 | | password | string | 是 | 否 | 密码。 | | caCertAlias | string | 是 | 否 | CA 证书别名。 | | caPath | string | 是 | 否 | CA 证书路径。 | | clientCertAlias | string | 是 | 否 | 客户端证书别名。 | | certEntry | Uint8Array | 是 | 是 | CA 证书内容。 | | certPassword | string | 是 | 是 | CA证书密码。 | | altSubjectMatch | string | 是 | 否 | 替代主题匹配。 | | domainSuffixMatch | string | 是 | 否 | 域后缀匹配。 | | realm | string | 是 | 否 | 通行证凭证的领域。 | | plmn | string | 是 | 否 | 公共陆地移动网的直通凭证提供商。 | | eapSubId | number | 是 | 否 | SIM卡的子ID。 | ## EapMethod10+ 表示EAP认证方式的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | EAP_NONE | 0 | 不指定。 | | EAP_PEAP | 1 | PEAP类型。 | | EAP_TLS | 2 | TLS类型。 | | EAP_TTLS | 3 | TTLS类型。 | | EAP_PWD | 4 | PWD类型。 | | EAP_SIM | 5 | SIM类型。 | | EAP_AKA | 6 | AKA类型。 | | EAP_AKA_PRIME | 7 | AKA Prime类型。 | | EAP_UNAUTH_TLS | 8 | UNAUTH TLS类型。 | ## Phase2Method10+ 表示第二阶段认证方式的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | PHASE2_NONE | 0 | 不指定。 | | PHASE2_PAP | 1 | PAP类型。 | | PHASE2_MSCHAP | 2 | MSCHAP类型。 | | PHASE2_MSCHAPV2 | 3 | MSCHAPV2类型。 | | PHASE2_GTC | 4 | GTC类型。 | | PHASE2_SIM | 5 | SIM类型。 | | PHASE2_AKA | 6 | AKA类型。 | | PHASE2_AKA_PRIME | 7 | AKA Prime类型。 | ## WifiProxyConfig 10+ Wifi 代理配置。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | proxyMethod | ProxyMethod | 是 | 否 | 代理方法 | | pacWebAddress | string | 是 | 否 | 自动配置代理的PAC web 地址。 | | serverHostName | string | 是 | 否 | 手动配置代理的服务器主机名。 | | serverPort | string | 是 | 否 | 手动配置代理的服务器端口。 | | exclusionObjects | string | 是 | 否 | 手动配置代理的排除对象,对象用“,”分隔。| ## ProxyMethod10+ 表示WiFi代理方法的枚举。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | METHOD_NONE | 0 | 不使用代理。 | | METHOD_AUTO | 1 | 使用自动配置的代理。 | | METHOD_MANUAL | 2 | 使用手动配置的代理。 | ## wifiManager.addDeviceConfig9+ addDeviceConfig(config: WifiDeviceConfig, callback: AsyncCallback<number>): void 添加网络配置,使用callback异步回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。如果bssidType未指定值,则bssidType默认为随机设备地址类型。 | | callback | AsyncCallback<number> | 是 | 回调函数。当操作成功时,err为0,data为添加的网络配置ID,如果data值为-1,表示添加失败。当error为非0,表示处理出现错误。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 0 } wifiManager.addDeviceConfig(config,(error,result) => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.addCandidateConfig9+ addCandidateConfig(config: WifiDeviceConfig): Promise<number> 添加候选网络配置,使用Promise异步回调。 **需要权限:** ohos.permission.SET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。如果bssidType未指定值,则bssidType默认为随机设备地址类型。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | Promise<number> | Promise对象。表示网络配置ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** `````js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 0 } wifiManager.addCandidateConfig(config).then(result => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ````` ## wifiManager.addCandidateConfig9+ addCandidateConfig(config: WifiDeviceConfig, callback: AsyncCallback<number>): void 添加候选网络配置,使用callback异步回调。 **需要权限:** ohos.permission.SET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。如果bssidType未指定值,则bssidType默认为随机设备地址类型。 | | callback | AsyncCallback<number> | 是 | 回调函数。当操作成功时,err为0,data为添加的网络配置ID,如果data值为-1,表示添加失败。如果操作出现错误,err为非0值。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** `````js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 0 } wifiManager.addCandidateConfig(config,(error,result) => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ````` ## wifiManager.removeCandidateConfig9+ removeCandidateConfig(networkId: number): Promise<void> 移除候选网络配置,使用Promise异步回调。 **需要权限:** ohos.permission.SET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | networkId | number | 是 | 网络配置ID。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | Promise<void> | Promise对象。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let networkId = 0; wifiManager.removeCandidateConfig(networkId).then(result => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.removeCandidateConfig9+ removeCandidateConfig(networkId: number, callback: AsyncCallback<void>): void 移除候选网络配置,使用callback异步回调。 **需要权限:** ohos.permission.SET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | networkId | number | 是 | 网络配置ID。 | | callback | AsyncCallback<void> | 是 | 回调函数。当操作成功时,err为0。如果error为非0,表示处理出现错误。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let networkId = 0; wifiManager.removeCandidateConfig(networkId,(error,result) => { console.info("result:" + JSON.stringify(result)); }); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getCandidateConfigs9+ getCandidateConfigs():  Array<[WifiDeviceConfig](#wifideviceconfig)> 获取候选网络配置。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | |  Array<[WifiDeviceConfig](#wifideviceconfig)> | 候选网络配置数组。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** `````js import wifiManager from '@ohos.wifiManager'; try { let configs = wifiManager.getCandidateConfigs(); console.info("configs:" + JSON.stringify(configs)); let len = Object.keys(configs).length; console.log("result len: " + len); if(len > 0){ for (var i = 0; i < len; ++i) { console.info("ssid: " + configs[i].ssid); console.info("bssid: " + configs[i].bssid); } } }catch(error){ console.error("failed:" + JSON.stringify(error)); } ````` ## wifiManager.connectToCandidateConfig9+ connectToCandidateConfig(networkId: number): void 应用使用该接口连接到自己添加的候选网络(如果当前已经连接到热点,需要先断开连接)。 **需要权限:** ohos.permission.SET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | networkId | number | 是 | 候选网络配置的ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let networkId = 0; let ret = wifiManager.connectToCandidateConfig(networkId); console.info("result:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.connectToNetwork9+ connectToNetwork(networkId: number): void 连接到指定网络(如果当前已经连接到热点,请先使用disconnet()接口断开连接)。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | networkId | number | 是 | 待连接的网络配置ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let networkId = 0; wifiManager.connectToNetwork(networkId); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.connectToDevice9+ connectToDevice(config: WifiDeviceConfig): void 连接到指定网络(如果当前已经连接到热点,请先使用disconnet()接口断开连接)。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。如果bssidType未指定值,则bssidType默认为随机设备地址类型。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 3 } wifiManager.connectToDevice(config); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.disconnect9+ disconnect(): void 断开连接的网络。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.disconnect(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getSignalLevel9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let rssi = 0; let band = 0; let level = wifiManager.getSignalLevel(rssi,band); console.info("level:" + JSON.stringify(level)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getLinkedInfo9+ getLinkedInfo(): Promise<WifiLinkedInfo> 获取WLAN连接信息,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 。 获取 macAddress 还需申请ohos.permission.GET_WIFI_LOCAL_MAC权限,无该权限时,macAddress 返回空字符串。 **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise<[WifiLinkedInfo](#wifilinkedinfo)> | Promise对象。表示WLAN连接信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| ## wifiManager.getLinkedInfo9+ getLinkedInfo(callback: AsyncCallback<WifiLinkedInfo>): void 获取WLAN连接信息,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 。 获取 macAddress 还需申请ohos.permission.GET_WIFI_LOCAL_MAC权限,无该权限时,macAddress 返回空字符串。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiLinkedInfo](#wifilinkedinfo)> | 是 | 回调函数。当获取成功时,err为0,data表示WLAN连接信息。如果error为非0,表示处理出现错误。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getLinkedInfo((err, data) => { if (err) { console.error("get linked info error"); return; } console.info("get wifi linked info: " + JSON.stringify(data)); }); wifiManager.getLinkedInfo().then(data => { console.info("get wifi linked info: " + JSON.stringify(data)); }).catch(error => { console.info("get linked info error"); }); ``` ## WifiLinkedInfo9+ 提供WLAN连接的相关信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | ssid | string | 是 | 否 | 热点的SSID,编码格式为UTF-8。 | | bssid | string | 是 | 否 | 热点的BSSID。 | | networkId | number | 是 | 否 | 网络配置ID。
**系统接口:** 此接口为系统接口。 | | rssi | number | 是 | 否 | 热点的信号强度(dBm)。 | | band | number | 是 | 否 | WLAN接入点的频段。 | | linkSpeed | number | 是 | 否 | WLAN接入点的上行速度。 | | rxLinkSpeed10+ | number | 是 | 否 | WLAN接入点的下行速度。 | | maxSupportedTxLinkSpeed10+ | number | 是 | 否 | 当前支持的最大上行速率。 | | maxSupportedRxLinkSpeed10+ | number | 是 | 否 | 当前支持的最大下行速率。 | | frequency | number | 是 | 否 | WLAN接入点的频率。 | | isHidden | boolean | 是 | 否 | WLAN接入点是否是隐藏网络。 | | isRestricted | boolean | 是 | 否 | WLAN接入点是否限制数据量。 | | chload | number | 是 | 否 | 连接负载,值越大表示负载约高。
**系统接口:** 此接口为系统接口。 | | snr | number | 是 | 否 | 信噪比。
**系统接口:** 此接口为系统接口。 | | macType | number | 是 | 否 | MAC地址类型。 | | macAddress | string | 是 | 否 | 设备的MAC地址。 | | ipAddress | number | 是 | 否 | WLAN连接的IP地址。 | | suppState | [SuppState](#suppstate) | 是 | 否 | 请求状态。
**系统接口:** 此接口为系统接口。 | | connState | [ConnState](#connstate) | 是 | 否 | WLAN连接状态。 | | channelWidth10+ | [WifiChannelWidth](#wifichannelwidth) | 是 | 否 | 当前连接热点的信道带宽。 | | wifiStandard10+ | [WifiStandard](#wifistandard) | 是 | 否 | 当前连接热点的WiFi标准。 | ## ConnState9+ 表示WLAN连接状态的枚举。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | 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连接建立失败。 | ## SuppState9+ 表示请求状态的枚举。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | DISCONNECTED | 0 | 已断开。 | | INTERFACE_DISABLED | 1 | 接口禁用。 | | INACTIVE | 2 | 未激活。 | | SCANNING | 3 | 扫描中。 | | AUTHENTICATING | 4 | 认证中。 | | ASSOCIATING | 5 | 关联中。 | | ASSOCIATED | 6 | 已关联。 | | FOUR_WAY_HANDSHAKE | 7 | 四次握手。 | | GROUP_HANDSHAKE | 8 | 组握手。 | | COMPLETED | 9 | 所有认证已完成。 | | UNINITIALIZED | 10 | 连接建立失败。 | | INVALID | 11 | 无效值。 | ## wifiManager.isConnected9+ isConnected(): boolean 查询WLAN是否已连接。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:已连接, false:未连接。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let ret = wifiManager.isConnected(); console.info("isConnected:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getSupportedFeatures9+ getSupportedFeatures(): number 查询设备支持的特性。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.Core **返回值:** | **类型** | **说明** | | -------- | -------- | | number | 支持的特性值。 | **特性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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2401000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let ret = wifiManager.getSupportedFeatures(); console.info("supportedFeatures:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.isFeatureSupported9+ isFeatureSupported(featureId: number): boolean 判断设备是否支持相关WLAN特性。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.Core **参数:** | **参数名** | **类型** | 必填 | **说明** | | -------- | -------- | -------- | -------- | | featureId | number | 是 | 特性ID值。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:支持, false:不支持。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2401000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let featureId = 0; let ret = wifiManager.isFeatureSupported(featureId); console.info("isFeatureSupported:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getDeviceMacAddress9+ getDeviceMacAddress(): string[] 获取设备的MAC地址。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_LOCAL_MAC 和 ohos.permission.GET_WIFI_INFO,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | string[] | MAC地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let ret = wifiManager.getDeviceMacAddress(); console.info("deviceMacAddress:" + JSON.stringify(ret)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getIpInfo9+ getIpInfo(): IpInfo 获取IP信息。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | [IpInfo](#ipinfo9) | IP信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let info = wifiManager.getIpInfo(); console.info("info:" + JSON.stringify(info)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## IpInfo9+ IP信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | ipAddress | number | 是 | 否 | IP地址。 | | gateway | number | 是 | 否 | 网关。 | | netmask | number | 是 | 否 | 掩码。 | | primaryDns | number | 是 | 否 | 主DNS服务器IP地址。 | | secondDns | number | 是 | 否 | 备DNS服务器IP地址。 | | serverIp | number | 是 | 否 | DHCP服务端IP地址。 | | leaseDuration | number | 是 | 否 | IP地址租用时长。 | ## wifiManager.getIpv6Info10+ getIpv6Info(): Ipv6Info 获取IP信息。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | | Ipv6Info | Ipv6信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let info = wifiManager.getIpv6Info(); console.info("info:" + JSON.stringify(info)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## Ipv6Info 10+ Ipv6信息。 **系统能力:** SystemCapability.Communication.WiFi.STA | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | linkIpv6Address | string | 是 | 否 | 链路Ipv6地址。 | | globalIpv6Address | string | 是 | 否 | 全局Ipv6地址。 | | randomGlobalIpv6Address | number | 是 | 否 | 随机全局Ipv6地址。 | | gateway | string | 是 | 否 | 网关。 | | netmask | string | 是 | 否 | 网络掩码。 | | primaryDNS | string | 是 | 否 | 主DNS服务器Ipv6地址。 | | secondDNS | string | 是 | 否 | 备DNS服务器Ipv6地址。 | ## wifiManager.getCountryCode9+ getCountryCode(): string 获取国家码信息。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.Core **返回值:** | **类型** | **说明** | | -------- | -------- | | string | 国家码。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2401000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let code = wifiManager.getCountryCode(); console.info("code:" + code); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.reassociate9+ reassociate(): void 重新关联网络。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.reassociate(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.reconnect9+ reconnect(): void 重新连接网络。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| | 2501001 | Wifi is closed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.reconnect(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getDeviceConfigs9+ getDeviceConfigs():  Array<[WifiDeviceConfig](#wifideviceconfig)> 获取网络配置。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | |  Array<[WifiDeviceConfig](#wifideviceconfig)> | 网络配置信息的数组。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let configs = wifiManager.getDeviceConfigs(); console.info("configs:" + JSON.stringify(configs)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.updateNetwork9+ updateNetwork(config: WifiDeviceConfig): number 更新网络配置。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiDeviceConfig](#wifideviceconfig) | 是 | WLAN配置信息。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | number | 返回更新的网络配置ID,如果值为-1表示更新失败。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid : "****", preSharedKey : "****", securityType : 3 } let ret = wifiManager.updateNetwork(config); console.error("ret:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.disableNetwork9+ disableNetwork(netId: number): void 去使能网络配置。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | netId | number | 是 | 网络配置ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let netId = 0; wifiManager.disableNetwork(netId); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.removeAllNetwork9+ removeAllNetwork(): void 移除所有网络配置。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.removeAllNetwork(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.removeDevice9+ removeDevice(id: number): void 移除指定的网络配置。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | id | number | 是 | 网络配置ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let id = 0; wifiManager.removeDevice(id); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.isBandTypeSupported10+ isBandTypeSupported(bandType: WifiBandType): boolean 判断当前频段是否支持。 **需要权限:** ohos.permission.GET_WIFI_INFO。 **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | bandType | WifiBandType | 是 | Wifi 频段类型。 | **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:支持, false:不支持。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let type = 0; let isBandTypeSupported = wifiManager.isBandTypeSupported(type); console.info("isBandTypeSupported:" + isBandTypeSupported); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.get5GChannelList10+ get5GChannelList(): Array<number> 获取当前设备支持的5G信道列表。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **返回值:** | **类型** | **说明** | | -------- | -------- | |  Array<number> | 设备支持的5G信道列表。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let channelList = wifiManager.get5GChannelList(); console.info("channelList:" + JSON.stringify(channelList)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getDisconnectedReason10+ getDisconnectedReason(): DisconnectedReason 获取最近一次断连原因 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.STA **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **返回值:** | **类型** | **说明** | | -------- | -------- | | DisconnectedReason | 最近断开的原因 | **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let disconnectedReason = wifiManager.getDisconnectedReason(); console.info("disconnectedReason:" + disconnectedReason); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## DisconnectedReason 10+ 表示wifi断开原因的枚举。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.STA | 名称 | 值 | 说明 | | -------- | -------- | -------- | | DISC_REASON_DEFAULT | 0 | 默认原因。 | | DISC_REASON_WRONG_PWD | 1 | 密码错误。 | | DISC_REASON_CONNECTION_FULL | 2 | 路由器的连接数已达到最大数量限制。 | ## wifiManager.enableHotspot9+ enableHotspot(): void 使能热点,异步接口,是否打开成功需要注册并监听hotspotStateChange的回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.enableHotspot(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.disableHotspot9+ disableHotspot(): void 去使能热点 ,异步接口,是否关闭成功需要注册并监听hotspotStateChange的回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.disableHotspot(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.isHotspotDualBandSupported9+ isHotspotDualBandSupported(): boolean 热点是否支持双频。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:支持, false:不支持.| **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let ret = wifiManager.isHotspotDualBandSupported(); console.info("result:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.isHotspotActive9+ isHotspotActive(): boolean 热点是否已使能。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.AP.Core **返回值:** | **类型** | **说明** | | -------- | -------- | | boolean | true:已使能, false:未使能.| **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let ret = wifiManager.isHotspotActive(); console.info("result:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.setHotspotConfig9+ setHotspotConfig(config: HotspotConfig): void 设置热点配置信息。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.AP.Core **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | config | [HotspotConfig](#hotspotconfig9) | 是 | 热点配置信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { ssid: "****", securityType: 3, band: 0, channel: 0, preSharedKey: "****", maxConn: 0 } let ret = wifiManager.setHotspotConfig(); console.info("result:" + ret); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## HotspotConfig9+ 热点配置信息。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | ssid | string | 是 | 是 | 热点的SSID,编码格式为UTF-8。 | | securityType | [WifiSecurityType](#wifisecuritytype) | 是 | 是 | 加密类型。 | | band | number | 是 | 是 | 热点的带宽。1: 2.4G, 2: 5G, 3: 双模频段 | | channel10+ | number | 是 | 是 | 热点的信道(2.4G:1~14,5G:7~196,双模频段:暂不支持)。 | | preSharedKey | string | 是 | 是 | 热点的密钥。 | | maxConn | number | 是 | 是 | 最大设备连接数。 | ## wifiManager.getHotspotConfig9+ getHotspotConfig(): HotspotConfig 获取热点配置信息。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.AP.Core **返回值:** | **类型** | **说明** | | -------- | -------- | | [HotspotConfig](#hotspotconfig9) | 热点的配置信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = wifiManager.getHotspotConfig(); console.info("result:" + JSON.stringify(config)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getStations9+ getStations():  Array<[StationInfo](#stationinfo9)> 获取连接的设备。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION 和 ohos.permission.MANAGE_WIFI_HOTSPOT,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core **返回值:** | **类型** | **说明** | | -------- | -------- | |  Array<[StationInfo](#stationinfo9)> | 连接的设备数组。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的macAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let stations = wifiManager.getStations(); console.info("result:" + JSON.stringify(stations)); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## StationInfo9+ 接入的设备信息。 **系统接口:** 此接口为系统接口。 **系统能力:** SystemCapability.Communication.WiFi.AP.Core | **名称** | **类型** | **可读** | **可写** | **说明** | | -------- | -------- | -------- | -------- | -------- | | name | string | 是 | 否 | 设备名称。 | | macAddress | string | 是 | 否 | MAC地址。 | | macAddressType10+ | DeviceAddressType | 是 | 否 | MAC地址类型。 | | ipAddress | string | 是 | 否 | IP地址。 | ## wifiManager.getP2pLinkedInfo9+ getP2pLinkedInfo(): Promise<WifiP2pLinkedInfo> 获取P2P连接信息,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pLinkedInfo](#wifip2plinkedinfo9)> | Promise对象。表示P2P连接信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getP2pLinkedInfo((err, data) => { if (err) { console.error("get p2p linked info error"); return; } console.info("get wifi p2p linked info: " + JSON.stringify(data)); }); wifiManager.getP2pLinkedInfo().then(data => { console.info("get wifi p2p linked info: " + JSON.stringify(data)); }); ``` ## WifiP2pLinkedInfo9+ 提供WLAN连接的相关信息。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | connectState | [P2pConnectState](#p2pconnectstate9) | 是 | 否 | P2P连接状态。 | | isGroupOwner | boolean | 是 | 否 | 是否是群主。 | | groupOwnerAddr | string | 是 | 否 | 群组MAC地址。 ## P2pConnectState9+ 表示P2P连接状态的枚举。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 值 | 说明 | | -------- | -------- | -------- | | DISCONNECTED | 0 | 断开状态。 | | CONNECTED | 1 | 连接状态。 | ## wifiManager.getP2pLinkedInfo9+ getP2pLinkedInfo(callback: AsyncCallback<WifiP2pLinkedInfo>): void 获取P2P连接信息,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pLinkedInfo](#wifip2plinkedinfo9)> | 是 | 回调函数。当操作成功时,err为0,data表示P2P连接信息。如果error为非0,表示处理出现错误。 | ## wifiManager.getCurrentP2pGroup9+ getCurrentP2pGroup(): Promise<WifiP2pGroupInfo> 获取P2P当前组信息,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pGroupInfo](#wifip2pgroupinfo9)> | Promise对象。表示当前组信息。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.getCurrentP2pGroup9+ getCurrentP2pGroup(callback: AsyncCallback<WifiP2pGroupInfo>): void 获取P2P当前组信息,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pGroupInfo](#wifip2pgroupinfo9)> | 是 | 回调函数。当操作成功时,err为0,data表示当前组信息。如果error为非0,表示处理出现错误。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getCurrentP2pGroup((err, data) => { if (err) { console.error("get current P2P group error"); return; } console.info("get current P2P group: " + JSON.stringify(data)); }); wifiManager.getCurrentP2pGroup().then(data => { console.info("get current P2P group: " + JSON.stringify(data)); }); ``` ## wifiManager.getP2pPeerDevices9+ getP2pPeerDevices(): Promise<WifiP2pDevice[]> 获取P2P对端设备列表信息,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pDevice[]](#wifip2pdevice9)> | Promise对象。表示对端设备列表信息。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.getP2pPeerDevices9+ getP2pPeerDevices(callback: AsyncCallback<WifiP2pDevice[]>): void 获取P2P对端设备列表信息,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pDevice[]](#wifip2pdevice9)> | 是 | 回调函数。当操作成功时,err为0,data表示对端设备列表信息。如果error为非0,表示处理出现错误。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getP2pPeerDevices((err, data) => { if (err) { console.error("get P2P peer devices error"); return; } console.info("get P2P peer devices: " + JSON.stringify(data)); }); wifiManager.getP2pPeerDevices().then(data => { console.info("get P2P peer devices: " + JSON.stringify(data)); }); ``` ## WifiP2pDevice9+ 表示P2P设备信息。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | deviceName | string | 是 | 否 | 设备名称。 | | deviceAddress | string | 是 | 否 | 设备MAC地址。 | | deviceAddressType10+ | DeviceAddressType | 是 | 否 | 设备MAC地址类型。 | | primaryDeviceType | string | 是 | 否 | 主设备类型。 | | deviceStatus | [P2pDeviceStatus](#p2pdevicestatus9) | 是 | 否 | 设备状态。 | | groupCapabilities | number | 是 | 否 | 群组能力。 | ## P2pDeviceStatus9+ 表示设备状态的枚举。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 值 | 说明 | | -------- | -------- | -------- | | CONNECTED | 0 | 连接状态。 | | INVITED | 1 | 邀请状态。 | | FAILED | 2 | 失败状态。 | | AVAILABLE | 3 | 可用状态。 | | UNAVAILABLE | 4 | 不可用状态。 | ## wifiManager.getP2pLocalDevice9+ getP2pLocalDevice(): Promise<WifiP2pDevice> 获取P2P本端设备信息,使用Promise异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.P2P **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise<[WifiP2pDevice](#wifip2pdevice9)> | Promise对象。表示本端设备信息。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.getP2pLocalDevice9+ getP2pLocalDevice(callback: AsyncCallback<WifiP2pDevice>): void 获取P2P本端设备信息,使用callback异步回调。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback<[WifiP2pDevice](#wifip2pdevice9)> | 是 | 回调函数。当操作成功时,err为0,data表示本端设备信息。如果error为非0,表示处理出现错误。 | **错误码:** | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getP2pLocalDevice((err, data) => { if (err) { console.error("get P2P local device error"); return; } console.info("get P2P local device: " + JSON.stringify(data)); }); wifiManager.getP2pLocalDevice().then(data => { console.info("get P2P local device: " + JSON.stringify(data)); }); ``` ## wifiManager.createGroup9+ createGroup(config: WifiP2PConfig): void 创建群组。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | 必填 | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiP2PConfig](#wifip2pconfig9) | 是 | 群组配置信息。如果DeviceAddressType未指定值,则DeviceAddressType默认为随机设备地址类型。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let config = { deviceAddress: "****", netId: 0, passphrase: "*****", groupName: "****", goBand: 0 } wifiManager.createGroup(config); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## WifiP2PConfig9+ 表示P2P配置信息。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | deviceAddress | string | 是 | 否 | 设备地址。 | | deviceAddressType10+| DeviceAddressType | 是 | 否 | 设备地址类型。 | | netId | number | 是 | 否 | 网络ID。创建群组时-1表示创建临时组,-2表示创建永久组。 | | passphrase | string | 是 | 否 | 群组密钥。 | | groupName | string | 是 | 否 | 群组名称。 | | goBand | [GroupOwnerBand](#groupownerband9) | 是 | 否 | 群组带宽。 | ## GroupOwnerBand9+ 表示群组带宽的枚举。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 值 | 说明 | | -------- | -------- | -------- | | GO_BAND_AUTO | 0 | 自动模式。 | | GO_BAND_2GHZ | 1 | 2GHZ。 | | GO_BAND_5GHZ | 2 | 5GHZ。 | ## wifiManager.removeGroup9+ removeGroup(): void 移除群组。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.removeGroup(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.p2pConnect9+ p2pConnect(config: WifiP2PConfig): void 执行P2P连接。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | 必填 | **说明** | | -------- | -------- | -------- | -------- | | config | [WifiP2PConfig](#wifip2pconfig9) | 是 | 连接配置信息。如果DeviceAddressType未指定值,则DeviceAddressType默认为随机设备地址类型。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pConnectionChangeFunc = result => { console.info("p2p connection change receive event: " + JSON.stringify(result)); wifiManager.getP2pLinkedInfo((err, data) => { if (err) { console.error('failed to get getP2pLinkedInfo: ' + JSON.stringify(err)); return; } console.info("get getP2pLinkedInfo: " + JSON.stringify(data)); }); } wifiManager.on("p2pConnectionChange", recvP2pConnectionChangeFunc); var recvP2pDeviceChangeFunc = result => { console.info("p2p device change receive event: " + JSON.stringify(result)); } wifiManager.on("p2pDeviceChange", recvP2pDeviceChangeFunc); var recvP2pPeerDeviceChangeFunc = result => { console.info("p2p peer device change receive event: " + JSON.stringify(result)); wifiManager.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, } wifiManager.p2pConnect(config); } } }); } wifiManager.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); var recvP2pPersistentGroupChangeFunc = () => { console.info("p2p persistent group change receive event"); wifiManager.getCurrentP2pGroup((err, data) => { if (err) { console.error('failed to get current group: ' + JSON.stringify(err)); return; } console.info("get current group: " + JSON.stringify(data)); }); } wifiManager.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); setTimeout(function() {wifiManager.off("p2pConnectionChange", recvP2pConnectionChangeFunc);}, 125 * 1000); setTimeout(function() {wifiManager.off("p2pDeviceChange", recvP2pDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifiManager.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifiManager.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);}, 125 * 1000); console.info("start discover devices -> " + wifiManager.startDiscoverDevices()); ``` ## wifiManager.p2pCancelConnect9+ p2pCancelConnect(): void 取消P2P连接。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.p2pCancelConnect(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.startDiscoverDevices10+ startDiscoverDevices(): void 开始发现设备。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.startDiscoverDevices9+ startDiscoverDevices(): void 开始发现设备。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.startDiscoverDevices(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.stopDiscoverDevices9+ stopDiscoverDevices(): void 停止发现设备。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { wifiManager.stopDiscoverDevices(); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.deletePersistentGroup9+ deletePersistentGroup(netId: number): void 删除永久组。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | 必填 | **说明** | | -------- | -------- | -------- | -------- | | netId | number | 是 | 组的ID。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let netId = 0; wifiManager.deletePersistentGroup(netId); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.getP2pGroups9+ getP2pGroups(): Promise<Array<WifiP2pGroupInfo>> 获取创建的所有P2P群组信息,使用Promise异步回调。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **返回值:** | 类型 | 说明 | | -------- | -------- | | Promise< Array<[WifiP2pGroupInfo](#wifip2pgroupinfo9)> > | Promise对象。表示所有群组信息。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; wifiManager.getP2pGroups((err, data) => { if (err) { console.error("get P2P groups error"); return; } console.info("get P2P groups: " + JSON.stringify(data)); }); wifiManager.getP2pGroups().then(data => { console.info("get P2P groups: " + JSON.stringify(data)); }); ``` ## WifiP2pGroupInfo9+ 表示P2P群组相关信息。 **系统能力:** SystemCapability.Communication.WiFi.P2P | 名称 | 类型 | 可读 | 可写 | 说明 | | -------- | -------- | -------- | -------- | -------- | | isP2pGo | boolean | 是 | 否 | 是否是群主。 | | ownerInfo | [WifiP2pDevice](#wifip2pdevice9) | 是 | 否 | 群组的设备信息。 | | passphrase | string | 是 | 否 | 群组密钥。 | | interface | string | 是 | 否 | 接口名称。 | | groupName | string | 是 | 否 | 群组名称。 | | networkId | number | 是 | 否 | 网络ID。 | | frequency | number | 是 | 否 | 群组的频率。 | | clientDevices | [WifiP2pDevice[]](#wifip2pdevice9) | 是 | 否 | 接入的设备列表信息。 | | goIpAddress | string | 是 | 否 | 群组IP地址。 | ## wifiManager.getP2pGroups9+ getP2pGroups(callback: AsyncCallback<Array<WifiP2pGroupInfo>>): void 获取创建的所有P2P群组信息,使用callback方式作为异步方法。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | 参数名 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | callback | AsyncCallback< Array<[WifiP2pGroupInfo](#wifip2pgroupinfo9)>> | 是 | 回调函数。当操作成功时,err为0,data表示所有群组信息。如果error为非0,表示处理出现错误。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.setDeviceName9+ setDeviceName(devName: string): void 设置设备名称。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION,仅系统应用可用。 **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | devName | string | 是 | 设备名称。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; try { let name = "****"; wifiManager.setDeviceName(name); }catch(error){ console.error("failed:" + JSON.stringify(error)); } ``` ## wifiManager.on('wifiStateChange')9+ on(type: "wifiStateChange", callback: Callback<number>): void 注册WLAN状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiStateChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **状态改变事件的枚举:** | **枚举值** | **说明** | | -------- | -------- | | 0 | 未激活。 | | 1 | 已激活。 | | 2 | 激活中。 | | 3 | 去激活中。 | ## wifiManager.off('wifiStateChange')9+ off(type: "wifiStateChange", callback?: Callback<number>): void 取消注册WLAN状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvPowerNotifyFunc = result => { console.info("Receive power state change event: " + result); } // Register event wifiManager.on("wifiStateChange", recvPowerNotifyFunc); // Unregister event wifiManager.off("wifiStateChange", recvPowerNotifyFunc); ``` ## wifiManager.on('wifiConnectionChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| ## wifiManager.off('wifiConnectionChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvWifiConnectionChangeFunc = result => { console.info("Receive wifi connection change event: " + result); } // Register event wifiManager.on("wifiConnectionChange", recvWifiConnectionChangeFunc); // Unregister event wifiManager.off("wifiConnectionChange", recvWifiConnectionChangeFunc); ``` ## wifiManager.on('wifiScanStateChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| ## wifiManager.off('wifiScanStateChange')9+ off(type: "wifiScanStateChange", callback?: Callback<number>): void 取消注册扫描状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiScanStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvWifiScanStateChangeFunc = result => { console.info("Receive Wifi scan state change event: " + result); } // Register event wifiManager.on("wifiScanStateChange", recvWifiScanStateChangeFunc); // Unregister event wifiManager.off("wifiScanStateChange", recvWifiScanStateChangeFunc); ``` ## wifiManager.on('wifiRssiChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| ## wifiManager.off('wifiRssiChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2501000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvWifiRssiChangeFunc = result => { console.info("Receive wifi rssi change event: " + result); } // Register event wifiManager.on("wifiRssiChange", recvWifiRssiChangeFunc); // Unregister event wifiManager.off("wifiRssiChange", recvWifiRssiChangeFunc); ``` ## wifiManager.on('streamChange')9+ on(type: "streamChange", callback: Callback<number>): void 注册WIFI流更改事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"streamChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数,返回0:无,1:向下,2:向上,3:双向。 | ## wifiManager.off('streamChange')9+ off(type: "streamChange", callback?: Callback<number>): void 取消注册WIFI流更改事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"streamChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数,返回0:无,1:向下,2:向上,3:双向。 | **示例:** ```js import wifi from '@ohos.wifi'; var recvStreamChangeFunc = result => { console.info("Receive stream change event: " + result); } // Register event wifi.on("streamChange", recvStreamChangeFunc); // Unregister event wifi.off("streamChange", recvStreamChangeFunc); ``` ## wifiManager.on('deviceConfigChange')9+ on(type: "deviceConfigChange", callback: Callback<number>): void 注册WIFI设备配置更改事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"streamChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数,返回0: 添加配置, 1: 更改配置, 2: 删除配置. | ## wifiManager.off('deviceConfigChange')9+ off(type: "deviceConfigChange", callback: Callback<number>): void 取消注册WIFI设备配置更改事件。 **需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION **系统能力:** SystemCapability.Communication.WiFi.STA **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"streamChange"字符串。 | | callback | Callback<number> | 是 | 状态改变回调函数,返回0: 添加配置, 1: 更改配置, 2: 删除配置.| **示例:** ```js import wifi from '@ohos.wifi'; var recvDeviceConfigChangeFunc = result => { console.info("Receive device config change event: " + result); } // Register event wifi.on("deviceConfigChange", recvDeviceConfigChangeFunc); // Unregister event wifi.off("deviceConfigChange", recvDeviceConfigChangeFunc); ``` ## wifiManager.on('hotspotStateChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| ## wifiManager.off('hotspotStateChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2601000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvHotspotStateChangeFunc = result => { console.info("Receive hotspot state change event: " + result); } // Register event wifiManager.on("hotspotStateChange", recvHotspotStateChangeFunc); // Unregister event wifiManager.off("hotspotStateChange", recvHotspotStateChangeFunc); ``` ## wifiManager.on('hotspotStaJoin')9+ on(type: "hotspotStaJoin", callback: Callback<StationInfo>): void 注册wifi热点sta加入事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT **系统能力:** SystemCapability.Communication.WiFi.AP.Core **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStaJoin"字符串。 | | callback | Callback<StationInfo> | 是 | 状态改变回调函数。 | ## wifiManager.off('hotspotStaJoin')9+ off(type: "hotspotStaJoin", callback?: Callback<StationInfo>): void 取消注册wifi热点sta加入事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT **系统能力:** SystemCapability.Communication.WiFi.AP.Core **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStaJoin"字符串。 | | callback | Callback<StationInfo> | 否 | 状态改变回调函数。 | **示例:** ```js import wifi from '@ohos.wifi'; var recvHotspotStaJoinFunc = result => { console.info("Receive hotspot sta join event: " + result); } // Register event wifi.on("hotspotStaJoin", recvHotspotStaJoinFunc); // Unregister event wifi.off("hotspotStaJoin", recvHotspotStaJoinFunc); ``` ## wifiManager.on('hotspotStaLeave')9+ on(type: "hotspotStaLeave", callback: Callback<StationInfo>): void 注册wifi热点sta离开事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT **系统能力:** SystemCapability.Communication.WiFi.AP.Core **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStaLeave"字符串。 | | callback | Callback<StationInf]> | 是 | 状态改变回调函数。 | ## wifiManager.off('hotspotStaLeave')9+ off(type: "hotspotStaLeave", callback?: Callback<StationInfo>): void 取消注册wifi热点sta离开事件。 **系统接口:** 此接口为系统接口。 **需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT **系统能力:** SystemCapability.Communication.WiFi.AP.Core **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"hotspotStaLeave"字符串。 | | callback | Callback<StationInf]> | 是 | 状态改变回调函数。 | **示例:** ```js import wifi from '@ohos.wifi'; var recvHotspotStaLeaveFunc = result => { console.info("Receive hotspot sta leave event: " + result); } // Register event wifi.on("hotspotStaLeave", recvHotspotStaLeaveFunc); // Unregister event wifi.off("hotspotStaLeave", recvHotspotStaLeaveFunc); ``` ## wifiManager.on('p2pStateChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pStateChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pStateChangeFunc = result => { console.info("Receive p2p state change event: " + result); } // Register event wifiManager.on("p2pStateChange", recvP2pStateChangeFunc); // Unregister event wifiManager.off("p2pStateChange", recvP2pStateChangeFunc); ``` ## wifiManager.on('p2pConnectionChange')9+ on(type: "p2pConnectionChange", callback: Callback<WifiP2pLinkedInfo>): void 注册P2P连接状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pConnectionChange"字符串。 | | callback | Callback<[WifiP2pLinkedInfo](#wifip2plinkedinfo9)> | 是 | 状态改变回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pConnectionChange')9+ off(type: "p2pConnectionChange", callback?: Callback<WifiP2pLinkedInfo>): void 取消注册P2P连接状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pConnectionChange"字符串。 | | callback | Callback<[WifiP2pLinkedInfo](#wifip2plinkedinfo9)> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pConnectionChangeFunc = result => { console.info("Receive p2p connection change event: " + result); } // Register event wifiManager.on("p2pConnectionChange", recvP2pConnectionChangeFunc); // Unregister event wifiManager.off("p2pConnectionChange", recvP2pConnectionChangeFunc); ``` ## wifiManager.on('p2pDeviceChange')9+ on(type: "p2pDeviceChange", callback: Callback<WifiP2pDevice>): void 注册P2P设备状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice](#wifip2pdevice9)> | 是 | 状态改变回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pDeviceChange')9+ off(type: "p2pDeviceChange", callback?: Callback<WifiP2pDevice>): void 取消注册P2P设备状态改变事件。 **需要权限:** ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice](#wifip2pdevice9)> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pDeviceChangeFunc = result => { console.info("Receive p2p device change event: " + result); } // Register event wifiManager.on("p2pDeviceChange", recvP2pDeviceChangeFunc); // Unregister event wifiManager.off("p2pDeviceChange", recvP2pDeviceChangeFunc); ``` ## wifiManager.on('p2pPeerDeviceChange')9+ on(type: "p2pPeerDeviceChange", callback: Callback<WifiP2pDevice[]>): void 注册P2P对端设备状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO 和 ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pPeerDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice[]](#wifip2pdevice9)> | 是 | 状态改变回调函数。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pPeerDeviceChange')9+ off(type: "p2pPeerDeviceChange", callback?: Callback<WifiP2pDevice[]>): void 取消注册P2P对端设备状态改变事件。 **需要权限:** ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pPeerDeviceChange"字符串。 | | callback | Callback<[WifiP2pDevice[]](#wifip2pdevice9)> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限,则返回结果中的deviceAddress为真实设备地址,否则为随机设备地址。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pPeerDeviceChangeFunc = result => { console.info("Receive p2p peer device change event: " + result); } // Register event wifiManager.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); // Unregister event wifiManager.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); ``` ## wifiManager.on('p2pPersistentGroupChange')9 on(type: "p2pPersistentGroupChange", callback: Callback<void>): void 注册P2P永久组状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pPersistentGroupChange"字符串。 | | callback | Callback<void> | 是 | 状态改变回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pPersistentGroupChange')9 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pPersistentGroupChangeFunc = result => { console.info("Receive p2p persistent group change event: " + result); } // Register event wifiManager.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); // Unregister event wifiManager.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); ``` ## wifiManager.on('p2pDiscoveryChange')9+ 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错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| ## wifiManager.off('p2pDiscoveryChange')9+ off(type: "p2pDiscoveryChange", callback?: Callback<number>): void 取消注册发现设备状态改变事件。 **需要权限:** ohos.permission.GET_WIFI_INFO **系统能力:** SystemCapability.Communication.WiFi.P2P **参数:** | **参数名** | **类型** | **必填** | **说明** | | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"p2pDiscoveryChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填,将取消注册该事件关联的所有回调函数。 | **错误码:** 以下错误码的详细介绍请参见[WIFI错误码](../errorcodes/errorcode-wifi.md)。 | **错误码ID** | **错误信息** | | -------- | -------- | | 2801000 | Operation failed.| **示例:** ```js import wifiManager from '@ohos.wifiManager'; var recvP2pDiscoveryChangeFunc = result => { console.info("Receive p2p discovery change event: " + result); } // Register event wifiManager.on("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc); // Unregister event wifiManager.off("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc); ```