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