Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
You need to sign in or sign up before continuing.
未验证 提交 8c28c325 编写于 作者: O openharmony_ci 提交者： Gitee
浏览文件
操作

!18747 修改md文档格式 

Merge pull request !18747 from 刘姣姣/master
上级 8152eade e79cfb61
隐藏空白更改
内联 并排
Showing with 675 addition and 672 deletion
zh-cn/application-dev/reference/apis/js-apis-wifi.md
浏览文件 @ 8c28c325
...@@ -33,14 +33,14 @@ enableWifi(): boolean ...@@ -33,14 +33,14 @@ enableWifi(): boolean
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.enableWifi(); wifi.enableWifi();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.disableWifi ## wifi.disableWifi
...@@ -63,14 +63,15 @@ disableWifi(): boolean ...@@ -63,14 +63,15 @@ disableWifi(): boolean
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try {
wifi.disableWifi();
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
try {
wifi.disableWifi();
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## wifi.isWifiActive ## wifi.isWifiActive
...@@ -91,15 +92,15 @@ isWifiActive(): boolean ...@@ -91,15 +92,15 @@ isWifiActive(): boolean
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let isActivate = wifi.isActivate(); let isActivate = wifi.isActivate();
console.info("isActivate:" + isActivate); console.info("isActivate:" + isActivate);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.scan ## wifi.scan
...@@ -120,14 +121,14 @@ scan(): boolean ...@@ -120,14 +121,14 @@ scan(): boolean
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.scan(); wifi.scan();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.getScanInfos ## wifi.getScanInfos
...@@ -164,46 +165,47 @@ getScanInfos(callback: AsyncCallback<Array<WifiScanInfo>>): void ...@@ -164,46 +165,47 @@ getScanInfos(callback: AsyncCallback<Array<WifiScanInfo>>): void
| callback | AsyncCallback< Array<[WifiScanInfo](#wifiscaninfo)>> | 是 | 回调函数。当成功时，err为0，data为扫描到的热点；否则err为非0值，data为空。 | | callback | AsyncCallback< Array<[WifiScanInfo](#wifiscaninfo)>> | 是 | 回调函数。当成功时，err为0，data为扫描到的热点；否则err为非0值，data为空。 |
**示例：** **示例：**
```js
import wifi from '@ohos.wifi'; ```js
import wifi from '@ohos.wifi';
wifi.getScanInfos((err, result) => {
if (err) { wifi.getScanInfos((err, result) => {
console.error("get scan info error"); if (err) {
return; console.error("get scan info error");
} return;
}
var len = Object.keys(result).length;
console.log("wifi received scan info: " + len); var len = Object.keys(result).length;
for (var i = 0; i < len; ++i) { console.log("wifi received scan info: " + len);
console.info("ssid: " + result[i].ssid); for (var i = 0; i < len; ++i) {
console.info("bssid: " + result[i].bssid); console.info("ssid: " + result[i].ssid);
console.info("capabilities: " + result[i].capabilities); console.info("bssid: " + result[i].bssid);
console.info("securityType: " + result[i].securityType); console.info("capabilities: " + result[i].capabilities);
console.info("rssi: " + result[i].rssi); console.info("securityType: " + result[i].securityType);
console.info("band: " + result[i].band); console.info("rssi: " + result[i].rssi);
console.info("frequency: " + result[i].frequency); console.info("band: " + result[i].band);
console.info("channelWidth: " + result[i].channelWidth); console.info("frequency: " + result[i].frequency);
console.info("timestamp: " + result[i].timestamp); console.info("channelWidth: " + result[i].channelWidth);
} console.info("timestamp: " + result[i].timestamp);
}); }
});
wifi.getScanInfos().then(result => {
var len = Object.keys(result).length; wifi.getScanInfos().then(result => {
console.log("wifi received scan info: " + len); var len = Object.keys(result).length;
for (var i = 0; i < len; ++i) { console.log("wifi received scan info: " + len);
console.info("ssid: " + result[i].ssid); for (var i = 0; i < len; ++i) {
console.info("bssid: " + result[i].bssid); console.info("ssid: " + result[i].ssid);
console.info("capabilities: " + result[i].capabilities); console.info("bssid: " + result[i].bssid);
console.info("securityType: " + result[i].securityType); console.info("capabilities: " + result[i].capabilities);
console.info("rssi: " + result[i].rssi); console.info("securityType: " + result[i].securityType);
console.info("band: " + result[i].band); console.info("rssi: " + result[i].rssi);
console.info("frequency: " + result[i].frequency); console.info("band: " + result[i].band);
console.info("channelWidth: " + result[i].channelWidth); console.info("frequency: " + result[i].frequency);
console.info("timestamp: " + result[i].timestamp); console.info("channelWidth: " + result[i].channelWidth);
} console.info("timestamp: " + result[i].timestamp);
}); }
``` });
```
## WifiScanInfo ## WifiScanInfo
...@@ -282,24 +284,24 @@ addDeviceConfig(config: WifiDeviceConfig): Promise&lt;number&gt; ...@@ -282,24 +284,24 @@ addDeviceConfig(config: WifiDeviceConfig): Promise&lt;number&gt;
| **类型** | **说明** | | **类型** | **说明** |
| -------- | -------- | | -------- | -------- |
| Promise&lt;number&gt; | Promise对象。返回添加的网络配置ID，如果值为-1表示添加失败。 | | Promise&lt;number&gt; | Promise对象。返回添加的网络配置ID，如果值为-1表示添加失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 0 securityType : 0
}
wifi.addDeviceConfig(config).then(result => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
wifi.addDeviceConfig(config).then(result => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## WifiDeviceConfig ## WifiDeviceConfig
...@@ -378,21 +380,21 @@ addDeviceConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;number&gt;) ...@@ -378,21 +380,21 @@ addDeviceConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;number&gt;)
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 0 securityType : 0
}
wifi.addDeviceConfig(config,(error,result) => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
wifi.addDeviceConfig(config,(error,result) => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## wifi.addUntrustedConfig<sup>7+</sup> ## wifi.addUntrustedConfig<sup>7+</sup>
...@@ -415,23 +417,24 @@ addUntrustedConfig(config: WifiDeviceConfig): Promise&lt;boolean&gt; ...@@ -415,23 +417,24 @@ addUntrustedConfig(config: WifiDeviceConfig): Promise&lt;boolean&gt;
| **类型** | **说明** | | **类型** | **说明** |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | Promise对象。表示操作结果，true: 成功， false: 失败。 | | Promise&lt;boolean&gt; | Promise对象。表示操作结果，true: 成功， false: 失败。 |
**示例：** **示例：**
````` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 0 securityType : 0
}
wifi.addUntrustedConfig(config).then(result => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
````` wifi.addUntrustedConfig(config).then(result => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
```
## wifi.addUntrustedConfig<sup>7+</sup> ## wifi.addUntrustedConfig<sup>7+</sup>
...@@ -451,22 +454,22 @@ addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;boolean& ...@@ -451,22 +454,22 @@ addUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;boolean&
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数。当操作成功时，err为0，data表示操作结果，true: 成功， false: 失败。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数。当操作成功时，err为0，data表示操作结果，true: 成功， false: 失败。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
````` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 0 securityType : 0
}
wifi.addUntrustedConfig(config,(error,result) => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
````` wifi.addUntrustedConfig(config,(error,result) => {
console.info("result:" + JSON.stringify(result));
});
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
```
## wifi.removeUntrustedConfig<sup>7+</sup> ## wifi.removeUntrustedConfig<sup>7+</sup>
...@@ -489,18 +492,20 @@ removeUntrustedConfig(config: WifiDeviceConfig): Promise&lt;boolean&gt; ...@@ -489,18 +492,20 @@ removeUntrustedConfig(config: WifiDeviceConfig): Promise&lt;boolean&gt;
| **类型** | **说明** | | **类型** | **说明** |
| -------- | -------- | | -------- | -------- |
| Promise&lt;boolean&gt; | Promise对象。表示操作结果，true: 成功， false: 失败。 | | Promise&lt;boolean&gt; | Promise对象。表示操作结果，true: 成功， false: 失败。 |
``` **示例：**
import wifi from '@ohos.wifi';
```js
try { import wifi from '@ohos.wifi';
let networkId = 0;
wifi.removeUntrustedConfig(networkId).then(result => { try {
console.info("result:" + JSON.stringify(result)); let networkId = 0;
}); wifi.removeUntrustedConfig(networkId).then(result => {
}catch(error){ console.info("result:" + JSON.stringify(result));
console.error("failed:" + JSON.stringify(error)); });
} }catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
...@@ -522,17 +527,17 @@ removeUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;boole ...@@ -522,17 +527,17 @@ removeUntrustedConfig(config: WifiDeviceConfig, callback: AsyncCallback&lt;boole
| callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数。当操作成功时，err为0，data表示操作结果，true: 成功， false: 失败。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;boolean&gt; | 是 | 回调函数。当操作成功时，err为0，data表示操作结果，true: 成功， false: 失败。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let networkId = 0; let networkId = 0;
wifi.removeUntrustedConfig(networkId,(error,result) => { wifi.removeUntrustedConfig(networkId,(error,result) => {
console.info("result:" + JSON.stringify(result)); console.info("result:" + JSON.stringify(result));
}); });
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.connectToNetwork ## wifi.connectToNetwork
...@@ -561,15 +566,15 @@ connectToNetwork(networkId: number): boolean ...@@ -561,15 +566,15 @@ connectToNetwork(networkId: number): boolean
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let networkId = 0; let networkId = 0;
wifi.connectToNetwork(networkId); wifi.connectToNetwork(networkId);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.connectToDevice ## wifi.connectToDevice
...@@ -598,20 +603,20 @@ connectToDevice(config: WifiDeviceConfig): boolean ...@@ -598,20 +603,20 @@ connectToDevice(config: WifiDeviceConfig): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 3 securityType : 3
}
wifi.connectToDevice(config);
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
wifi.connectToDevice(config);
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## wifi.disconnect ## wifi.disconnect
...@@ -634,14 +639,14 @@ disconnect(): boolean ...@@ -634,14 +639,14 @@ disconnect(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.disconnect(); wifi.disconnect();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.getSignalLevel ## wifi.getSignalLevel
...@@ -668,17 +673,17 @@ getSignalLevel(rssi: number, band: number): number ...@@ -668,17 +673,17 @@ getSignalLevel(rssi: number, band: number): number
| number | 信号强度，取值范围为[0,&nbsp;4]。 | | number | 信号强度，取值范围为[0,&nbsp;4]。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let rssi = 0; let rssi = 0;
let band = 0; let band = 0;
let level = wifi.getSignalLevel(rssi,band); let level = wifi.getSignalLevel(rssi,band);
console.info("lelvel:" + JSON.stringify(lelvel)); console.info("lelvel:" + JSON.stringify(lelvel));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
...@@ -716,23 +721,23 @@ getLinkedInfo(callback: AsyncCallback&lt;WifiLinkedInfo&gt;): void ...@@ -716,23 +721,23 @@ getLinkedInfo(callback: AsyncCallback&lt;WifiLinkedInfo&gt;): void
| callback | AsyncCallback&lt;[WifiLinkedInfo](#wifilinkedinfo)&gt; | 是 | 回调函数。当获取成功时，err为0，data表示WLAN连接信息。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;[WifiLinkedInfo](#wifilinkedinfo)&gt; | 是 | 回调函数。当获取成功时，err为0，data表示WLAN连接信息。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
wifi.getLinkedInfo((err, data) => { wifi.getLinkedInfo((err, data) => {
if (err) { if (err) {
console.error("get linked info error"); console.error("get linked info error");
return; return;
} }
console.info("get wifi linked info: " + JSON.stringify(data)); console.info("get wifi linked info: " + JSON.stringify(data));
}); });
wifi.getLinkedInfo().then(data => { wifi.getLinkedInfo().then(data => {
console.info("get wifi linked info: " + JSON.stringify(data)); console.info("get wifi linked info: " + JSON.stringify(data));
}).catch(error => { }).catch(error => {
console.info("get linked info error"); console.info("get linked info error");
}); });
``` ```
## WifiLinkedInfo ## WifiLinkedInfo
...@@ -877,16 +882,16 @@ isFeatureSupported(featureId: number): boolean ...@@ -877,16 +882,16 @@ isFeatureSupported(featureId: number): boolean
| boolean | true:支持，&nbsp;false:不支持。 | | boolean | true:支持，&nbsp;false:不支持。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let featureId = 0； let featureId = 0；
let ret = wifi.isFeatureSupported(featureId); let ret = wifi.isFeatureSupported(featureId);
console.info("isFeatureSupported:" + ret); console.info("isFeatureSupported:" + ret);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
...@@ -909,15 +914,15 @@ getDeviceMacAddress(): string[] ...@@ -909,15 +914,15 @@ getDeviceMacAddress(): string[]
| string[] | MAC地址。 | | string[] | MAC地址。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let ret = wifi.getDeviceMacAddress(); let ret = wifi.getDeviceMacAddress();
console.info("deviceMacAddress:" + JSON.stringify(ret)); console.info("deviceMacAddress:" + JSON.stringify(ret));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
...@@ -938,15 +943,15 @@ getIpInfo(): IpInfo ...@@ -938,15 +943,15 @@ getIpInfo(): IpInfo
| [IpInfo](#ipinfo7) | IP信息。 | | [IpInfo](#ipinfo7) | IP信息。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let info = wifi.getIpInfo(); let info = wifi.getIpInfo();
console.info("info:" + JSON.stringify(info)); console.info("info:" + JSON.stringify(info));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## IpInfo<sup>7+</sup> ## IpInfo<sup>7+</sup>
...@@ -983,15 +988,15 @@ getCountryCode(): string ...@@ -983,15 +988,15 @@ getCountryCode(): string
| string | 国家码。 | | string | 国家码。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let code = wifi.getCountryCode(); let code = wifi.getCountryCode();
console.info("code:" + code); console.info("code:" + code);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.reassociate<sup>7+</sup> ## wifi.reassociate<sup>7+</sup>
...@@ -1013,14 +1018,14 @@ reassociate(): boolean ...@@ -1013,14 +1018,14 @@ reassociate(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.reassociate(); wifi.reassociate();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.reconnect<sup>7+</sup> ## wifi.reconnect<sup>7+</sup>
...@@ -1042,14 +1047,14 @@ reconnect(): boolean ...@@ -1042,14 +1047,14 @@ reconnect(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.reconnect(); wifi.reconnect();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.getDeviceConfigs<sup>7+</sup> ## wifi.getDeviceConfigs<sup>7+</sup>
...@@ -1071,15 +1076,15 @@ getDeviceConfigs(): &nbsp;Array&lt;[WifiDeviceConfig](#wifideviceconfig)&gt; ...@@ -1071,15 +1076,15 @@ getDeviceConfigs(): &nbsp;Array&lt;[WifiDeviceConfig](#wifideviceconfig)&gt;
| &nbsp;Array&lt;[WifiDeviceConfig](#wifideviceconfig)&gt; | 网络配置信息的数组。 | | &nbsp;Array&lt;[WifiDeviceConfig](#wifideviceconfig)&gt; | 网络配置信息的数组。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let configs = wifi.getDeviceConfigs(); let configs = wifi.getDeviceConfigs();
console.info("configs:" + JSON.stringify(configs)); console.info("configs:" + JSON.stringify(configs));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.updateNetwork<sup>7+</sup> ## wifi.updateNetwork<sup>7+</sup>
...@@ -1107,20 +1112,20 @@ updateNetwork(config: WifiDeviceConfig): number ...@@ -1107,20 +1112,20 @@ updateNetwork(config: WifiDeviceConfig): number
| number | 返回更新的网络配置ID，如果值为-1表示更新失败。 | | number | 返回更新的网络配置ID，如果值为-1表示更新失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid : "****", ssid : "****",
preSharedKey : "****", preSharedKey : "****",
securityType : 3 securityType : 3
}
let ret = wifi.updateNetwork(config);
console.error("ret:" + ret);
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
let ret = wifi.updateNetwork(config);
console.error("ret:" + ret);
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## wifi.disableNetwork<sup>7+</sup> ## wifi.disableNetwork<sup>7+</sup>
...@@ -1148,15 +1153,15 @@ disableNetwork(netId: number): boolean ...@@ -1148,15 +1153,15 @@ disableNetwork(netId: number): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let netId = 0; let netId = 0;
wifi.disableNetwork(netId); wifi.disableNetwork(netId);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.removeAllNetwork<sup>7+</sup> ## wifi.removeAllNetwork<sup>7+</sup>
...@@ -1178,14 +1183,14 @@ removeAllNetwork(): boolean ...@@ -1178,14 +1183,14 @@ removeAllNetwork(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.removeAllNetwork(); wifi.removeAllNetwork();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.removeDevice<sup>7+</sup> ## wifi.removeDevice<sup>7+</sup>
...@@ -1213,15 +1218,15 @@ removeDevice(id: number): boolean ...@@ -1213,15 +1218,15 @@ removeDevice(id: number): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let id = 0; let id = 0;
wifi.removeDevice(id); wifi.removeDevice(id);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.enableHotspot<sup>7+</sup> ## wifi.enableHotspot<sup>7+</sup>
...@@ -1243,14 +1248,14 @@ enableHotspot(): boolean ...@@ -1243,14 +1248,14 @@ enableHotspot(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。| | boolean | true:操作成功，&nbsp;false:操作失败。|
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.enableHotspot(); wifi.enableHotspot();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.disableHotspot<sup>7+</sup> ## wifi.disableHotspot<sup>7+</sup>
...@@ -1272,14 +1277,14 @@ disableHotspot(): boolean ...@@ -1272,14 +1277,14 @@ disableHotspot(): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。| | boolean | true:操作成功，&nbsp;false:操作失败。|
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifiManager'; import wifi from '@ohos.wifiManager';
try { try {
wifiManager.disableHotspot(); wifiManager.disableHotspot();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.isHotspotDualBandSupported<sup>7+</sup> ## wifi.isHotspotDualBandSupported<sup>7+</sup>
...@@ -1301,15 +1306,15 @@ isHotspotDualBandSupported(): boolean ...@@ -1301,15 +1306,15 @@ isHotspotDualBandSupported(): boolean
| boolean | true:支持，&nbsp;false:不支持。| | boolean | true:支持，&nbsp;false:不支持。|
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let ret = wifi.isHotspotDualBandSupported(); let ret = wifi.isHotspotDualBandSupported();
console.info("result:" + ret); console.info("result:" + ret);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.isHotspotActive<sup>7+</sup> ## wifi.isHotspotActive<sup>7+</sup>
...@@ -1331,15 +1336,15 @@ isHotspotActive(): boolean ...@@ -1331,15 +1336,15 @@ isHotspotActive(): boolean
| boolean | true:已使能，&nbsp;false:未使能。| | boolean | true:已使能，&nbsp;false:未使能。|
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let ret = wifi.isHotspotActive(); let ret = wifi.isHotspotActive();
console.info("result:" + ret); console.info("result:" + ret);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.setHotspotConfig<sup>7+</sup> ## wifi.setHotspotConfig<sup>7+</sup>
...@@ -1367,23 +1372,23 @@ setHotspotConfig(config: HotspotConfig): boolean ...@@ -1367,23 +1372,23 @@ setHotspotConfig(config: HotspotConfig): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
ssid: "****", ssid: "****",
securityType: 3, securityType: 3,
band: 0, band: 0,
channel: 0, channel: 0,
preSharedKey: "****", preSharedKey: "****",
maxConn: 0 maxConn: 0
}
let ret = wifi.setHotspotConfig();
console.info("result:" + ret);
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
let ret = wifi.setHotspotConfig();
console.info("result:" + ret);
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## HotspotConfig<sup>7+</sup> ## HotspotConfig<sup>7+</sup>
...@@ -1422,15 +1427,15 @@ getHotspotConfig(): HotspotConfig ...@@ -1422,15 +1427,15 @@ getHotspotConfig(): HotspotConfig
| [HotspotConfig](#hotspotconfig7) | 热点的配置信息。 | | [HotspotConfig](#hotspotconfig7) | 热点的配置信息。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = wifi.getHotspotConfig(); let config = wifi.getHotspotConfig();
console.info("result:" + JSON.stringify(config)); console.info("result:" + JSON.stringify(config));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.getStations<sup>7+</sup> ## wifi.getStations<sup>7+</sup>
...@@ -1452,15 +1457,15 @@ getStations(): &nbsp;Array&lt;[StationInfo](#stationinfo7)&gt; ...@@ -1452,15 +1457,15 @@ getStations(): &nbsp;Array&lt;[StationInfo](#stationinfo7)&gt;
| &nbsp;Array&lt;[StationInfo](#stationinfo7)&gt; | 连接的设备数组。 | | &nbsp;Array&lt;[StationInfo](#stationinfo7)&gt; | 连接的设备数组。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let stations = wifi.getStations(); let stations = wifi.getStations();
console.info("result:" + JSON.stringify(stations)); console.info("result:" + JSON.stringify(stations));
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## StationInfo<sup>7+</sup> ## StationInfo<sup>7+</sup>
...@@ -1538,20 +1543,20 @@ getP2pLinkedInfo(callback: AsyncCallback&lt;WifiP2pLinkedInfo&gt;): void ...@@ -1538,20 +1543,20 @@ getP2pLinkedInfo(callback: AsyncCallback&lt;WifiP2pLinkedInfo&gt;): void
| callback | AsyncCallback&lt;[WifiP2pLinkedInfo](#wifip2plinkedinfo8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示P2P连接信息。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;[WifiP2pLinkedInfo](#wifip2plinkedinfo8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示P2P连接信息。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
wifi.getP2pLinkedInfo((err, data) => { wifi.getP2pLinkedInfo((err, data) => {
if (err) { if (err) {
console.error("get p2p linked info error"); console.error("get p2p linked info error");
return; return;
} }
console.info("get wifi p2p linked info: " + JSON.stringify(data)); console.info("get wifi p2p linked info: " + JSON.stringify(data));
}); });
wifi.getP2pLinkedInfo().then(data => { wifi.getP2pLinkedInfo().then(data => {
console.info("get wifi p2p linked info: " + JSON.stringify(data)); console.info("get wifi p2p linked info: " + JSON.stringify(data));
}); });
``` ```
## wifi.getCurrentGroup<sup>8+</sup> ## wifi.getCurrentGroup<sup>8+</sup>
...@@ -1588,20 +1593,20 @@ getCurrentGroup(callback: AsyncCallback&lt;WifiP2pGroupInfo&gt;): void ...@@ -1588,20 +1593,20 @@ getCurrentGroup(callback: AsyncCallback&lt;WifiP2pGroupInfo&gt;): void
| callback | AsyncCallback&lt;[WifiP2pGroupInfo](#wifip2pgroupinfo8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示当前组信息。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;[WifiP2pGroupInfo](#wifip2pgroupinfo8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示当前组信息。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
wifi.getCurrentGroup((err, data) => { wifi.getCurrentGroup((err, data) => {
if (err) { if (err) {
console.error("get current P2P group error"); console.error("get current P2P group error");
return; return;
} }
console.info("get current P2P group: " + JSON.stringify(data)); console.info("get current P2P group: " + JSON.stringify(data));
}); });
wifi.getCurrentGroup().then(data => { wifi.getCurrentGroup().then(data => {
console.info("get current P2P group: " + JSON.stringify(data)); console.info("get current P2P group: " + JSON.stringify(data));
}); });
``` ```
## wifi.getP2pPeerDevices<sup>8+</sup> ## wifi.getP2pPeerDevices<sup>8+</sup>
...@@ -1638,20 +1643,20 @@ getP2pPeerDevices(callback: AsyncCallback&lt;WifiP2pDevice[]&gt;): void ...@@ -1638,20 +1643,20 @@ getP2pPeerDevices(callback: AsyncCallback&lt;WifiP2pDevice[]&gt;): void
| callback | AsyncCallback&lt;[WifiP2pDevice[]](#wifip2pdevice8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示对端设备列表信息。如果error为非0，表示处理出现错误。 | | callback | AsyncCallback&lt;[WifiP2pDevice[]](#wifip2pdevice8)&gt; | 是 | 回调函数。当操作成功时，err为0，data表示对端设备列表信息。如果error为非0，表示处理出现错误。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifiManager'; import wifi from '@ohos.wifiManager';
wifi.getP2pPeerDevices((err, data) => { wifi.getP2pPeerDevices((err, data) => {
if (err) { if (err) {
console.error("get P2P peer devices error"); console.error("get P2P peer devices error");
return; return;
} }
console.info("get P2P peer devices: " + JSON.stringify(data)); console.info("get P2P peer devices: " + JSON.stringify(data));
}); });
wifi.getP2pPeerDevices().then(data => { wifi.getP2pPeerDevices().then(data => {
console.info("get P2P peer devices: " + JSON.stringify(data)); console.info("get P2P peer devices: " + JSON.stringify(data));
}); });
``` ```
## WifiP2pDevice<sup>8+</sup> ## WifiP2pDevice<sup>8+</sup>
...@@ -1707,22 +1712,22 @@ createGroup(config: WifiP2PConfig): boolean ...@@ -1707,22 +1712,22 @@ createGroup(config: WifiP2PConfig): boolean
| boolean | true:创建群组操作执行成功，&nbsp;false:创建群组操作执行失败。 | | boolean | true:创建群组操作执行成功，&nbsp;false:创建群组操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let config = { let config = {
deviceAddress: "****", deviceAddress: "****",
netId: 0, netId: 0,
passphrase: "*****", passphrase: "*****",
groupName: "****", groupName: "****",
goBand: 0 goBand: 0
}
wifi.createGroup(config);
}catch(error){
console.error("failed:" + JSON.stringify(error));
} }
wifi.createGroup(config);
}catch(error){
console.error("failed:" + JSON.stringify(error));
}
``` ```
## WifiP2PConfig<sup>8+</sup> ## WifiP2PConfig<sup>8+</sup>
...@@ -1770,14 +1775,14 @@ removeGroup(): boolean ...@@ -1770,14 +1775,14 @@ removeGroup(): boolean
| boolean | true:操作执行成功，&nbsp;false:操作执行失败。 | | boolean | true:操作执行成功，&nbsp;false:操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.removeGroup(); wifi.removeGroup();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.p2pConnect<sup>8+</sup> ## wifi.p2pConnect<sup>8+</sup>
...@@ -1805,71 +1810,71 @@ p2pConnect(config: WifiP2PConfig): boolean ...@@ -1805,71 +1810,71 @@ p2pConnect(config: WifiP2PConfig): boolean
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pConnectionChangeFunc = result => { var recvP2pConnectionChangeFunc = result => {
console.info("p2p connection change receive event: " + JSON.stringify(result)); console.info("p2p connection change receive event: " + JSON.stringify(result));
wifi.getP2pLinkedInfo((err, data) => { wifi.getP2pLinkedInfo((err, data) => {
if (err) { if (err) {
console.error('failed to get getP2pLinkedInfo: ' + JSON.stringify(err)); console.error('failed to get getP2pLinkedInfo: ' + JSON.stringify(err));
return; return;
} }
console.info("get getP2pLinkedInfo: " + JSON.stringify(data)); console.info("get getP2pLinkedInfo: " + JSON.stringify(data));
}); });
} }
wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc); wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc);
var recvP2pDeviceChangeFunc = result => { var recvP2pDeviceChangeFunc = result => {
console.info("p2p device change receive event: " + JSON.stringify(result)); console.info("p2p device change receive event: " + JSON.stringify(result));
} }
wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc); wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc);
var recvP2pPeerDeviceChangeFunc = result => { var recvP2pPeerDeviceChangeFunc = result => {
console.info("p2p peer device change receive event: " + JSON.stringify(result)); console.info("p2p peer device change receive event: " + JSON.stringify(result));
wifi.getP2pPeerDevices((err, data) => { wifi.getP2pPeerDevices((err, data) => {
if (err) { if (err) {
console.error('failed to get peer devices: ' + JSON.stringify(err)); console.error('failed to get peer devices: ' + JSON.stringify(err));
return; return;
} }
console.info("get peer devices: " + JSON.stringify(data)); console.info("get peer devices: " + JSON.stringify(data));
var len = Object.keys(data).length; var len = Object.keys(data).length;
for (var i = 0; i < len; ++i) { for (var i = 0; i < len; ++i) {
if (data[i].deviceName === "my_test_device") { if (data[i].deviceName === "my_test_device") {
console.info("p2p connect to test device: " + data[i].deviceAddress); console.info("p2p connect to test device: " + data[i].deviceAddress);
var config = { var config = {
"deviceAddress":data[i].deviceAddress, "deviceAddress":data[i].deviceAddress,
"netId":-2, "netId":-2,
"passphrase":"", "passphrase":"",
"groupName":"", "groupName":"",
"goBand":0, "goBand":0,
} }
wifi.p2pConnect(config); wifi.p2pConnect(config);
} }
} }
}); });
} }
wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);
var recvP2pPersistentGroupChangeFunc = () => { var recvP2pPersistentGroupChangeFunc = () => {
console.info("p2p persistent group change receive event"); console.info("p2p persistent group change receive event");
wifi.getCurrentGroup((err, data) => { wifi.getCurrentGroup((err, data) => {
if (err) { if (err) {
console.error('failed to get current group: ' + JSON.stringify(err)); console.error('failed to get current group: ' + JSON.stringify(err));
return; return;
} }
console.info("get current group: " + JSON.stringify(data)); console.info("get current group: " + JSON.stringify(data));
}); });
} }
wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);
setTimeout(function() {wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);}, 125 * 1000);
setTimeout(function() {wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);}, 125 * 1000); setTimeout(function() {wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);}, 125 * 1000);
console.info("start discover devices -> " + wifi.startDiscoverDevices()); console.info("start discover devices -> " + wifi.startDiscoverDevices());
``` ```
## wifi.p2pCancelConnect<sup>8+</sup> ## wifi.p2pCancelConnect<sup>8+</sup>
...@@ -1888,14 +1893,14 @@ p2pCancelConnect(): boolean ...@@ -1888,14 +1893,14 @@ p2pCancelConnect(): boolean
| boolean | true:操作执行成功，&nbsp;false:操作执行失败。 | | boolean | true:操作执行成功，&nbsp;false:操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.p2pCancelConnect(); wifi.p2pCancelConnect();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.startDiscoverDevices<sup>8+</sup> ## wifi.startDiscoverDevices<sup>8+</sup>
...@@ -1915,14 +1920,14 @@ startDiscoverDevices(): boolean ...@@ -1915,14 +1920,14 @@ startDiscoverDevices(): boolean
| boolean | true:操作执行成功，&nbsp;false:操作执行失败。 | | boolean | true:操作执行成功，&nbsp;false:操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.startDiscoverDevices(); wifi.startDiscoverDevices();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.stopDiscoverDevices<sup>8+</sup> ## wifi.stopDiscoverDevices<sup>8+</sup>
...@@ -1942,14 +1947,14 @@ stopDiscoverDevices(): boolean ...@@ -1942,14 +1947,14 @@ stopDiscoverDevices(): boolean
| boolean | true:操作执行成功，操作执行失败。 | | boolean | true:操作执行成功，操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
wifi.stopDiscoverDevices(); wifi.stopDiscoverDevices();
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.deletePersistentGroup<sup>8+</sup> ## wifi.deletePersistentGroup<sup>8+</sup>
...@@ -1978,15 +1983,15 @@ deletePersistentGroup(netId: number): boolean ...@@ -1978,15 +1983,15 @@ deletePersistentGroup(netId: number): boolean
| boolean | true:操作执行成功，操作执行失败。 | | boolean | true:操作执行成功，操作执行失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let netId = 0; let netId = 0;
wifi.deletePersistentGroup(netId); wifi.deletePersistentGroup(netId);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## WifiP2pGroupInfo<sup>8+</sup> ## WifiP2pGroupInfo<sup>8+</sup>
...@@ -2033,15 +2038,15 @@ setDeviceName(devName: string): boolean ...@@ -2033,15 +2038,15 @@ setDeviceName(devName: string): boolean
| boolean | true:操作成功，&nbsp;false:操作失败。 | | boolean | true:操作成功，&nbsp;false:操作失败。 |
**示例：** **示例：**
``` ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
try { try {
let name = "****"; let name = "****";
wifi.setDeviceName(netId); wifi.setDeviceName(netId);
}catch(error){ }catch(error){
console.error("failed:" + JSON.stringify(error)); console.error("failed:" + JSON.stringify(error));
} }
``` ```
## wifi.on('wifiStateChange')<sup>7+</sup> ## wifi.on('wifiStateChange')<sup>7+</sup>
...@@ -2089,19 +2094,19 @@ off(type: "wifiStateChange", callback?: Callback&lt;number&gt;): void ...@@ -2089,19 +2094,19 @@ off(type: "wifiStateChange", callback?: Callback&lt;number&gt;): void
| callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvPowerNotifyFunc = result => { var recvPowerNotifyFunc = result => {
console.info("Receive power state change event: " + result); console.info("Receive power state change event: " + result);
} }
// Register event // Register event
wifi.on("wifiStateChange", recvPowerNotifyFunc); wifi.on("wifiStateChange", recvPowerNotifyFunc);
// Unregister event // Unregister event
wifi.off("wifiStateChange", recvPowerNotifyFunc); wifi.off("wifiStateChange", recvPowerNotifyFunc);
``` ```
## wifi.on('wifiConnectionChange')<sup>7+</sup> ## wifi.on('wifiConnectionChange')<sup>7+</sup>
...@@ -2147,20 +2152,20 @@ off(type: "wifiConnectionChange", callback?: Callback&lt;number&gt;): void ...@@ -2147,20 +2152,20 @@ off(type: "wifiConnectionChange", callback?: Callback&lt;number&gt;): void
| callback | Callback&lt;number&gt; | 否 | 连接状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 连接状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvWifiConnectionChangeFunc = result => { var recvWifiConnectionChangeFunc = result => {
console.info("Receive wifi connection change event: " + result); console.info("Receive wifi connection change event: " + result);
} }
// Register event // Register event
wifi.on("wifiConnectionChange", recvWifiConnectionChangeFunc); wifi.on("wifiConnectionChange", recvWifiConnectionChangeFunc);
// Unregister event // Unregister event
wifi.off("wifiConnectionChange", recvWifiConnectionChangeFunc); wifi.off("wifiConnectionChange", recvWifiConnectionChangeFunc);
``` ```
## wifi.on('wifiScanStateChange')<sup>7+</sup> ## wifi.on('wifiScanStateChange')<sup>7+</sup>
on(type: "wifiScanStateChange", callback: Callback&lt;number&gt;): void on(type: "wifiScanStateChange", callback: Callback&lt;number&gt;): void
...@@ -2204,20 +2209,20 @@ off(type: "wifiScanStateChange", callback?: Callback&lt;number&gt;): void ...@@ -2204,20 +2209,20 @@ off(type: "wifiScanStateChange", callback?: Callback&lt;number&gt;): void
| callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvWifiScanStateChangeFunc = result => { var recvWifiScanStateChangeFunc = result => {
console.info("Receive Wifi scan state change event: " + result); console.info("Receive Wifi scan state change event: " + result);
} }
// Register event // Register event
wifi.on("wifiScanStateChange", recvWifiScanStateChangeFunc); wifi.on("wifiScanStateChange", recvWifiScanStateChangeFunc);
// Unregister event // Unregister event
wifi.off("wifiScanStateChange", recvWifiScanStateChangeFunc); wifi.off("wifiScanStateChange", recvWifiScanStateChangeFunc);
``` ```
## wifi.on('wifiRssiChange')<sup>7+</sup> ## wifi.on('wifiRssiChange')<sup>7+</sup>
on(type: "wifiRssiChange", callback: Callback&lt;number&gt;): void on(type: "wifiRssiChange", callback: Callback&lt;number&gt;): void
...@@ -2254,20 +2259,19 @@ off(type: "wifiRssiChange", callback?: Callback&lt;number&gt;): void ...@@ -2254,20 +2259,19 @@ off(type: "wifiRssiChange", callback?: Callback&lt;number&gt;): void
| callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvWifiRssiChangeFunc = result => { var recvWifiRssiChangeFunc = result => {
console.info("Receive wifi rssi change event: " + result); console.info("Receive wifi rssi change event: " + result);
} }
// Register event // Register event
wifi.on("wifiRssiChange", recvWifiRssiChangeFunc); wifi.on("wifiRssiChange", recvWifiRssiChangeFunc);
// Unregister event // Unregister event
wifi.off("wifiRssiChange", recvWifiRssiChangeFunc); wifi.off("wifiRssiChange", recvWifiRssiChangeFunc);
``` ```
## wifi.on('hotspotStateChange')<sup>7+</sup> ## wifi.on('hotspotStateChange')<sup>7+</sup>
on(type: "hotspotStateChange", callback: Callback&lt;number&gt;): void on(type: "hotspotStateChange", callback: Callback&lt;number&gt;): void
...@@ -2295,20 +2299,19 @@ on(type: "hotspotStateChange", callback: Callback&lt;number&gt;): void ...@@ -2295,20 +2299,19 @@ on(type: "hotspotStateChange", callback: Callback&lt;number&gt;): void
| 3 | 去激活中。 | | 3 | 去激活中。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvHotspotStateChangeFunc = result => {
console.info("Receive hotspot state change event: " + result);
}
// Register event
wifi.on("hotspotStateChange", recvHotspotStateChangeFunc);
// Unregister event
wifi.off("hotspotStateChange", recvHotspotStateChangeFunc);
```
var recvHotspotStateChangeFunc = result => {
console.info("Receive hotspot state change event: " + result);
}
// Register event
wifi.on("hotspotStateChange", recvHotspotStateChangeFunc);
// Unregister event
wifi.off("hotspotStateChange", recvHotspotStateChangeFunc);
```
## wifi.off('hotspotStateChange')<sup>7+</sup> ## wifi.off('hotspotStateChange')<sup>7+</sup>
...@@ -2371,21 +2374,21 @@ off(type: "p2pStateChange", callback?: Callback&lt;number&gt;): void ...@@ -2371,21 +2374,21 @@ off(type: "p2pStateChange", callback?: Callback&lt;number&gt;): void
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 固定填"p2pStateChange"字符串。 | | type | string | 是 | 固定填"p2pStateChange"字符串。 |
| callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pStateChangeFunc = result => { var recvP2pStateChangeFunc = result => {
console.info("Receive p2p state change event: " + result); console.info("Receive p2p state change event: " + result);
} }
// Register event // Register event
wifi.on("p2pStateChange", recvP2pStateChangeFunc); wifi.on("p2pStateChange", recvP2pStateChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pStateChange", recvP2pStateChangeFunc); wifi.off("p2pStateChange", recvP2pStateChangeFunc);
``` ```
## wifi.on('p2pConnectionChange')<sup>8+</sup> ## wifi.on('p2pConnectionChange')<sup>8+</sup>
...@@ -2423,20 +2426,20 @@ off(type: "p2pConnectionChange", callback?: Callback&lt;WifiP2pLinkedInfo&gt;): ...@@ -2423,20 +2426,20 @@ off(type: "p2pConnectionChange", callback?: Callback&lt;WifiP2pLinkedInfo&gt;):
| callback | Callback&lt;[WifiP2pLinkedInfo](#wifip2plinkedinfo8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;[WifiP2pLinkedInfo](#wifip2plinkedinfo8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pConnectionChangeFunc = result => { var recvP2pConnectionChangeFunc = result => {
console.info("Receive p2p connection change event: " + result); console.info("Receive p2p connection change event: " + result);
} }
// Register event // Register event
wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc); wifi.on("p2pConnectionChange", recvP2pConnectionChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc); wifi.off("p2pConnectionChange", recvP2pConnectionChangeFunc);
``` ```
## wifi.on('p2pDeviceChange')<sup>8+</sup> ## wifi.on('p2pDeviceChange')<sup>8+</sup>
on(type: "p2pDeviceChange", callback: Callback&lt;WifiP2pDevice&gt;): void on(type: "p2pDeviceChange", callback: Callback&lt;WifiP2pDevice&gt;): void
...@@ -2473,20 +2476,20 @@ off(type: "p2pDeviceChange", callback?: Callback&lt;WifiP2pDevice&gt;): void ...@@ -2473,20 +2476,20 @@ off(type: "p2pDeviceChange", callback?: Callback&lt;WifiP2pDevice&gt;): void
| callback | Callback&lt;[WifiP2pDevice](#wifip2pdevice8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;[WifiP2pDevice](#wifip2pdevice8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pDeviceChangeFunc = result => { var recvP2pDeviceChangeFunc = result => {
console.info("Receive recv p2p device change event: " + result); console.info("Receive recv p2p device change event: " + result);
} }
// Register event // Register event
wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc); wifi.on("p2pDeviceChange", recvP2pDeviceChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc); wifi.off("p2pDeviceChange", recvP2pDeviceChangeFunc);
``` ```
## wifi.on('p2pPeerDeviceChange')<sup>8+</sup> ## wifi.on('p2pPeerDeviceChange')<sup>8+</sup>
on(type: "p2pPeerDeviceChange", callback: Callback&lt;WifiP2pDevice[]&gt;): void on(type: "p2pPeerDeviceChange", callback: Callback&lt;WifiP2pDevice[]&gt;): void
...@@ -2523,19 +2526,19 @@ off(type: "p2pPeerDeviceChange", callback?: Callback&lt;WifiP2pDevice[]&gt;): vo ...@@ -2523,19 +2526,19 @@ off(type: "p2pPeerDeviceChange", callback?: Callback&lt;WifiP2pDevice[]&gt;): vo
| callback | Callback&lt;[WifiP2pDevice[]](#wifip2pdevice8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;[WifiP2pDevice[]](#wifip2pdevice8)&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pPeerDeviceChangeFunc = result => { var recvP2pPeerDeviceChangeFunc = result => {
console.info("Receive recv p2p peer device change event: " + result); console.info("Receive recv p2p peer device change event: " + result);
} }
// Register event // Register event
wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); wifi.on("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc); wifi.off("p2pPeerDeviceChange", recvP2pPeerDeviceChangeFunc);
``` ```
## wifi.on('p2pPersistentGroupChange')<sup>8+</sup> ## wifi.on('p2pPersistentGroupChange')<sup>8+</sup>
...@@ -2571,22 +2574,22 @@ off(type: "p2pPersistentGroupChange", callback?: Callback&lt;void&gt;): void ...@@ -2571,22 +2574,22 @@ off(type: "p2pPersistentGroupChange", callback?: Callback&lt;void&gt;): void
| -------- | -------- | -------- | -------- | | -------- | -------- | -------- | -------- |
| type | string | 是 | 固定填"p2pPersistentGroupChange"字符串。 | | type | string | 是 | 固定填"p2pPersistentGroupChange"字符串。 |
| callback | Callback&lt;void&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;void&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pPersistentGroupChangeFunc = result => { var recvP2pPersistentGroupChangeFunc = result => {
console.info("Receive recv p2p persistent group change event: " + result); console.info("Receive recv p2p persistent group change event: " + result);
} }
// Register event // Register event
wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); wifi.on("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc); wifi.off("p2pPersistentGroupChange", recvP2pPersistentGroupChangeFunc);
``` ```
## wifi.on('p2pDiscoveryChange')<sup>8+</sup> ## wifi.on('p2pDiscoveryChange')<sup>8+</sup>
...@@ -2631,16 +2634,16 @@ off(type: "p2pDiscoveryChange", callback?: Callback&lt;number&gt;): void ...@@ -2631,16 +2634,16 @@ off(type: "p2pDiscoveryChange", callback?: Callback&lt;number&gt;): void
| callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 | | callback | Callback&lt;number&gt; | 否 | 状态改变回调函数。如果callback不填，将取消注册该事件关联的所有回调函数。 |
**示例：** **示例：**
```js ```js
import wifi from '@ohos.wifi'; import wifi from '@ohos.wifi';
var recvP2pDiscoveryChangeFunc = result => { var recvP2pDiscoveryChangeFunc = result => {
console.info("Receive recv p2p discovery change event: " + result); console.info("Receive recv p2p discovery change event: " + result);
} }
// Register event // Register event
wifi.on("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc); wifi.on("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc);
// Unregister event // Unregister event
wifi.off("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc); wifi.off("p2pDiscoveryChange", recvP2pDiscoveryChangeFunc);
``` ```
\ No newline at end of file \ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或