1## Wifi使用说明文档
2
3​		本文档主要介绍Wifi专项测试程序的Wifi部分(@ohos.wifi.d.ts)的功能使用说明。
4
5#### 从主界面跳转到WIFI部分
6
7---
8
9#### setting界面
10
11点击"switch"按钮 ,设置本设备的wifi参数配置。
12
13
14
15Wifi配置信息包括:
16
17>### WifiDeviceConfig    WLAN配置信息
18>
19>| **参数名称**  |       **类型**       |               默认值设置                | **说明**                                           |
20>| :-----------: | :------------------: | :-------------------------------------: | :------------------------------------------------- |
21>|     ssid      |        string        |              TP-LINK_6365               | 热点的SSID,编码格式为UTF-8。                      |
22>|     bssid     |        string        |            6c:b1:58:75:63:67            | 热点的BSSID。                                      |
23>| preSharedKey  |        string        |               kaihong123                | 热点的密钥。                                       |
24>| isHiddenSsid  |       boolean        |                  false                  | 是否是隐藏网络。                                   |
25>| securityType  | **WifiSecurityType** |                    3                    | 加密类型。                                         |
26>|  creatorUid   |        number        |                    1                    | 创建用户的ID。 **系统接口:** 此接口为系统接口。   |
27>| disableReason |        number        |                    0                    | 禁用原因。 **系统接口:** 此接口为系统接口。       |
28>|     netId     |        number        |                    0                    | 分配的网络ID。 **系统接口:** 此接口为系统接口。   |
29>| randomMacType |        number        |                    0                    | 随机MAC类型。 **系统接口:** 此接口为系统接口。    |
30>| randomMacAddr |        string        |            xx:xx:xx:xx:xx:xx            | 随机MAC地址。 **系统接口:** 此接口为系统接口。    |
31>|    ipType     |      **IpType**      |                    1                    | IP地址类型。 **系统接口:** 此接口为系统接口。     |
32>|   staticIp    |     **IpConfig**     | ipAddress;gateway;dnsServers;domains | 静态IP配置信息。 **系统接口:** 此接口为系统接口。 |
33>
34>
35>
36>#### WifiSecurityType  表示加密类型的枚举
37>
38>| **值** |       **描述**        |                       **说明**                        |
39>| :----: | :-------------------: | :---------------------------------------------------: |
40>|   0    | WIFI_SEC_TYPE_INVALID |                    无效加密类型。                     |
41>|   1    |  WIFI_SEC_TYPE_OPEN   |                    开放加密类型。                     |
42>|   2    |   WIFI_SEC_TYPE_WEP   |       Wired Equivalent Privacy (WEP)加密类型。        |
43>|   3    |   WIFI_SEC_TYPE_PSK   |            Pre-shared key (PSK)加密类型。             |
44>|   4    |   WIFI_SEC_TYPE_SAE   | Simultaneous Authentication of Equals (SAE)加密类型。 |
45>
46>
47>
48>#### IpType   表示IP类型的枚举
49>
50>|  值  |  描述   |      说明      |
51>| :--: | :-----: | :------------: |
52>|  0   | STATIC  |    静态IP。    |
53>|  1   |  DHCP   | 通过DHCP获取。 |
54>|  2   | UNKNOWN |    未指定。    |
55>
56>
57>
58>#### IpConfig   IP配置信息
59>
60>| **参数名称** |   **类型**    | 默认值设为 |  **说明**   |
61>| :----------: | :-----------: | :--------: | :---------: |
62>|  ipAddress   |    number     | 3232235880 |  IP地址。   |
63>|   gateway    |    number     | 3232235777 |   网关。    |
64>|  dnsServers  |   number[]    | 3716386629 | DNS服务器。 |
65>|   domains    | Array<string> |            |  域信息。   |
66>
67>
68
69#### WIFi(@ohos.wifi.d.ts)的主要接口
70
71|          method名称          |             API名称             |           所需参数           |                     返回值                     | 备注 |
72| :--------------------------: | :-----------------------------: | :--------------------------: | :--------------------------------------------: | :--: |
73|           使能WIFI           |           enableWifi            |              ()              |                    boolean                     |      |
74|          去使能WIFI          |           disableWifi           |              ()              |                    boolean                     |      |
75|          是否已使能          |          isWifiActive           |              ()              |                    boolean                     |      |
76|         启动WLAN扫描         |              scan               |              ()              |                    boolean                     |      |
77|     获取扫描信息,promise     |      getScanInfos(promise)      |              ()              |          Promise<Array<WifiScanInfo>>          |      |
78|    获取扫描信息,callback     |     getScanInfos(callback)      |              ()              | (callback: AsyncCallback<Array<WifiScanInfo>>) |      |
79|     添加网络配置,promise     |    addDeviceConfig(promise)     |  (config: WifiDeviceConfig)  |                Promise<number>                 |      |
80|    添加网络配置,callback     |    addDeviceConfig(callback)    |  (config: WifiDeviceConfig)  |       (callback: AsyncCallback<number>)        |      |
81| 添加不可信网络配置,promise  |   addUntrustedConfig(promise)   |  (config: WifiDeviceConfig)  |                Promise<boolean>                |      |
82| 添加不可信网络配置,callback |  addUntrustedConfig(callback)   |  (config: WifiDeviceConfig)  |       (callback: AsyncCallback<boolean>)       |      |
83| 移除不可信网络配置,promise  | removeUntrustedConfig(promise)  |  (config: WifiDeviceConfig)  |                Promise<boolean>                |      |
84| 移除不可信网络配置,callback | removeUntrustedConfig(callback) |  (config: WifiDeviceConfig)  |       (callback: AsyncCallback<boolean>)       |      |
85|        连接到指定网络        |        connectToNetwork         |     (networkId: number)      |                    boolean                     |      |
86|        连接到指定网络        |         connectToDevice         |  (config: WifiDeviceConfig)  |                    boolean                     |      |
87|        断开连接的网络        |           disconnect            |              ()              |                    boolean                     |      |
88|       查询WLAN信号强度       |         getSignalLevel          | (rssi: number, band: number) |                     number                     |      |
89|   获取WLAN连接信息,promise   |     getLinkedInfo(promise)      |              ()              |            Promise<WifiLinkedInfo>             |      |
90|  获取WLAN连接信息,callback   |     getLinkedInfo(callback)     |              ()              |   (callback: AsyncCallback<WifiLinkedInfo>)    |      |
91|        WLAN是否已连接        |           isConnected           |              ()              |                    boolean                     |      |
92|      查询设备支持的特性      |      getSupportedFeatures       |              ()              |                     number                     |      |
93|     是否支持相关WLAN特性     |       isFeatureSupported        |     (featureId: number)      |                    boolean                     |      |
94|      获取设备的MAC地址       |       getDeviceMacAddress       |              ()              |                    string[]                    |      |
95|          获取IP信息          |            getIpInfo            |              ()              |                     IpInfo                     |      |
96|        获取国家码信息        |         getCountryCode          |              ()              |                     string                     |      |
97|         重新关联网络         |           reassociate           |              ()              |                    boolean                     |      |
98|         重新连接网络         |            reConnect            |              ()              |                    boolean                     |      |
99|         获取网络配置         |        getDeviceConfigs         |              ()              |            Array<WifiDeviceConfig>             |      |
100|         更新网络配置         |          updateNetwork          |  (config: WifiDeviceConfig)  |                     number                     |      |
101|        去使能网络配置        |         disableNetwork          |       (netId: number)        |                    boolean                     |      |
102|       移除所有网络配置       |        removeAllNetwork         |              ()              |                    boolean                     |      |
103|      移除指定的网络配置      |          removeDevice           |         (id: number)         |                    boolean                     |      |
104|     注册WLAN状态改变事件     |       on.wifiStateChange        |                              |          (callback: Callback<number>)          |      |
105|   注册WLAN连接状态改变事件   |     on.wifiConnectionChange     |                              |          (callback: Callback<number>)          |      |
106|     注册扫描状态改变事件     |     on.wifiScanStateChange      |                              |          (callback: Callback<number>)          |      |
107|     注册RSSI状态改变事件     |        on.wifiRssiChange        |                              |          (callback: Callback<number>)          |      |
108|        注册流改变事件        |         on.streamChange         |                              |          (callback: Callback<number>)          |      |
109|                              |                                 |                              |                                                |      |
110
111
112
113#### 返回值介绍
114
115>#### WifiScanInfo      WLAN热点信息
116>
117>| **名称**     | **类型**             | **可读** | **可写** | **说明**                      |
118>| :----------- | :------------------- | :------- | :------- | :---------------------------- |
119>| ssid         | string               | 是       | 否       | 热点的SSID,编码格式为UTF-8。 |
120>| bssid        | string               | 是       | 否       | 热点的BSSID。                 |
121>| capabilities | string               | 是       | 否       | 热点能力。                    |
122>| securityType | **WifiSecurityType** | 是       | 否       | WLAN加密类型。                |
123>| rssi         | number               | 是       | 否       | 热点的信号强度(dBm)。         |
124>| band         | number               | 是       | 否       | WLAN接入点的频段。            |
125>| frequency    | number               | 是       | 否       | WLAN接入点的频率。            |
126>| channelWidth | number               | 是       | 否       | WLAN接入点的带宽。            |
127>| timestamp    | number               | 是       | 否       | 时间戳。                      |
128>
129>
130>
131>#### WifiSecurityType   表示加密类型的枚举
132>
133>| **名称**              | **值** | **说明**                                              |
134>| :-------------------- | :----- | :---------------------------------------------------- |
135>| WIFI_SEC_TYPE_INVALID | 0      | 无效加密类型。                                        |
136>| WIFI_SEC_TYPE_OPEN    | 1      | 开放加密类型。                                        |
137>| WIFI_SEC_TYPE_WEP     | 2      | Wired Equivalent Privacy (WEP)加密类型。              |
138>| WIFI_SEC_TYPE_PSK     | 3      | Pre-shared key (PSK)加密类型。                        |
139>| WIFI_SEC_TYPE_SAE     | 4      | Simultaneous Authentication of Equals (SAE)加密类型。 |
140>
141>
142>
143>#### WifiLinkedInfo   提供WLAN连接的相关信息
144>
145>| 名称         | 类型          | 可读 | 可写 | 说明                                                         |
146>| :----------- | :------------ | :--- | :--- | :----------------------------------------------------------- |
147>| ssid         | string        | 是   | 否   | 热点的SSID,编码格式为UTF-8。                                |
148>| bssid        | string        | 是   | 否   | 热点的BSSID。                                                |
149>| networkId    | number        | 是   | 否   | 网络配置ID。 **系统接口:** 此接口为系统接口。               |
150>| rssi         | number        | 是   | 否   | 热点的信号强度(dBm)。                                        |
151>| band         | number        | 是   | 否   | WLAN接入点的频段。                                           |
152>| linkSpeed    | number        | 是   | 否   | WLAN接入点的速度。                                           |
153>| frequency    | number        | 是   | 否   | WLAN接入点的频率。                                           |
154>| isHidden     | boolean       | 是   | 否   | WLAN接入点是否是隐藏网络。                                   |
155>| isRestricted | boolean       | 是   | 否   | WLAN接入点是否限制数据量。                                   |
156>| chload       | number        | 是   | 否   | 连接负载,值越大表示负载约高。 **系统接口:** 此接口为系统接口。 |
157>| snr          | number        | 是   | 否   | 信噪比。 **系统接口:** 此接口为系统接口。                   |
158>| macAddress   | string        | 是   | 否   | 设备的MAC地址。                                              |
159>| ipAddress    | number        | 是   | 否   | WLAN连接的IP地址。                                           |
160>| suppState    | **SuppState** | 是   | 否   | 请求状态。 **系统接口:** 此接口为系统接口。                 |
161>| connState    | **ConnState** | 是   | 否   | WLAN连接状态。                                               |
162>
163>
164>
165>#### ConnState   表示WLAN连接状态的枚举
166>
167>| 名称             | 值   | 说明                       |
168>| :--------------- | :--- | :------------------------- |
169>| SCANNING         | 0    | 设备正在搜索可用的AP。     |
170>| CONNECTING       | 1    | 正在建立WLAN连接。         |
171>| AUTHENTICATING   | 2    | WLAN连接正在认证中。       |
172>| OBTAINING_IPADDR | 3    | 正在获取WLAN连接的IP地址。 |
173>| CONNECTED        | 4    | WLAN连接已建立。           |
174>| DISCONNECTING    | 5    | WLAN连接正在断开。         |
175>| DISCONNECTED     | 6    | WLAN连接已断开。           |
176>| UNKNOWN          | 7    | WLAN连接建立失败。         |
177>
178>
179>
180>#### SuppState   表示请求状态的枚举
181>
182>| 名称               | 值   | 说明             |
183>| :----------------- | :--- | :--------------- |
184>| DISCONNECTED       | 0    | 已断开。         |
185>| INTERFACE_DISABLED | 1    | 接口禁用。       |
186>| INACTIVE           | 2    | 未激活。         |
187>| SCANNING           | 3    | 扫描中。         |
188>| AUTHENTICATING     | 4    | 认证中。         |
189>| ASSOCIATING        | 5    | 关联中。         |
190>| ASSOCIATED         | 6    | 已关联。         |
191>| FOUR_WAY_HANDSHAKE | 7    | 四次握手。       |
192>| GROUP_HANDSHAKE    | 8    | 组握手。         |
193>| COMPLETED          | 9    | 所有认证已完成。 |
194>| UNINITIALIZED      | 10   | 连接建立失败。   |
195>| INVALID            | 11   | 无效值。         |
196>
197>
198>
199>#### IpInfo   IP信息
200>
201>| **名称**      | **类型** | **可读** | **可写** | **说明**            |
202>| :------------ | :------- | :------- | :------- | :------------------ |
203>| ipAddress     | number   | 是       | 否       | IP地址。            |
204>| gateway       | number   | 是       | 否       | 网关。              |
205>| netmask       | number   | 是       | 否       | 掩码。              |
206>| primaryDns    | number   | 是       | 否       | 主DNS服务器IP地址。 |
207>| secondDns     | number   | 是       | 否       | 备DNS服务器IP地址。 |
208>| serverIp      | number   | 是       | 否       | DHCP服务端IP地址。  |
209>| leaseDuration | number   | 是       | 否       | IP地址租用时长。    |
210>
211>
212>
213>#### WifiDeviceConfig  WLAN配置信息  (内容类型同上)
214
215
216
217**热点和WiFi是无法同时打开的,只要有一个打开着,另一个就无法打开**
218
219#### 功能
220
221**"Wifi打开"是其他功能测试的前提**
222
2231.  开/关Wifi(enableWifi/disableWifi224
225   - 使用指导:点击后,在设备上启动/关闭Wifi;根据设备的Wifi情况,显示返回信息。
226
227   - 限制条件:
228     - 若Wifi未开,点击"开Wifi",显示信息为"true";
229     - 若Wifi未开,点击"开Wifi",发生错误,显示信息为"false";
230     - 若Wifi已打开,点击"开Wifi",显示信息为"Wifi已经使能"。
231     - 若Wifi已打开,点击"关Wifi",显示结果为"true";
232     - 若Wifi已打开,点击"关Wifi",发生错误,显示信息为"false";
233     - 若Wifi未打开,点击"关Wifi",显示结果为"Wifi未使能"。
234
235   - 验证方法:可在设备的设置中查看Wifi的开关情况
236
237
238
2392.  获取状态(isWifiActive)
240
241   - 使用指导:点击后,基于Wifi的开关状态,判断Wifi当时的状态。
242
243   - 限制条件:
244     - 若本地Wifi打开,返回值为true
245     - 若本地Wifi关闭,返回值为false
246
247   - 验证方法:可在设备设置中查看Wifi的当前状态
248
249
250
2513.  订阅/取消订阅Wifi状态改变事件(on/off.wifiStateChange252
253   - 使用指导:为回调函数,用来监听相关类型事件的变化,并弹窗显示信息。
254
255   - 限制条件:需要在相关类型事件发生改变前,开启监听。
256
257     > 注册状态变化:
258     >
259     > - 订阅Wifi状态更改时报告的事件。
260     >
261     > - type为要侦听的Wifi状态更改事件的类型。
262     >
263     >
264     > - callback回调用于侦听Wifi状态事件。
265
266     - 若本地Wifi已关闭,返回值为0,显示信息为"inactive";
267     - 若本地Wifi已打开,返回值为1,显示信息为"active";
268     - 若本地Wifi正在打开,返回值为2,显示信息为"activating";
269     - 若本地Wifi正在关闭,返回值为3,显示信息为"de-activating";
270
271   - 验证方法:在事件变化后,查看是否有弹窗信息显示。
272
273
274
2754.  扫描(scan)
276
277   - 使用指导:点击后,扫描Wi-Fi热点。
278
279   - 限制条件:
280     - 若扫描成功,返回值为true
281     - 若扫描失败,返回值为false
282
283   - 验证方法:查看扫描的结果判断是否扫描成功,利用on.wifiScanStateChange()和getScanInfos()查看返回的结果。
284
285
286
2875.  获取扫描结果(getScanInfos (Callback/Promise) )
288   - 使用指导:点击后,返回有关扫描的Wi-Fi热点的信息(如果有的话)
289
290   - 限制条件:扫描成功
291
292   - 验证方法:查看返回的信息
293
294
295
2966.  订阅/取消订阅Wifi扫描状态改变事件(on/off.wifiScanStateChange297
298   - 使用指导:为回调函数,用来监听相关类型事件的变化,并弹窗显示信息。
299
300   - 限制条件:需要在相关类型事件发生改变前,开启监听。
301
302     > 注册状态变化:
303     >
304     > - 订阅Wifi scan状态更改时报告的事件。
305     >
306     > - type为要侦听的Wifi scan状态更改事件的类型。
307     >
308     >
309     > - callback回调用于侦听Wifi scan状态事件。
310
311     - 若scan失败,返回值为0,显示信息为"scan fail";
312     - 若scan成功,返回值为1,显示信息为"scan success";
313
314   - 验证方法:在事件变化后,查看是否有弹窗信息显示。
315
316
317
3187.  添加网络配置(addDeviceConfig (callback/promise))
319
320   - 使用指导:向设备添加Wi-Fi连接配置。
321
322   - 限制条件:WiFi已使能,且配置的参数 (config: WifiDeviceConfig) 都正确。
323
324   - 验证方法:查看返回的信息。如果添加了配置,则返回code:networkId;否则返回code: -1。
325
326
327
3288.  添加不可信网络配置 (addUntrustedConfig  (promise/callback))
329
330    - 使用指导:添加不可信任的网络配置。
331
332    - 限制条件:WiFi已使能,Wifi配置的参数 (config: WifiDeviceConfig)都正确。
333
334    - 验证方法:查看返回的信息。如果添加了不受信任的热点配置,则返回code:true,否则返回code:false。
335
336
337
3389.  移除不可信网络配置 (removeUntrustedConfig (promise/callback))
339    - 使用指导:移除指定的不受信任的网络配置。
340
341    - 限制条件:WiFi已使能,Wifi配置的参数 (config: WifiDeviceConfig) 都正确。
342
343    - 验证方法:查看返回的信息。如果删除不受信任的热点配置,则返回code:true,否则返回code :false。
344
345
346
34710.  订阅/取消订阅注册WLAN连接状态改变事件  ( on/off.wifiConnectionChange )
348
349     - 使用指导:为回调函数,用来监听相关类型事件的变化,并弹窗显示信息。
350
351     - 限制条件:需要在相关类型事件发生改变前,开启监听。
352
353       > 注册状态变化:
354       >
355       > - 订阅Wifi连接状态更改时报告的事件。
356       >
357       > - type为要侦听的Wifi连接状态更改事件的类型。
358       >
359       >
360       > - callback回调用于侦听Wifi连接状态事件。
361
362       - 若未连接,返回值为0,显示信息为"disconnected";
363       - 若已连接,返回值为1,显示信息为"connected";
364
365     - 验证方法:在事件变化后,查看是否有弹窗信息显示。
366
367
368
36911.  连接到指定网络 (connecToNetwork)
370
371     - 使用指导:连接到Wi-Fi网络
372
373     - 限制条件:WiFi已使能,networkId参数配置成功
374
375     - 验证方法:查看返回的信息。如果网络连接成功,则返回code:true,否则返回code:false。
376
377
378
37912.  连接到指定网络 (connecToDevice)
380
381     - 使用指导:连接到Wi-Fi网络
382
383     - 限制条件:WiFi已使能,Wifi参数配置 (config: WifiDeviceConfig) 成功
384
385     - 验证方法:查看返回的信息。如果网络连接成功,则返回code:true,否则返回code:false。
386
387
388
38913.  查询WLAN是否已连接 (isConnected)
390     - 使用指导:连接到Wi-Fi网络
391
392     - 限制条件:WiFi已使能
393
394     - 验证方法:查看返回的信息。如果Wi-Fi已经连接,则返回code:true,否则返回code:false。
395
396
397
39814.  获取WLAN连接信息 (getLinkedInfo (promise/callback))
399     - 使用指导:获取有关Wi-Fi连接的信息
400
401     - 限制条件:设备已经连接上了WiFi验证方法:查看返回的信息。返回Wi-Fi连接信息  ( WifiLinkedInfo )。
402
403     - 验证方法:查看返回的信息。与设备的wifi连接是否一样
404
405
406
40715.  WLAN信号强度 (getSignalLevel)
408     - 使用指导:基于Wi-Fi的RSSI和频段( band )来计算Wi-Fi信号强度
409
410     - 限制条件:设备已经连接上了WiFi,且获得了rssi(热点的信号强度)和band(WLAN接入点的频段)
411
412     - 验证方法:查看返回的信息。返回范围从0到4的Wi-Fi信号强度。
413
414
415
41616.  查询设备支持的特性 (getSupportedFeatures)
417
418     - 使用指导:获取此设备支持的功能特性
419
420     - 限制条件:无
421
422     - 验证方法:查看返回的信息。返回此设备支持的特性Id
423
424
425
42617.  判断设备是否支持相关WLAN特性( isFeatureSupported )
427
428     - 使用指导:检查此设备是否支持指定功能
429
430     - 限制条件:参数为特性功能Id (featureId: number)
431
432     - 验证方法:查看返回的信息。如果此设备支持指定的功能,则返回code:true,否则返回ode:false。
433
434
435
43618.  获取设备的MAC地址 ( getDeviceMacAddress )
437
438     - 使用指导:获取 Wi-Fi 设备的 MAC 地址
439
440     - 限制条件:必须启用 Wi-Fi。MAC 地址是唯一的,无法更改。
441
442     - 验证方法:查看返回的信息。
443
444
445
44619.  获取IP信息  ( getIpInfo )
447
448     - 使用指导:获取 Wi-Fi 连接的 IP 信息。
449
450     - 限制条件:设备已经连接上了WiFi。IP 信息包括主机 IP 地址、网关地址和 DNS 信息。
451
452     - 验证方法:查看返回的信息。返回 Wi-Fi 连接的 IP 信息。
453
454
455
45620.  获取国家码信息 ( getCountryCode )
457
458     - 使用指导:获取此设备的国家/地区代码。
459
460     - 限制条件:设备已经连接上了WiFi
461
462     - 验证方法:查看返回的信息。返回此设备的国家/地区代码。
463
464
465
46621.  断开连接的网络 ( disconnect)
467
468     - 使用指导:断开Wi-Fi网络连接
469
470     - 限制条件:设备已经连接上了WiFi
471
472     - 验证方法:查看返回的信息。如果断开网络成功,返回code:true;否则返回code:false。
473
474
475
47622.  重新关联网络 ( reassociate )
477
478     - 使用指导: 重新关联到当前网络
479
480     - 限制条件: 与当前网络取消关联
481
482     - 验证方法: 查看返回的信息。如果 Wi-Fi 网络重新关联成功,返回code :true;否则返回code:false。
483
484
485
48623.  重新连接网络 ( reconnect )
487
488     - 使用指导: 当前网络重新连接
489
490     - 限制条件: 与当前网络断开连接
491
492     - 验证方法: 查看返回的信息。如果断开网络成功,则返回code:true,否则返回 code:false
493
494
495
49624.  获取网络配置 ( getDeviceConfigs )
497
498     - 使用指导: 获取所有现有 Wi-Fi 配置的列表
499
500     - 限制条件: 只能获取在自己的应用程序上创建的 Wi-Fi 配置。
501
502     - 验证方法: 查看返回的信息。返回在应用程序上创建的所有现有 Wi-Fi 配置的列表。
503
504
505
50625.  更新网络配置 ( updateNetwork)
507
508     - 使用指导: 更新指定的 Wi-Fi 配置
509
510     - 限制条件: 参数: (config: WifiDeviceConfig) ,指示要更新的 Wi-Fi 配置
511
512     - 验证方法: 查看返回的信息。如果更新成功,则返回更新后的 Wi-Fi 配置中的网络 ID ;  如果列表中未包含指定的 Wi-Fi 配置,则返回code:-1。
513
514
515
51626.  去使能网络配置 ( disableNetwork )
517
518     - 使用指导: 禁用指定的网络
519
520     - 限制条件: 参数:netId ,标识要禁用的网络。禁用的网络将不会再次关联。
521
522     - 验证方法: 查看返回的信息。如果禁用指定的网络,则返回code: true,否则返回code:false。
523
524
525
52627.  移除所有网络配置 ( removeAllNetwork )
527
528     - 使用指导: 删除所有已保存的 Wi-Fi 配置。
529
530     - 限制条件: 无
531
532     - 验证方法: 查看返回的信息。如果删除所有保存的 Wi-Fi 配置,则返回 code:true;否则返回 code:false
533
534
535
53628.  移除指定的网络配置 ( removeDevice )
537
538     - 使用指导: 删除具有指定 ID 的 Wi-Fi 网络。
539
540       - 删除 Wi-Fi 网络后,其配置将从 Wi-Fi 配置列表中删除。
541       - 如果正在连接Wi-Fi网络,则连接将中断
542       - 应用程序只能删除它创建的 Wi-Fi 网络。
543
544     - 限制条件: 参数:id ,表示 Wi-Fi 网络的 ID (可以使用 {addDeviceConfig} 或 {getLinkedInfo} 方法获得。)
545
546     - 验证方法: 查看返回的信息。如果成功删除 Wi-Fi 网络,则返回 code:true,否则返回 code:false。
547
548
549550
55129.  订阅/取消订阅注册RSSI状态改变事件  ( on/off.wifiRssiChange )
552
553     - 使用指导:为回调函数,用来监听相关类型事件的变化,并弹窗显示信息。
554
555     - 限制条件:需要在相关类型事件发生改变前,开启监听。
556
557       > 注册状态变化:
558       >
559       > - 订阅WifiRssi状态更改时报告的事件。
560       >
561       > - type为要侦听的WifiRssi状态更改事件的类型。
562       >
563       >
564       > - callback回调用于侦听WifiRssi状态事件。
565
566       - 返回以 dBm 为单位的 RSSI 值
567
568     - 验证方法:在事件变化后,查看是否有弹窗信息显示。
569
570
571
57230.  订阅/取消订阅注册流改变事件( on/off.streamChange573
574     - 使用指导:为回调函数,用来监听相关类型事件的变化,并弹窗显示信息。
575     - 限制条件:需要在相关类型事件发生改变前,开启监听。
576
577       > 注册状态变化:
578       >
579       > - 订阅流状态更改时报告的事件。
580       >
581       > - type为要侦听的流状态更改事件的类型。
582       >
583       >
584       > - callback回调用于侦听流状态事件。
585
586       - 若流无,返回值为0,显示信息为"stream none";
587       - 若流向下,返回值为1,显示信息为"stream down";
588       - 若流向上,返回值为2,显示信息为"stream up";
589       - 若双向流,返回值为3,显示信息为"stream bidirectional";
590
591     - 验证方法:在事件变化后,查看是否有弹窗信息显示。
592