• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# @ohos.wifiext (WLAN扩展接口)
2
3该模块主要提供WLAN扩展接口,供非通用类型产品使用。
4
5> **说明:**
6>
7> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
8该文档中的接口只供非通用类型产品使用,如路由器等,对于常规类型产品,不应该使用这些接口。
9
10
11## 导入模块
12
13```js
14import wifiext from '@ohos.wifiext';
15```
16
17## wifiext.enableHotspot
18
19enableHotspot(): boolean;
20
21使能WLAN热点。
22
23**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT_EXT
24
25**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
26
27**返回值:**
28
29  | **类型** | **说明** |
30  | -------- | -------- |
31  | boolean | 操作结果, true: 成功, false: 失败。 |
32
33
34## wifiext.disableHotspot
35
36disableHotspot(): boolean;
37
38去使能WLAN热点。
39
40**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT_EXT
41
42**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
43
44**返回值:**
45
46  | **类型** | **说明** |
47  | -------- | -------- |
48  | boolean | 操作结果, true: 成功, false: 失败。 |
49
50
51## wifiext.getSupportedPowerModel
52
53getSupportedPowerModel(): Promise<Array<PowerModel>>
54
55获取支持的功率模式,使用Promise异步回调。
56
57**需要权限:** ohos.permission.GET_WIFI_INFO
58
59**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
60
61**返回值:**
62
63  | 类型 | 说明 |
64  | -------- | -------- |
65  | Promise<Array<[PowerModel](#powermodel)>> | Promise对象。表示功率模式。 |
66
67
68## PowerModel
69
70表示功率模式的枚举。
71
72**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
73
74| 名称 | 值 | 说明 |
75| -------- | -------- | -------- |
76| SLEEPING | 0 | 睡眠模式。 |
77| GENERAL | 1 | 常规模式。 |
78| THROUGH_WALL | 2 | 穿墙模式。 |
79
80
81## wifiext.getSupportedPowerModel
82
83getSupportedPowerModel(callback: AsyncCallback<Array<PowerModel>>): void
84
85获取支持的功率模式,使用callback异步回调。
86
87**需要权限:** ohos.permission.GET_WIFI_INFO
88
89**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
90
91**参数:**
92
93  | 参数名 | 类型 | 必填 | 说明 |
94  | -------- | -------- | -------- | -------- |
95  | callback | AsyncCallback<Array<[PowerModel](#powermodel)>> | 是 | 回调函数。当操作成功时,err为0,data表示支持的功率模式。如果err为非0,表示处理出现错误。 |
96
97
98## wifiext.getPowerModel
99
100getPowerModel(): Promise<PowerModel>
101
102获取功率模式,使用Promise异步回调。
103
104**需要权限:** ohos.permission.GET_WIFI_INFO
105
106**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
107
108**返回值:**
109
110  | 类型 | 说明 |
111  | -------- | -------- |
112  | Promise<[PowerModel](#powermodel)> | Promise对象。表示功率模式。 |
113
114
115## wifiext.getPowerModel
116
117getPowerModel(callback: AsyncCallback<PowerModel>): void
118
119获取功率模式,使用callback异步回调。
120
121**需要权限:** ohos.permission.GET_WIFI_INFO
122
123**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
124
125**参数:**
126
127  | 参数名 | 类型 | 必填 | 说明 |
128  | -------- | -------- | -------- | -------- |
129  | callback | AsyncCallback<[PowerModel](#powermodel)> | 是 | 回调函数。当操作成功时,err为0,data表示功率模式。如果err为非0,表示处理出现错误。 |
130
131
132## wifiext.setPowerModel
133
134setPowerModel(model: PowerModel) : boolean;
135
136 设置功率模式。
137
138**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT_EXT
139
140**系统能力:** SystemCapability.Communication.WiFi.AP.Extension
141
142**参数:**
143
144  | 参数名 | 类型 | 必填 | 说明 |
145  | -------- | -------- | -------- | -------- |
146  | model | [PowerModel](#powermodel) | 是 | 功率模式。 |
147
148**返回值:**
149
150  | **类型** | **说明** |
151  | -------- | -------- |
152  | boolean | 操作结果, true: 成功, false: 失败。 |
153