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

2025-06-12
浏览 (3)

@ohos.wifiext (WLAN扩展接口)

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

说明：

本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。该文档中的接口只供非通用类型产品使用，如路由器等，对于常规类型产品，不应该使用这些接口。从API Version 9开始，该接口不再维护，推荐使用@ohos.wifiManagerExt（WLAN扩展接口）等相关接口。

导入模块

import wifiext from '@ohos.wifiext';

wifiext.enableHotspot

enableHotspot(): boolean;

使能WLAN热点。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

返回值：

类型	说明
boolean	操作结果， true: 成功， false: 失败。

wifiext.disableHotspot

disableHotspot(): boolean;

去使能WLAN热点。

需要权限： ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

返回值：

类型	说明
boolean	操作结果， true: 成功， false: 失败。

wifiext.getSupportedPowerModel

getSupportedPowerModel(): Promise<Array<PowerModel>>

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

需要权限： ohos.permission.GET_WIFI_INFO

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

返回值：

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

PowerModel

表示功率模式的枚举。

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

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

wifiext.getSupportedPowerModel

getSupportedPowerModel(callback: AsyncCallback<Array<PowerModel>>): void

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

需要权限： ohos.permission.GET_WIFI_INFO

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

参数：

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

wifiext.getPowerModel

getPowerModel(): Promise<PowerModel>

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

需要权限： ohos.permission.GET_WIFI_INFO

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

返回值：

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

wifiext.getPowerModel

getPowerModel(callback: AsyncCallback<PowerModel>): void

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

需要权限： ohos.permission.GET_WIFI_INFO

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

参数：

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