目录

DeviceWifiPolicyManager

Class Info

public class DeviceWifiPolicyManager

WiFi管理相关类。

术语解释

SSID列表:WLAN中路由器名称列表(涉及接口获取设置的企业WiFi SSID列表getWifiProfileList)

open级热点:不设置加密的热点(涉及接口WLAN禁止/允许open级热点共享策略setUnsecureSoftApDisabled)

涉及接口配置 WLAN禁止/允许用户手动添加网络策略setUserProfilesDisabled

setUserProfilesDisabled

enable

disable

Setting设置

允许用户手动添加WiFi网络策略,具体体现在WiFi列表中。

禁止时设置界面的WiFi列表中“添加其他网络”按键置灰,用户不能手动添加网络,且只允许连接配置的企业网络。

Public Method Summary

Qualifier and Type

Method Name and Description

boolean

setSecurityLevel(ComponentName admin, int level)

配置WLAN允许连接的热点的最低安全级别。

int

getSecurityLevel(ComponentName admin)

获取WLAN允许连接的热点的最低安全级别。

boolean

addSsidToBlockList(ComponentName admin, ArrayList<String> ssids)

配置WLAN热点黑名单。

boolean

addSSIDToBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法已废弃,请使用boolean addSsidToBlockList(ComponentName admin, ArrayList<String> ssids)。

boolean

removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids)

删除WLAN热点黑名单。

boolean

removeSSIDFromBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法已废弃,请使用boolean removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids)。

ArrayList<String>

getSsidBlockList(ComponentName admin)

获取WLAN热点黑名单。

ArrayList<String>

getSSIDBlackList(ComponentName admin)

EMUI 11.0.0该方法已废弃,请使用ArrayList<String> getSsidBlockList(ComponentName admin)。

boolean

isBlockListedSsid(ComponentName admin, String ssid)

判断某个WLAN热点是否在黑名单中。

boolean

isBlackListedSSID(ComponentName admin, String ssid)

EMUI 11.0.0该方法已废弃,请使用boolean isBlockListedSsid(ComponentName admin, String ssid)。

boolean

setUserProfilesDisabled(ComponentName admin, boolean isDisabled)

配置 WLAN禁止/允许用户手动添加网络策略。

boolean

isUserProfilesDisabled(ComponentName admin)

查询 WLAN禁止/允许用户手动添加网络策略配置状态。

boolean

setWifiProfile(ComponentName admin, WifiConfiguration config)

配置企业WiFi。

ArrayList<String>

getWifiProfileList(ComponentName admin)

获取设置的企业WiFi SSID列表。

boolean

removeWifiProfile(ComponentName admin, WifiConfiguration config)

删除设置的企业WiFi。

boolean

isWifiProfileSet(ComponentName admin, WifiConfiguration config)

判断某个WLAN 热点是否是MDM配置的企业WiFi。

boolean

setWifiAutoConnectionDisabled(ComponentName admin, boolean isDisabled)

配置 WLAN禁止/允许自动连接WiFi热点策略。

boolean

isWifiAutoConnectionDisabled(ComponentName admin)

获取 WLAN禁止/允许自动连接WiFi热点策略配置状态。

boolean

setUnsecureSoftApDisabled(ComponentName admin, boolean isDisabled)

配置WLAN禁止/允许open级热点共享策略。

boolean

isUnsecureSoftApDisabled(ComponentName admin)

查询WLAN禁止/允许open级热点共享策略配置状态。

boolean

addSsidToTrustList(ComponentName admin, ArrayList<String> ssids)

添加WiFi热点白名单。

boolean

addSSIDToWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法已废弃,请使用boolean addSsidToTrustList(ComponentName admin, ArrayList<String> ssids)。

boolean

removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids)

删除WiFi热点白名单。

boolean

removeSSIDFromWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法已废弃,请使用boolean removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids)。

ArrayList<String>

getSsidTrustList(ComponentName admin)

查询WiFi热点白名单。

ArrayList<String>

getSSIDWhiteList(ComponentName admin)

EMUI 11.0.0该方法已废弃,请使用ArrayList<String> getSsidTrustList(ComponentName admin)。

boolean

addUnavailableSsidToList(ComponentName admin, ArrayList<String> ssids)

添加不显示不可上网提示的SSID列表。

boolean

removeUnavailableSsidFromList(ComponentName admin , ArrayList<String> ssids)

移除不显示不可上网提示的SSID列表。

ArrayList<String>

getUnavailableSsidList(ComponentName admin)

查询不显示不可上网提示的SSID列表。

boolean

removeConfiguredNetworks(ComponentName admin, ArrayList<String> ssids)

删除已保存的指定WiFi热点。

boolean

setWifiProDisabled(ComponentName admin, boolean isDisabled)

禁用/启用WLAN+ 功能。

boolean

isWifiProDisabled(ComponentName admin)

获取WLAN+ 禁用状态。

boolean

turnOnWifi(ComponentName admin, boolean isOn)

开启/关闭WiFi。

boolean

turnOnWifiAp(ComponentName admin, boolean isOn)

开启/关闭WiFi热点。

boolean

setWifiApPassword(ComponentName admin,String password)

修改WiFi热点密码。

boolean

setWifiHotspot(ComponentName admin, WifiConfiguration wifiConfig)

预置WiFi热点。

boolean

setRandomMacDisabled(ComponentName admin, boolean isDisabled)

开启/关闭WiFi随机MAC。

boolean

isRandomMacDisabled(ComponentName admin)

查询WiFi随机MAC是否被禁用。

boolean

setPortalAutoConnect(ComponentName admin, boolean isAutoConnect)

禁用/启用portal热点自动连接。

boolean

isPortalAutoConnect(ComponentName admin)

获取portal热点是否自动连接状态。

Public Methods

[h2]setSecurityLevel

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1及以上或HarmonyOS 2.0及以上

Method

public boolean setSecurityLevel(ComponentName admin, int level)

配置WLAN允许连接的热点的最低安全级别。

配置WLAN允许连接的热点安全级别之后,只有达到或高于此级别的热点可以连接,其它的热点都无法连接。安全级别根据WLAN的认证方式定义,认证方式和安全级别的映射关系如下:

  • SECURITY_LEVEL_1 =1: OPEN
  • SECURITY_LEVEL_2 =2: WEP
  • SECURITY_LEVEL_3 =3: WPA
  • SECURITY_LEVEL_4 =4: LEAP/PWD
  • SECURITY_LEVEL_5 =5: FAST/PEAP
  • SECURITY_LEVEL_6 =6: TLS/TTLS/SIM/AKA

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 如果有多个应用设置了该策略,以最后一次策略设置的级别为准。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

level

允许连接WLAN安全级别,取值范围在SECURITY_LEVEL_1到SECURITY_LEVEL_6之间。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]getSecurityLevel

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1及以上或HarmonyOS 2.0及以上

Method

public int getSecurityLevel(ComponentName admin)

获取当前WLAN允许连接的热点的最低安全级别。

配置WLAN允许连接的热点安全级别之后,只有达到或高于此级别的热点可以连接,其他的热点都无法连接。安全级别根据WLAN的认证方式定义,认证方式和安全级别的映射关系如下:

  • SECURITY_LEVEL_1 : OPEN
  • SECURITY_LEVEL_2 : WEP
  • SECURITY_LEVEL_3 : WPA
  • SECURITY_LEVEL_4 : LEAP/PWD
  • SECURITY_LEVEL_5 : FAST/PEAP
  • SECURITY_LEVEL_6 : TLS/TTLS/SIM/AKA

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

int

WLAN允许连接的热点的最低安全级别。如果未配置,则返回默认级别(SECURITY_LEVEL_1)。

[h2]addSsidToBlockList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean addSsidToBlockList(ComponentName admin, ArrayList<String> ssids)

配置WLAN热点黑名单,如果某个WLAN的ssid在黑名单上,则无法被连接。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  1. 传入的ssid不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过 200。
  2. 经过更新的黑名单列表总长度不能超过200。
  3. 单个ssid的字符串不能为null,内容不能为空,长度不能大于64。

Return

Type

Description

boolean

  • true: 配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]addSSIDToBlackList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

Method

public boolean addSSIDToBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃,请使用addSsidToBlockList。

配置WLAN热点黑名单,如果某个WLAN的ssid在黑名单上,则无法被连接。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  1. 传入的ssid不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过 200。
  2. 经过更新的黑名单列表总长度不能超过200。
  3. 单个ssid的字符串不能为null,内容不能为空,长度不能大于64。

Return

Type

Description

boolean

  • true::配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]removeSsidFromBlockList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean removeSsidFromBlockList(ComponentName admin, ArrayList<String> ssids)

从WLAN允许连接热点黑名单中删除某些设备(SSID)。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称。

ssids

传入的ssid为null时,表示全部删除。ssids列表不能为空,ssid列表中包含记录数量不能超过200。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]removeSSIDFromBlackList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

Method

public boolean removeSSIDFromBlackList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃,请使用removeSsidFromBlockList。

从WLAN允许连接热点黑名单中删除某些设备(SSID)。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称。

ssids

传入的ssid为null时,表示全部删除。ssids列表不能为空,ssid列表中包含记录数量不能超过200。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]getSsidBlockList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public ArrayList <String> getSsidBlockList(ComponentName admin)

获取WLAN热点黑名单列表。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

ArrayList<String>

返回WLAN热点黑名单列表,不存在则返回null。

[h2]getSSIDBlackList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

Method

public ArrayList <String> getSSIDBlackList(ComponentName admin)

EMUI 11.0.0该方法废弃,请使用getSsidBlockList。

获取WLAN热点黑名单列表。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

ArrayList<String>

返回WLAN热点黑名单列表,不存在则返回null。

[h2]isBlockListedSsid

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean isBlockListedSsid(ComponentName admin, String ssid)

判断某个WLAN热点是否在黑名单中。

Parameters

Name

Description

admin

调用该接口的组件名称。

ssid

待查询的WLAN热点的SSID。

Return

Type

Description

boolean

  • true:该WLAN热点在黑名单中。
  • false:该WLAN热点不在黑名单中。

[h2]isBlackListedSSID

Supported Devices

Device Type

OS Version

手机、平板

EMUI 5.1~EMUI 10.1

Method

public boolean isBlackListedSSID(ComponentName admin, String ssid)

EMUI 11.0.0该方法废弃,请使用isBlockListedSsid。

判断某个WLAN热点是否在黑名单中。

Parameters

Name

Description

admin

调用该接口的组件名称。

ssid

待查询的WLAN热点的SSID。

Return

Type

Description

boolean

  • true:该WLAN热点在黑名单中。
  • false:该WLAN热点不在黑名单中。

[h2]setUserProfilesDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean setUserProfilesDisabled(ComponentName admin, boolean isDisabled)

配置允许/禁止用户手动添加WiFi网络策略。禁止时设置界面添加修改网络按键置灰,用户不能手动添加网络,且只允许连接配置的企业网络。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 只要有一个应用设置了禁止策略,即全局禁止手动添加WiFi网络。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isDisabled

  • true:配置禁止用户手动添加WiFi网络。
  • false:配置允许用户手动添加WiFi网络。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isUserProfilesDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean isUserProfilesDisabled(ComponentName admin)

获取WLAN允许/禁止用户手动添加网络策略配置状态。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

boolean

  • true:应用禁止用户手动添加网络。
  • false:应用允许用户手动添加网络。

[h2]setWifiProfile

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean setWifiProfile(ComponentName admin, WifiConfiguration config)

配置MDM应用下发的企业WiFi,添加到企业WiFi SSID列表。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 需要调用setUserProfilesDisabled后才能生效。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

config

要配置的企业WiFi。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]getWifiProfileList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public ArrayList<String> getWifiProfileList(ComponentName admin)

获取应用设置的企业WiFi SSID列表。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的企业WiFi集合。

Return

Type

Description

ArrayList<String>

返回应用设置的企业WiFi SSID列表,未配置则返回null。

[h2]removeWifiProfile

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean removeWifiProfile(ComponentName admin, WifiConfiguration config)

从设置的企业WiFi SSID列表中删除某个企业WiFi(SSID)。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称;参数为null时,删除所有应用设置的企业WiFi,即清空SSID列表。

config

待移除的WiFi热点(SSID)。

Return

Type

Description

boolean

  • true:删除成功。
  • false:删除失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isWifiProfileSet

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean isWifiProfileSet(ComponentName admin, WifiConfiguration config)

判断某个WLAN 热点是否是配置的企业WiFi。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合结果。

config

待查询的WLAN热点。

Return

Type

Description

boolean

  • true:该WLAN热点在配置的企业热点列表中。
  • false:该WLAN热点不在配置的企业热点列表中。

[h2]setWifiAutoConnectionDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean setWifiAutoConnectionDisabled(ComponentName admin, boolean isDisabled)

配置WLAN允许/禁止自动连接WiFi热点策略。禁止时不允许WLAN发起自动连接。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 只要有一个应用设置了禁止策略,即全局禁止自动连接WiFi网络。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isDisabled

  • true:配置禁止自动连接WiFi网络。
  • false:配置允许自动连接WiFi网络。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isWifiAutoConnectionDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean isWifiAutoConnectionDisabled(ComponentName admin)

获取WLAN允许/禁止自动连接WiFi热点策略配置状态。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

boolean

  • true:应用禁止自动连接网络。
  • false:应用允许自动连接网络。

[h2]setUnsecureSoftApDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean setUnsecureSoftApDisabled(ComponentName admin, boolean isDisabled)

配置WLAN允许/禁止open级热点共享策略。禁止时不允许共享open级热点。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 只要有一个MDM应用设置了禁止策略,即全局禁止共享open级热点。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isDisabled

  • true:配置禁止共享open级热点。
  • false:配置允许共享open级热点。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isUnsecureSoftApDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.0及以上或HarmonyOS 2.0及以上

Method

public boolean isUnsecureSoftApDisabled(ComponentName admin)

获取WLAN允许/禁止open级热点共享策略配置状态。

Parameters

Name

Description

admin

调用该接口的组件名称,查询该应用配置的策略;参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

boolean

  • true:禁止共享open级热点。
  • false:允许共享open级热点。

[h2]addSsidToTrustList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean addSsidToTrustList(ComponentName admin, ArrayList<String> ssids)

只能连接白名单内指定的热点。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  • 传入的ssid不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过最大限制数量200。
  • 经过更新的黑名单列表总长度不能超过最大限制数量。
  • 单个ssid的字符串不能为null,内容不能为空。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]addSSIDToWhiteList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.2~EMUI 10.1

Method

public boolean addSSIDToWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃,请使用addSsidToTrustList。

只能连接白名单内指定的热点。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  • 传入的ssid不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过最大限制数量200。
  • 经过更新的黑名单列表总长度不能超过最大限制数量。
  • 单个ssid的字符串不能为null,内容不能为空。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]removeSsidFromTrustList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean removeSsidFromTrustList(ComponentName admin, ArrayList<String> ssids)

删除WiFi热点白名单中的某些热点地址。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  • 传入的ssid不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过最大限制数量200。
  • 经过更新的黑名单列表总长度不能超过最大限制数量。
  • 单个 ssid 的字符串不能为null,内容不能为空。

Return

Type

Description

boolean

  • true:删除成功。
  • false:删除失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]removeSSIDFromWhiteList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.2~EMUI 10.1

Method

public boolean removeSSIDFromWhiteList(ComponentName admin, ArrayList<String> ssids)

EMUI 11.0.0该方法废弃,请使用removeSsidFromTrustList。

删除WiFi热点白名单中的某些热点地址。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

  • 传入的 ssid 不能为null,ssid列表内容不能为空,ssid列表中包含记录数量不能超过最大限制数量200。
  • 经过更新的黑名单列表总长度不能超过 最大限制数量。
  • 单个ssid的字符串不能为null,内容不能为空。

Return

Type

Description

boolean

  • true:删除成功。
  • false:删除失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]getSsidTrustList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public ArrayList<String> getSsidTrustList(ComponentName admin)

查询WiFi热点白名单。

Parameters

Name

Description

admin

调用该接口的组件名称。

Return

Type

Description

ArrayList <String>

返回WLAN热点白名单列表,不存在则返回null。

Throws

Name

Description

SecurityException

此APK未经设备管理激活。

[h2]getSSIDWhiteList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 8.2~EMUI 10.1

Method

public ArrayList<String> getSSIDWhiteList(ComponentName admin)

EMUI 11.0.0该方法废弃,请使用getSsidTrustList。

查询WiFi热点白名单。

Parameters

Name

Description

admin

调用该接口的组件名称。

Return

Type

Description

ArrayList <String>

返回WLAN热点白名单列表,不存在则返回null。

Throws

Name

Description

SecurityException

此APK未经设备管理激活。

[h2]addUnavailableSsidToList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 10.1及以上或HarmonyOS 2.0及以上

Method

public boolean addUnavailableSsidToList(ComponentName admin, ArrayList<String>ssids)

添加热点名称,使得这个热点不显示不可上网的提示。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

需要不显示不可上网的ssid集合。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]removeUnavailableSsidFromList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 10.1及以上或HarmonyOS 2.0及以上

Method

public boolean removeUnavailableSsidFromList(ComponentName admin, ArrayList<String> ssids)

删除不显示不可上网提示的ssid集合。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

需要不显示不可上网的ssid集合。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]getUnavailableSsidList

Supported Devices

Device Type

OS Version

手机、平板

EMUI 10.1及以上或HarmonyOS 2.0及以上

Method

public ArrayList<String> getUnavailableSsidList(ComponentName admin)

查询不显示不可上网提示的ssid集合。

Parameters

Name

Description

admin

调用该接口的组件名称。

Return

Type

Description

ArrayList<String>

SSID名称列表。

Throws

Name

Description

SecurityException

此APK未经设备管理激活。

[h2]removeConfiguredNetworks

Supported Devices

Device Type

OS Version

手机、平板

EMUI 10.1及以上或HarmonyOS 2.0及以上

Method

public boolean removeConfiguredNetworks(ComponentName admin, ArrayList<String> ssids)

根据传入的热点名称,从已保存的热点列表中删除该热点。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

ssids

需要从已保存热点列表中移除的ssid集合。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]setWifiProDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean setWifiProDisabled(ComponentName admin, boolean isDisabled)

设置WLAN+被禁用状态。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称。

isDisabled

  • true:禁用WLAN+功能。
  • false:启用WLAN+功能。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isWifiProDisabled

Supported Devices

Device Type

OS Version

手机、平板

EMUI 11.0或HarmonyOS 2.0及以上

Method

public boolean isWifiProDisabled(ComponentName admin)

获取WLAN+是否被禁用。

Parameters

Name

Description

admin

调用该接口的组件名称,参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

boolean

  • true:WLAN+被禁用。
  • false:WLAN+未被禁用。

Throws

Name

Description

SecurityException

此APK未经设备管理激活。

[h2]turnOnWifi

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 2.1及以上

Method

public boolean turnOnWifi(ComponentName admin, boolean isOn)

开启/关闭WiFi。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 强制开启WiFi,或者禁用WiFi开启时,不会处理开启关闭设置。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isOn

  • true:开启WiFi。
  • false:关闭WiFi。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

IllegalArgumentException

参数admin为null。

[h2]turnOnWifiAp

Supported Devices

Device Type

OS Version

智慧屏

HarmonyOS 3.0及以上

Method

public boolean turnOnWifiAp (ComponentName admin, boolean isOn)

开启/关闭WiFi热点。

注意:需要申请com.huawei.permission.sec.MDM_WIFI权限。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isOn

  • true:开启WiFi热点。
  • false:关闭WiFi热点。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

IllegalArgumentException

参数admin为null。

[h2]setWifiApPassword

Supported Devices

Device Type

OS Version

智慧屏

HarmonyOS 3.0及以上

Method

public boolean setWifiApPassword(ComponentName admin , String password)

修改WiFi热点密码。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 修改后热点会自动重启,已连接设备需要重新连接。
  3. 参数password的长度不在规定范围内时返回false。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

password

新的WiFi热点密码,长度大于7,最多63字节。

Return

Type

Description

boolean

  • true:修改成功。
  • false:修改失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

IllegalArgumentException

参数admin为null。

[h2]setWifiHotspot

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 3.1及以上

Method

public boolean setWifiHotspot(ComponentName admin, WifiConfiguration wifiConfig)

预置WiFi热点。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 当配置了WiFi热点白名单,且此WiFi热点不在白名单中时,无法预置。关联接口:addSsidToTrustList、removeSsidFromTrustList、getSsidTrustList。
  3. 当配置了WiFi热点黑名单,且此WiFi热点在黑名单中时,无法预置。关联接口:addSsidToBlockList、removeSsidFromBlockList、getSsidBlockList、isBlockListedSsid。
  4. 当配置了企业WiFi,且此WiFi热点不在企业WiFi列表中时,无法预置。关联接口:setWifiProfile、removeWifiProfile、getWifiProfileList、isWifiProfileSet。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

wifiConfig

预置的WiFi热点信息,需要包含以下四个数据(详细说明见下表):

  • ssid
  • preSharedKey
  • keyMgmt
  • hiddenSSID

wifiConfig字段名称(注意大小写)

数据类型

Description

ssid

String

预置的WiFi热点的名称,不允许为null或者empty。

preSharedKey

String

预置的WiFi热点的密码,长度大于7,最多63字节。

keyMgmt

int

预置的WiFi热点的加密方式。

参数取值范围:

  • 1:wpa/wpa2 加密。
  • 2:wpa3 加密。

isHiddenSSID

boolean

是否是隐藏热点。

  • true:是隐藏热点。
  • false:不是隐藏热点。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

IllegalArgumentException

  • 参数admin为null。
  • 参数wifiConfig不符合要求。
  • 预置WiFi的ssid与WiFi热点白名单/黑名单/企业WiFi冲突。

[h2]setRandomMacDisabled

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 3.1及以上

Method

public boolean setRandomMacDisabled(ComponentName admin, boolean isDisabled)

禁用/启用WiFi随机MAC。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 禁用后用户仍然可以在“设置-WLAN-(点击某个热点)-隐私”处选择“使用随机MAC”,但是不会生效,实际使用的是本机MAC。
  3. 对于在调用接口之前已连接以及已保存的WiFi,必须先清除WiFi信息并重新连接,此接口才会生效。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isDisabled

  • true:禁用WiFi随机MAC。
  • false:启用WiFi随机MAC。

Return

Type

Description

boolean

  • true:设置成功。
  • false:设置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

IllegalArgumentException

参数admin为null。

[h2]isRandomMacDisabled

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 3.1及以上

Method

public boolean isRandomMacDisabled(ComponentName admin)

查询WiFi随机MAC是否被禁用。

Parameters

Name

Description

admin

调用该接口的组件名称,参数为null时,获取所有应用设置的综合策略结果。

Return

Type

Description

boolean

  • true:WiFi随机MAC被禁用。
  • false:WiFi随机MAC未被禁用。

Throws

Name

Description

SecurityException

  • 指定的admin未激活。
  • 参数admin非法。

[h2]setPortalAutoConnect

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 4.0及以上

Method

public boolean setPortalAutoConnect(ComponentName admin, boolean isAutoConnect)

禁用/启用portal热点自动连接。

注意:

  1. 需要申请com.huawei.permission.sec.MDM_WIFI权限。
  2. 需要设置WLAN+默认关闭。
  3. MAC上报真实地址进行认证。
  4. 设置成功后需要重启WiFi,防止该热点被加入黑名单导致不能连接。
  5. 主要是支持已保存但未通过鉴权的Portal热点的自动连接。

Parameters

Name

Description

admin

调用该接口的组件名称,不能为null。

isAutoConnect

  • true:自动连接Portal热点。
  • false:不自动连接Portal热点。

Return

Type

Description

boolean

  • true:配置成功。
  • false:配置失败。

Throws

Name

Description

SecurityException

  • 此APK未经设备管理激活。
  • 无com.huawei.permission.sec.MDM_WIFI权限。

[h2]isPortalAutoConnect

Supported Devices

Device Type

OS Version

手机、平板

HarmonyOS 4.0及以上

Method

public boolean isPortalAutoConnect(ComponentName admin)

获取Portal热点是否自动连接状态。

Parameters

Name

Description

admin

调用该接口的组件名称。

Return

Type

Description

boolean

  • true:自动连接Portal热点。
  • false:不自动连接Portal热点。

Throws

Name

Description

SecurityException

此APK未经设备管理激活。