# WLAN

> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
该文档中的接口只供非通用类型产品使用，如路由器等，对于常规类型产品，不应该使用这些接口。
该模块接口为预留接口，3.1 Release 版本暂不支持。


## 导入模块

```js
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](#PowerModel)>> | 功率模式。 |


## PowerModel

表示功率模式的枚举。

| 名称 | 默认值 | 说明 |
| -------- | -------- | -------- |
| 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<[PowerModel](#PowerModel)> | 是 | 功率模式。 |


## wifiext.getPowerModel

getPowerModel(): Promise<PowerModel>

获取功率模式，使用promise方式作为异步方法。

- 需要权限：
  ohos.permission.GET_WIFI_INFO

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

- 返回值：
  | 类型 | 说明 |
  | -------- | -------- |
  | Promise<[PowerModel](#PowerModel)> | 功率模式。 |


## wifiext.getPowerModel

getPowerModel(callback: AsyncCallback<PowerModel>): void

获取功率模式，使用callback方式作为异步方法。

- 需要权限：
  ohos.permission.GET_WIFI_INFO

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

- 参数
  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
  | callback | AsyncCallback<[PowerModel](#PowerModel)> | 是 | 功率模式。 |


## wifiext.setPowerModel

setPowerModel(model: PowerModel) : boolean;

 设置功率模式。

- 需要权限：
  ohos.permission.MANAGE_WIFI_HOTSPOT_EXT

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

- 参数
  | 参数名 | 类型 | 必填 | 说明 |
  | -------- | -------- | -------- | -------- |
  | model | AsyncCallback<[PowerModel](#PowerModel)> | 是 | 功率模式。 |

- 返回值：
  | **类型** | **说明** |
  | -------- | -------- |
  | boolean | 操作结果， true: 成功， false: 失败。 |