harmony 鸿蒙@ohos.wifiManagerExt (WLAN扩展接口)

  • 2025-06-12
  • 浏览 (2)

@ohos.wifiManagerExt (WLAN扩展接口)

该模块主要提供WLAN扩展接口,供非通用类型产品使用。

说明: 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 该文档中的接口只供非通用类型产品使用,如路由器等,对于常规类型产品,不应该使用这些接口。

导入模块

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

wifiManagerExt.enableHotspot(deprecated)

enableHotspot(): void

使能WLAN热点。

说明: 从API version 9开始支持,从API version 10开始废弃。

需要权限: ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

系统能力: SystemCapability.Communication.WiFi.AP.Extension

错误码:

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

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

示例:

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

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

wifiManagerExt.disableHotspot(deprecated)

disableHotspot(): void

去使能WLAN热点。

说明: 从API version 9开始支持,从API version 10开始废弃。

需要权限: ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

系统能力: SystemCapability.Communication.WiFi.AP.Extension

错误码:

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

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

示例:

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

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

wifiManagerExt.getSupportedPowerMode9+

getSupportedPowerMode(): Promise<Array<PowerMode>>

获取支持的功率模式,使用Promise异步回调。

需要权限: ohos.permission.GET_WIFI_INFO

系统能力: SystemCapability.Communication.WiFi.AP.Extension

返回值:

类型 说明
Promise<Array<PowerMode>> Promise对象。表示功率模式。

错误码:

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

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

PowerMode9+

表示功率模式的枚举。

系统能力: SystemCapability.Ability.AbilityRuntime.Core

名称 说明
SLEEPING 0 睡眠模式。
GENERAL 1 常规模式。
THROUGH_WALL 2 穿墙模式。

wifiManagerExt.getSupportedPowerMode9+

getSupportedPowerMode(callback: AsyncCallback<Array<PowerMode>>): void

获取支持的功率模式,使用callback异步回调。

需要权限: ohos.permission.GET_WIFI_INFO

系统能力: SystemCapability.Communication.WiFi.AP.Extension

参数:

参数名 类型 必填 说明
callback AsyncCallback<Array<PowerMode>> 回调函数。当操作成功时,err为0,data表示支持的功率模式。如果err为非0,表示处理出现错误。

错误码:

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

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

示例:

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

  wifiManagerExt.getSupportedPowerMode((err, data:wifiManagerExt.PowerMode[]) => {
      if (err) {
          console.error("get supported power mode info error");
          return;
      }
      console.info("get supported power mode info: " + JSON.stringify(data));
  });

  wifiManagerExt.getSupportedPowerMode().then(data => {
      console.info("get supported power mode info: " + JSON.stringify(data));
  }).catch((error:number) => {
      console.error("get supported power mode error");
  });

wifiManagerExt.getPowerMode9+

getPowerMode(): Promise<PowerMode>

获取功率模式,使用Promise异步回调。

说明: 从API version 9开始支持,从API version 10开始废弃。

需要权限: ohos.permission.GET_WIFI_INFO

系统能力: SystemCapability.Communication.WiFi.AP.Extension

返回值:

类型 说明
Promise<PowerMode> Promise对象。表示功率模式。

错误码:

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

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

示例:

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

  try {
      let model = wifiManagerExt.getPowerMode();
      console.info("model info:" + model);
  }catch(error){
      console.error("failed:" + JSON.stringify(error));
  }

wifiManagerExt.getPowerMode9+

getPowerMode(callback: AsyncCallback<PowerMode>): void

获取功率模式,使用callback异步回调。

需要权限: ohos.permission.GET_WIFI_INFO

系统能力: SystemCapability.Communication.WiFi.AP.Extension

参数:

参数名 类型 必填 说明
callback AsyncCallback<PowerMode> 回调函数。当操作成功时,err为0,data表示功率模式。如果err为非0,表示处理出现错误。

错误码:

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

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

示例:

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

  wifiManagerExt.getPowerMode((err, data:wifiManagerExt.PowerMode) => {
      if (err) {
          console.error("get linked info error");
          return;
      }
      console.info("get power mode info: " + JSON.stringify(data));
  });

  wifiManagerExt.getPowerMode().then(data => {
      console.info("get power mode info: " + JSON.stringify(data));
  }).catch((error:number) => {
      console.error("get power mode error");
  });

wifiManagerExt.setPowerMode(deprecated)

setPowerMode(mode: PowerMode) : void

设置功率模式。

说明: 从API version 9开始支持,从API version 10开始废弃。

需要权限: ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

系统能力: SystemCapability.Communication.WiFi.AP.Extension

参数:

参数名 类型 必填 说明
mode PowerMode 功率模式。

错误码:

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

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

示例:

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

  try {
      let model = 0;
      wifiManagerExt.setPowerMode(model);
  }catch(error){
      console.error("failed:" + JSON.stringify(error));
  }

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Connectivity Kit(短距通信服务)

harmony 鸿蒙Bluetooth

harmony 鸿蒙Wifi

harmony 鸿蒙蓝牙服务子系统错误码

harmony 鸿蒙NFC错误码

harmony 鸿蒙SE(secureElement)错误码

harmony 鸿蒙WIFI错误码

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

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

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

0  赞