@ohos.wifiManagerExt (WLAN扩展接口)

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

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

导入模块

import wifiManagerExt from '@ohos.wifiManagerExt';

wifiext.enableHotspot9+

enableHotspot(): void;

使能WLAN热点。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

错误码：

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

错误码ID 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

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

wifiext.disableHotspot9+

disableHotspot(): void;

去使能WLAN热点。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

错误码：

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

错误码ID 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

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

wifiext.getSupportedPowerMode9+

getSupportedPowerMode(): Promise<Array<PowerMode>>

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

需要权限： ohos.permission.GET_WIFI_INFO

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

返回值：

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

错误码：

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

错误码ID 错误信息
2701000 Operation failed.

PowerMode9+

表示功率模式的枚举。

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

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

wifiext.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 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

        wifiManagerExt.getSupportedPowerMode((err, data) => {
            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.info("get supported power mode error");
        });

wifiext.getPowerMode9+

getPowerMode(): Promise<PowerMode>

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

需要权限： ohos.permission.GET_WIFI_INFO

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

返回值：

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

错误码：

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

错误码ID 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

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

wifiext.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 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

        wifiManagerExt.getPowerMode((err, data) => {
            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.info("get power mode error");
        });

wifiext.setPowerMode9+

setPowerMode(mode: PowerMode) : void;

设置功率模式。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

参数：

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

错误码：

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

错误码ID 错误信息
2701000 Operation failed.

示例：

        import wifiManagerExt  from '@ohos.wifiManagerExt';

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