harmony 鸿蒙@ohos.wifiManager (WLAN)（系统接口）

2025-06-12
浏览 (6)

@ohos.wifiManager (WLAN)（系统接口）

该模块主要提供WLAN基础功能、P2P（peer-to-peer）功能和WLAN消息通知的相应服务，让应用可以通过WLAN和其他设备互联互通。

说明： 本模块首批接口从API version 6开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.wifiManager (WLAN)。

导入模块

import { wifiManager } from '@kit.ConnectivityKit';

wifiManager.disableWifi⁹⁺

disableWifi(): void

去使能WLAN，异步接口，需要通过注册”wifiStateChange”事件的回调来监听是否关闭成功。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501004	Operation failed because the service is being opened.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.disableWifi();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.enableSemiWifi¹²⁺

enableSemiWifi(): void

使能WLAN半关闭（STA关闭、其他P2p、Hml可用），异步接口，需要通过注册”wifiStateChange”事件的回调来监听是否使能成功。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION 仅系统应用可用。

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501004	Operation failed because the service is being opened.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.enableSemiWifi();
	} catch(error) {
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.startScan¹⁰⁺

startScan(): void

系统接口： 此接口为系统接口。

启动WLAN扫描。

需要权限： ohos.permission.SET_WIFI_INFO 和ohos.permission.MANAGE_WIFI_CONNECTION

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.startScan();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.setScanAlwaysAllowed¹⁰⁺

setScanAlwaysAllowed(isScanAlwaysAllowed: boolean): void

设置是否始终允许扫描。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG(仅系统应用可申请)

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

参数：

参数名	类型	必填	说明
isScanAlwaysAllowed	boolean	是	是否始终允许扫描。true:允许扫描， false:不允许扫描

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2501000	Operation failed.

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let isScanAlwaysAllowed = true;
		wifiManager.setScanAlwaysAllowed(isScanAlwaysAllowed);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getScanAlwaysAllowed¹⁰⁺

getScanAlwaysAllowed(): boolean

获取是否始终允许扫描。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG(仅系统应用可申请)

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

返回值：

类型	说明
boolean	是否始终允许扫描。 true 表示允许触发扫描，false表示在禁用wifi时不允许触发扫描。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let isScanAlwaysAllowed = wifiManager.getScanAlwaysAllowed();
		console.info("isScanAlwaysAllowed:" + isScanAlwaysAllowed);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

WifiDeviceConfig⁹⁺

WLAN配置信息。

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

名称	类型	只读	可选	说明
creatorUid	number	是	是	创建用户的ID。系统接口：此接口为系统接口。
disableReason	number	是	是	禁用原因： -1 - 未知原因，0 - 未禁用，1 - 关联拒绝，2 - 认证失败 3 - DHCP失败，4 - 暂时无互联网连接 5 - 认证无凭据，6 - 永久无互联网连接 7 - 由WIFI管理器禁用，8 - 由于密码错误禁用 9 - 认证无订阅，10 - 私有EAP认证错误 11 - 未找到网络，12 - 连续失败 13 - 由系统禁用，14 - EAP-AKA认证失败 15 - 解除关联原因，16 - 禁用网络选择最大值系统接口：此接口为系统接口。
netId	number	是	是	分配的网络ID。系统接口：此接口为系统接口。
randomMacType	number	是	是	MAC地址类型。0 - 随机MAC地址，1 - 设备MAC地址系统接口：此接口为系统接口。
randomMacAddr	string	是	是	MAC地址。系统接口：此接口为系统接口。
ipType	IpType	是	是	IP地址类型。系统接口：此接口为系统接口。
staticIp	IpConfig	是	是	静态IP配置信息。系统接口：此接口为系统接口。
proxyConfig¹⁰⁺	WifiProxyConfig	是	是	代理配置。系统接口：此接口为系统接口。
configStatus¹²⁺	number	是	是	返回当前网络是否允许参与选网。 1 - 允许参与选网，2 - 禁止参与 3 - 永久禁止参与，4 - 未知系统接口：此接口为系统接口。
isAutoConnectAllowed¹⁷⁺	boolean	是	是	是否允许自动连接。false:不允许，true：允许自动连接。系统接口：此接口为系统接口。
isSecureWifi²⁰⁺	boolean	是	是	安全WiFi检测。false:不是安全Wifi，true：是安全WiFi。系统接口：此接口为系统接口。

IpType⁹⁺

表示IP类型的枚举。

系统接口： 此接口为系统接口。

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

名称	值	说明
STATIC	0	静态IP。
DHCP	1	通过DHCP获取。
UNKNOWN	2	未指定。

IpConfig⁹⁺

IP配置信息。

系统接口： 此接口为系统接口。

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

名称	类型	只读	可选	说明
ipAddress	number	是	否	IP地址。
gateway	number	是	否	网关。
prefixLength	number	是	否	掩码。
dnsServers	number[]	是	否	DNS服务器。
domains	Array<string>	是	否	域信息。

WifiProxyConfig¹⁰⁺

Wifi 代理配置。

系统接口： 此接口为系统接口。

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

名称	类型	只读	可选	说明
proxyMethod	ProxyMethod	是	是	代理方法。
pacWebAddress	string	是	是	自动配置代理的PAC web 地址。
serverHostName	string	是	是	手动配置代理的服务器主机名。
serverPort	number	是	是	手动配置代理的服务器端口。
exclusionObjects	string	是	是	手动配置代理的排除对象，对象用“,”分隔。

ProxyMethod¹⁰⁺

表示WiFi代理方法的枚举。

系统接口： 此接口为系统接口。

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

名称	值	说明
METHOD_NONE	0	不使用代理。
METHOD_AUTO	1	使用自动配置的代理。
METHOD_MANUAL	2	使用手动配置的代理。

wifiManager.connectToDevice⁹⁺

connectToDevice(config: WifiDeviceConfig): void

连接到指定网络（如果当前已经连接到热点，请先使用disconnect（）接口断开连接）。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG（仅系统应用可申请）和 ohos.permission.MANAGE_WIFI_CONNECTION（仅系统应用可申请）。

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

参数：

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。如果bssidType未指定值，则bssidType默认为随机设备地址类型。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config:wifiManager.WifiDeviceConfig = {
			ssid : "****",
			preSharedKey : "****",
			securityType : 3
		}
		wifiManager.connectToDevice(config);
				
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

WifiLinkedInfo⁹⁺

提供WLAN连接的相关信息。

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

名称	类型	只读	可选	说明
networkId	number	是	否	网络配置ID。系统接口：此接口为系统接口。
chload	number	是	否	连接负载，值越大表示负载约高。系统接口：此接口为系统接口。
snr	number	是	否	信噪比。系统接口：此接口为系统接口。
suppState	SuppState	是	否	请求状态。系统接口：此接口为系统接口。

SuppState⁹⁺

表示请求状态的枚举。

系统接口： 此接口为系统接口。

系统能力： 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.getSupportedFeatures⁹⁺

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错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2401000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let ret = wifiManager.getSupportedFeatures();
		console.info("supportedFeatures:" + ret);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getDeviceMacAddress¹⁵⁺

getDeviceMacAddress(): string[]

获取设备的MAC地址。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_LOCAL_MAC 和 ohos.permission.GET_WIFI_INFO，仅系统应用可用。

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

返回值：

类型	说明
string[]	MAC地址。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let ret = wifiManager.getDeviceMacAddress();
		console.info("deviceMacAddress:" + JSON.stringify(ret));
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getWifiDetailState¹²⁺

getWifiDetailState(): WifiDetailState

获取Wifi开关详细状态。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

返回值：

类型	说明
WifiDetailState	Wifi枚举状态。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let ret = wifiManager.getWifiDetailState();
		console.info("wifiDetailState:" + ret);
	} catch(error) {
		console.error("failed:" + JSON.stringify(error));
	}

WifiDetailState¹²⁺

表示Wifi开关状态的枚举。

系统接口： 此接口为系统接口。

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

名称	值	说明
UNKNOWN	-1	未指定。
INACTIVE	0	已关闭。
ACTIVATED	1	已激活。
ACTIVATING	2	激活中。
DEACTIVATING	3	关闭中。
SEMI_ACTIVATING	4	半关闭中。
SEMI_ACTIVE	5	已半关闭。

wifiManager.reassociate⁹⁺

reassociate(): void

重新关联网络。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.reassociate();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.reconnect⁹⁺

reconnect(): void

重新连接网络。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.reconnect();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.updateNetwork⁹⁺

updateNetwork(config: WifiDeviceConfig): number

更新网络配置。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.SET_WIFI_CONFIG(仅系统应用可申请)

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

参数：

参数名	类型	必填	说明
config	WifiDeviceConfig	是	WLAN配置信息。

返回值：

类型	说明
number	返回更新的网络配置ID，如果值为-1表示更新失败。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config:wifiManager.WifiDeviceConfig = {
			ssid : "****",
			preSharedKey : "****",
			securityType : 3
		}
		let ret = wifiManager.updateNetwork(config);
		console.info("ret:" + ret);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.disableNetwork⁹⁺

disableNetwork(netId: number): void

去使能网络配置。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

参数：

参数名	类型	必填	说明
netId	number	是	网络配置ID。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let netId = 0;
		wifiManager.disableNetwork(netId);		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.removeAllNetwork⁹⁺

removeAllNetwork(): void

移除所有网络配置。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.removeAllNetwork();		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.get5GChannelList¹⁰⁺

get5GChannelList(): Array<number>

获取当前设备支持的5G信道列表。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG(仅系统应用可申请)

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

返回值：

类型	说明
Array<number>	设备支持的5G信道列表。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let channelList = wifiManager.get5GChannelList();
		console.info("channelList:" + JSON.stringify(channelList));		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getDisconnectedReason¹⁰⁺

getDisconnectedReason(): DisconnectedReason

获取最近一次断连原因。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG(仅系统应用可申请)

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
801	Capability not supported.
2501000	Operation failed.

返回值：

类型	说明
DisconnectedReason	最近断开的原因

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let disconnectedReason = wifiManager.getDisconnectedReason();	
        console.info("disconnectedReason:" + disconnectedReason);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

DisconnectedReason ¹⁰⁺

表示wifi断开原因的枚举。

系统接口： 此接口为系统接口。

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

名称	值	说明
DISC_REASON_DEFAULT	0	默认原因。
DISC_REASON_WRONG_PWD	1	密码错误。
DISC_REASON_CONNECTION_FULL	2	路由器的连接数已达到最大数量限制。

wifiManager.startPortalCertification¹¹⁺

startPortalCertification(): void

系统接口： 此接口为系统接口。

启动portal认证。

需要权限： ohos.permission.SET_WIFI_INFO 和ohos.permission.MANAGE_WIFI_CONNECTION

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.startPortalCertification();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.enableHiLinkHandshake¹²⁺

enableHiLinkHandshake(isHiLinkEnable: boolean, bssid: string, config: WifiDeviceConfig): void

系统接口： 此接口为系统接口。

设置是否使能hiLink。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION

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

参数：

参数名	类型	必填	说明
isHiLinkEnable	boolean	是	是否使能hiLink。true:使能， false:去使能。
bssid	string	是	热点的mac地址，例如：00:11:22:33:44:55。
config	WifiDeviceConfig	是	WLAN的配置信息。config.bssid必须和第二个参数bssid保持一致。如果bssidType未指定值，则bssidType默认为随机设备地址类型。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.
801	Capability not supported.
2501000	Operation failed.
2501001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';
	// config数据可以通过getScanInfoList接口获取，只有WifiScanInfo.isHiLinkNetwork为true的热点，才能正常使用该接口
	let config:wifiManager.WifiDeviceConfig = {
		ssid : "****",
		preSharedKey : "****",
		securityType : 0,
		bssid : "38:37:8b:80:bf:cc",
		bssidType : 1,
		isHiddenSsid : false
	}	
	try {
		wifiManager.enableHiLinkHandshake(true, config.bssid, config);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.factoryReset¹¹⁺

factoryReset(): void

系统接口： 此接口为系统接口。

重置wifi相关配置。

需要权限： ohos.permission.SET_WIFI_INFO 和ohos.permission.SET_WIFI_CONFIG(仅系统应用可申请)

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

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2501000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.factoryReset();
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.enableHotspot⁹⁺

enableHotspot(): void

使能热点，异步接口，是否打开成功需要注册并监听hotspotStateChange的回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.enableHotspot();	
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.disableHotspot⁹⁺

disableHotspot(): void

去使能热点，异步接口，是否关闭成功需要注册并监听hotspotStateChange的回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		wifiManager.disableHotspot();	
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.isHotspotDualBandSupported⁹⁺

isHotspotDualBandSupported(): boolean

热点是否支持双频。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

返回值：

类型	说明
boolean	true:支持， false:不支持。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let ret = wifiManager.isHotspotDualBandSupported();
		console.info("result:" + ret);		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.isOpenSoftApAllowed¹⁸⁺

isOpenSoftApAllowed(): boolean

热点是否支持双频。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

返回值：

类型	说明
boolean	true:允许， false:不允许。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let ret = wifiManager.isOpenSoftApAllowed();
		console.info("result:" + ret);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.setHotspotConfig⁹⁺

setHotspotConfig(config: HotspotConfig): void

设置热点配置信息。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG(仅系统应用可申请)

系统能力： SystemCapability.Communication.WiFi.AP.Core

参数：

参数名	类型	必填	说明
config	HotspotConfig	是	热点配置信息。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Incorrect parameter types. 2. Parameter verification failed.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config:wifiManager.HotspotConfig = {
			ssid: "****",
			securityType: 3,
			band: 0,
			channel: 0,
			preSharedKey: "****",
			maxConn: 0
		}
		let ret = wifiManager.setHotspotConfig(config);
		console.info("result:" + ret);		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

HotspotConfig⁹⁺

热点配置信息。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Communication.WiFi.AP.Core

名称	类型	只读	可选	说明
ssid	string	是	否	热点的SSID，编码格式为UTF-8。
securityType	WifiSecurityType	是	否	加密类型。
band	number	是	否	热点的带宽。1: 2.4G, 2: 5G, 3: 双模频段
channel¹⁰⁺	number	是	是	热点的信道（2.4G：1~14,5G：7~196）。
preSharedKey	string	否	否	热点的密钥。
maxConn	number	是	否	最大设备连接数。
ipAddress	string	是	是	DHCP服务器的IP地址。

wifiManager.getHotspotConfig⁹⁺

getHotspotConfig(): HotspotConfig

获取热点配置信息。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.GET_WIFI_CONFIG(仅系统应用可申请)

系统能力： SystemCapability.Communication.WiFi.AP.Core

返回值：

类型	说明
HotspotConfig	热点的配置信息。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config = wifiManager.getHotspotConfig();
		console.info("result:" + JSON.stringify(config));		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getStations⁹⁺

getStations():  Array<StationInfo>

获取连接的设备。

系统接口： 此接口为系统接口。

需要权限：

API 9：ohos.permission.GET_WIFI_INFO、ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

API 10起：ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

返回值：

类型	说明
Array<StationInfo>	连接的设备数组。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限，则返回结果中的macAddress为真实设备地址，否则为随机设备地址。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let stations = wifiManager.getStations();
		console.info("result:" + JSON.stringify(stations));		
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

StationInfo⁹⁺

接入的设备信息。

系统接口： 此接口为系统接口。

系统能力： SystemCapability.Communication.WiFi.AP.Core

名称	类型	只读	可选	说明
name	string	是	否	设备名称。
macAddress	string	是	否	MAC地址。
macAddressType¹⁰⁺	DeviceAddressType	是	是	MAC地址类型。
ipAddress	string	是	否	IP地址。

wifiManager.addHotspotBlockList¹¹⁺

addHotspotBlockList(stationInfo: StationInfo)

将设备添加到热点的阻止连接设备列表中，列表中的设备将不能访问热点。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

参数：

参数名	类型	必填	说明
stationInfo	StationInfo	是	将添加到热点的阻止列表中的设备。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Incorrect parameter types. 2. Parameter verification failed.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config:wifiManager.StationInfo = {
			name : "testSsid",
			macAddress : "11:22:33:44:55:66",
			ipAddress : "192.168.1.111"
		}
		// 热点开启后，才能正常将设备添加到连接阻止列表中
		wifiManager.addHotspotBlockList(config);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.delHotspotBlockList¹¹⁺

delHotspotBlockList(stationInfo: StationInfo)

将设备从热点的阻止列表中删除。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

参数：

参数名	类型	必填	说明
stationInfo	StationInfo	是	将从热点的阻止列表中删除的设备。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Incorrect parameter types. 2. Parameter verification failed.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let config:wifiManager.StationInfo = {
			name : "testSsid",
			macAddress : "11:22:33:44:55:66",
			ipAddress : "192.168.1.111"
		}
		wifiManager.delHotspotBlockList(config);
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getHotspotBlockList¹¹⁺

getHotspotBlockList(): Array<StationInfo>

获取热点的阻止列表。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_HOTSPOT，仅系统应用可用。

系统能力： SystemCapability.Communication.WiFi.AP.Core

返回值：

类型	说明
Array<StationInfo>	热点的阻止列表。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified.
801	Capability not supported.
2601000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let data = wifiManager.getHotspotBlockList();
		console.info("result:" + JSON.stringify(data));
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.deletePersistentGroup⁹⁺

deletePersistentGroup(netId: number): void

删除永久组。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION

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

参数：

参数名	类型	必填	说明
netId	number	是	组的ID。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1.Incorrect parameter types.
801	Capability not supported.
2801000	Operation failed.
2801001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let netId = 0;
		wifiManager.deletePersistentGroup(netId);	
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.getP2pGroups⁹⁺

getP2pGroups(): Promise<Array<WifiP2pGroupInfo>>

获取创建的所有P2P群组信息，使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限：

API 9：ohos.permission.GET_WIFI_INFO、ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

API 10起：ohos.permission.GET_WIFI_INFO

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

返回值：

类型	说明
Promise< Array<WifiP2pGroupInfo> >	Promise对象。表示所有群组信息。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限，则返回结果中的deviceAddress为真实设备地址，否则为随机设备地址。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2801000	Operation failed.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	wifiManager.getP2pGroups((err, data:wifiManager.WifiP2pGroupInfo) => {
    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));
	});

wifiManager.getP2pGroups⁹⁺

getP2pGroups(callback: AsyncCallback<Array<WifiP2pGroupInfo>>): void

获取创建的所有P2P群组信息，使用callback方式作为异步方法。

系统接口： 此接口为系统接口。

需要权限：

API 9：ohos.permission.GET_WIFI_INFO、ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

API 10起：ohos.permission.GET_WIFI_INFO

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

参数：

参数名	类型	必填	说明
callback	AsyncCallback< Array<WifiP2pGroupInfo>>	是	回调函数。当操作成功时，err为0，data表示所有群组信息。如果error为非0，表示处理出现错误。如果应用申请了ohos.permission.GET_WIFI_PEERS_MAC权限，则返回结果中的deviceAddress为真实设备地址，否则为随机设备地址。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
801	Capability not supported.
2801000	Operation failed.
2801001	Wi-Fi STA disabled.

wifiManager.setDeviceName⁹⁺

setDeviceName(devName: string): void

设置设备名称。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.SET_WIFI_INFO 和 ohos.permission.MANAGE_WIFI_CONNECTION，仅系统应用可用。

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

参数：

参数名	类型	必填	说明
devName	string	是	设备名称。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types. 3. Parameter verification failed.
801	Capability not supported.
2801000	Operation failed.
2801001	Wi-Fi STA disabled.

示例：

	import { wifiManager } from '@kit.ConnectivityKit';

	try {
		let name = "****";
		wifiManager.setDeviceName(name);	
	}catch(error){
		console.error("failed:" + JSON.stringify(error));
	}

wifiManager.on(‘streamChange’)⁹⁺

on(type: ‘streamChange’, callback: Callback<number>): void

注册WIFI流变更事件，在业务退出时，要调用off(type: ‘streamChange’, callback?: Callback<number>)接口去掉之前的注册回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.MANAGE_WIFI_CONNECTION

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

参数：

参数名	类型	必填	说明
type	string	是	固定填”streamChange”字符串。
callback	Callback<number>	是	状态改变回调函数，返回0:无，1：向下，2：向上，3：双向。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2501000	Operation failed.

wifiManager.off(‘streamChange’)⁹⁺

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：双向。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2501000	Operation failed.

示例：

import { wifi } from '@kit.ConnectivityKit';

let recvStreamChangeFunc = (result:number) => {
    console.info("Receive stream change event: " + result);
}

// Register event
wifi.on("streamChange", recvStreamChangeFunc);

// Unregister event
wifi.off("streamChange", recvStreamChangeFunc);

wifiManager.on(‘deviceConfigChange’)⁹⁺

on(type: ‘deviceConfigChange’, callback: Callback<number>): void

注册WIFI设备配置更改事件，在业务退出时，要调用off(type: ‘deviceConfigChange’, callback?: Callback<number>)接口去掉之前的注册回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO

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

参数：

参数名	类型	必填	说明
type	string	是	固定填”deviceConfigChange”字符串。
callback	Callback<number>	是	状态改变回调函数，返回值为 0: 添加配置。1: 更改配置。2: 删除配置。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2501000	Operation failed.

wifiManager.off(‘deviceConfigChange’)⁹⁺

off(type: ‘deviceConfigChange’, callback?: Callback<number>): void

取消注册WIFI设备配置更改事件。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_WIFI_INFO

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

参数：

参数名	类型	必填	说明
type	string	是	固定填”deviceConfigChange”字符串。
callback	Callback<number>	否	状态改变回调函数，返回值为 0: 添加配置。1: 更改配置。2: 删除配置。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2501000	Operation failed.

示例：

import { wifiManager } from '@kit.ConnectivityKit';

let recvDeviceConfigChangeFunc = (result:number) => {
    console.info("Receive device config change event: " + result);
}

// Register event
wifi.on("deviceConfigChange", recvDeviceConfigChangeFunc);

// Unregister event
wifi.off("deviceConfigChange", recvDeviceConfigChangeFunc);

wifiManager.on(‘hotspotStaJoin’)⁹⁺

on(type: ‘hotspotStaJoin’, callback: Callback<StationInfo>): void

注册wifi热点sta加入事件，在业务退出时，要调用off(type: ‘hotspotStaJoin’, callback?: Callback<StationInfo>)接口去掉之前的注册回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT

系统能力： SystemCapability.Communication.WiFi.AP.Core

参数：

参数名	类型	必填	说明
type	string	是	固定填”hotspotStaJoin”字符串。
callback	Callback<StationInfo>	是	状态改变回调函数。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2601000	Operation failed.

wifiManager.off(‘hotspotStaJoin’)⁹⁺

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>	否	状态改变回调函数。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2601000	Operation failed.

示例：

import { wifiManager } from '@kit.ConnectivityKit';

let recvHotspotStaJoinFunc = (result:wifiManager.StationInfo) => {
    console.info("Receive hotspot sta join event: " + result);
}

// Register event
wifiManager.on("hotspotStaJoin", recvHotspotStaJoinFunc);

// Unregister event
wifiManager.off("hotspotStaJoin", recvHotspotStaJoinFunc);

wifiManager.on(‘hotspotStaLeave’)⁹⁺

on(type: ‘hotspotStaLeave’, callback: Callback<StationInfo>): void

注册wifi热点sta离开事件，在业务退出时，要调用off(type: ‘hotspotStaLeave’, callback?: Callback<StationInfo>)接口去掉之前的注册回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT

系统能力： SystemCapability.Communication.WiFi.AP.Core

参数：

参数名	类型	必填	说明
type	string	是	固定填”hotspotStaLeave”字符串。
callback	Callback<StationInf]>	是	状态改变回调函数。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2601000	Operation failed.

wifiManager.off(‘hotspotStaLeave’)⁹⁺

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]>	否	状态改变回调函数。

错误码：

以下错误码的详细介绍请参见WIFI错误码。

错误码ID	错误信息
201	Permission denied.
202	System API is not allowed called by Non-system application.
401	Invalid parameters. Possible causes: 1. Mandatory parameters are left unspecified. 2. Incorrect parameter types.
801	Capability not supported.
2601000	Operation failed.

示例：

import { wifiManager } from '@kit.ConnectivityKit';

let recvHotspotStaLeaveFunc = (result:wifiManager.StationInfo) => {
    console.info("Receive hotspot sta leave event: " + result);
}

// Register event
wifiManager.on("hotspotStaLeave", recvHotspotStaLeaveFunc);

// Unregister event
wifiManager.off("hotspotStaLeave", recvHotspotStaLeaveFunc);

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Connectivity Kit（短距通信服务）

harmony 鸿蒙SE(secureElement)错误码

harmony 鸿蒙WIFI错误码

harmony 鸿蒙@ohos.bluetooth.a2dp (蓝牙a2dp模块)(系统接口)

harmony 鸿蒙@ohos.bluetooth.a2dp (蓝牙a2dp模块)

harmony 鸿蒙@ohos.bluetooth.access (蓝牙access模块)(系统接口)

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/X7IZVS

harmony 鸿蒙@ohos.wifiManager (WLAN)（系统接口）

@ohos.wifiManager (WLAN)（系统接口）

导入模块

wifiManager.disableWifi9+

wifiManager.enableSemiWifi12+

wifiManager.startScan10+

wifiManager.setScanAlwaysAllowed10+

wifiManager.getScanAlwaysAllowed10+

WifiDeviceConfig9+

IpType9+

IpConfig9+

WifiProxyConfig10+

ProxyMethod10+

wifiManager.connectToDevice9+

WifiLinkedInfo9+

SuppState9+

wifiManager.getSupportedFeatures9+

wifiManager.getDeviceMacAddress15+

wifiManager.getWifiDetailState12+

WifiDetailState12+

wifiManager.reassociate9+

wifiManager.reconnect9+

wifiManager.updateNetwork9+

wifiManager.disableNetwork9+

wifiManager.removeAllNetwork9+

wifiManager.get5GChannelList10+

wifiManager.getDisconnectedReason10+

DisconnectedReason 10+

wifiManager.startPortalCertification11+

wifiManager.enableHiLinkHandshake12+

wifiManager.factoryReset11+

wifiManager.enableHotspot9+

wifiManager.disableHotspot9+

wifiManager.isHotspotDualBandSupported9+

wifiManager.isOpenSoftApAllowed18+

wifiManager.setHotspotConfig9+

HotspotConfig9+

wifiManager.getHotspotConfig9+

wifiManager.getStations9+

StationInfo9+

wifiManager.addHotspotBlockList11+

wifiManager.delHotspotBlockList11+

wifiManager.getHotspotBlockList11+

wifiManager.deletePersistentGroup9+

wifiManager.getP2pGroups9+

wifiManager.getP2pGroups9+

wifiManager.setDeviceName9+

wifiManager.on(‘streamChange’)9+

wifiManager.off(‘streamChange’)9+

wifiManager.on(‘deviceConfigChange’)9+

wifiManager.off(‘deviceConfigChange’)9+

wifiManager.on(‘hotspotStaJoin’)9+

wifiManager.off(‘hotspotStaJoin’)9+

wifiManager.on(‘hotspotStaLeave’)9+

wifiManager.off(‘hotspotStaLeave’)9+

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

wifiManager.disableWifi⁹⁺

wifiManager.enableSemiWifi¹²⁺

wifiManager.startScan¹⁰⁺

wifiManager.setScanAlwaysAllowed¹⁰⁺

wifiManager.getScanAlwaysAllowed¹⁰⁺

WifiDeviceConfig⁹⁺

IpType⁹⁺

IpConfig⁹⁺

WifiProxyConfig¹⁰⁺

ProxyMethod¹⁰⁺

wifiManager.connectToDevice⁹⁺

WifiLinkedInfo⁹⁺

SuppState⁹⁺

wifiManager.getSupportedFeatures⁹⁺

wifiManager.getDeviceMacAddress¹⁵⁺

wifiManager.getWifiDetailState¹²⁺

WifiDetailState¹²⁺

wifiManager.reassociate⁹⁺

wifiManager.reconnect⁹⁺

wifiManager.updateNetwork⁹⁺

wifiManager.disableNetwork⁹⁺

wifiManager.removeAllNetwork⁹⁺

wifiManager.get5GChannelList¹⁰⁺

wifiManager.getDisconnectedReason¹⁰⁺

DisconnectedReason ¹⁰⁺

wifiManager.startPortalCertification¹¹⁺

wifiManager.enableHiLinkHandshake¹²⁺

wifiManager.factoryReset¹¹⁺

wifiManager.enableHotspot⁹⁺

wifiManager.disableHotspot⁹⁺

wifiManager.isHotspotDualBandSupported⁹⁺

wifiManager.isOpenSoftApAllowed¹⁸⁺

wifiManager.setHotspotConfig⁹⁺

HotspotConfig⁹⁺

wifiManager.getHotspotConfig⁹⁺

wifiManager.getStations⁹⁺

StationInfo⁹⁺

wifiManager.addHotspotBlockList¹¹⁺

wifiManager.delHotspotBlockList¹¹⁺

wifiManager.getHotspotBlockList¹¹⁺

wifiManager.deletePersistentGroup⁹⁺

wifiManager.getP2pGroups⁹⁺

wifiManager.getP2pGroups⁹⁺

wifiManager.setDeviceName⁹⁺

wifiManager.on(‘streamChange’)⁹⁺

wifiManager.off(‘streamChange’)⁹⁺

wifiManager.on(‘deviceConfigChange’)⁹⁺

wifiManager.off(‘deviceConfigChange’)⁹⁺

wifiManager.on(‘hotspotStaJoin’)⁹⁺

wifiManager.off(‘hotspotStaJoin’)⁹⁺

wifiManager.on(‘hotspotStaLeave’)⁹⁺

wifiManager.off(‘hotspotStaLeave’)⁹⁺