diff --git a/zh-cn/application-dev/reference/apis/js-apis-wifi.md b/zh-cn/application-dev/reference/apis/js-apis-wifi.md index 7ccc783711c4ab5ea2e6e362eb1067e46ce266e0..07614ac052d985bbfbbcaf557a3ecb7e311df34f 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-wifi.md +++ b/zh-cn/application-dev/reference/apis/js-apis-wifi.md @@ -1693,7 +1693,56 @@ off(type: "wifiRssiChange", callback?: Callback<number>): void | -------- | -------- | -------- | -------- | | type | string | 是 | 固定填"wifiRssiChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。 | + + ## wifi.on('streamChange')7+ + +on(type: "streamChange", callback: Callback<number>): void + +注册WIFI流更改事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION + +**系统能力:** SystemCapability.Communication.WiFi.STA + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"streamChange"字符串。 | + | callback | Callback<number> | 是 | 状态改变回调函数,返回0:无,1:向下,2:向上,3:双向。 | + +## wifi.off('streamChange')7+ +off(type: "streamChange", callback: Callback<number>): void + +取消注册WIFI流更改事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_CONNECTION + +**系统能力:** SystemCapability.Communication.WiFi.STA + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"streamChange"字符串。 | + | callback | Callback<number> | 是 | 状态改变回调函数,返回0:无,1:向下,2:向上,3:双向。 | + +**示例:** +```js +import wifi from '@ohos.wifi'; + +var recvStreamChangeFunc = result => { + console.info("Receive stream change event: " + result); +} + +// Register event +wifi.on("streamChange", recvStreamChangeFunc); + +// Unregister event +wifi.off("streamChange", recvStreamChangeFunc); + +``` ## wifi.on('hotspotStateChange')7+ @@ -1739,6 +1788,105 @@ off(type: "hotspotStateChange", callback?: Callback<number>): void | type | string | 是 | 固定填"hotspotStateChange"字符串。 | | callback | Callback<number> | 否 | 状态改变回调函数。如果callback不填,将去注册该事件关联的所有回调函数。 | +## wifi.on('hotspotStaJoin')7+ + +on(type: "hotspotStaJoin", callback: Callback<StationInfo>): void + +注册wifi热点sta加入事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT + +**系统能力:** SystemCapability.Communication.WiFi.AP.Core + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"hotspotStaJoin"字符串。 | + | callback | Callback<StationInfo> | 是 | 状态改变回调函数。 | + +## wifi.off('hotspotStaJoin')7+ + +off(type: "hotspotStaJoin", callback: Callback<StationInfo>): void + +取消注册wifi热点sta加入事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT + +**系统能力:** SystemCapability.Communication.WiFi.AP.Core + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"hotspotStaJoin"字符串。 | + | callback | Callback<StationInfo> | 是 | 状态改变回调函数。 | + + **示例:** +```js +import wifi from '@ohos.wifi'; + +var recvHotspotStaJoinFunc = result => { + console.info("Receive hotspot sta join event: " + result); +} + +// Register event +wifi.on("hotspotStaJoin", recvHotspotStaJoinFunc); + +// Unregister event +wifi.off("hotspotStaJoin", recvHotspotStaJoinFunc); + +``` + +## wifi.on('hotspotStaLeave')7+ + +on(type: "hotspotStaLeave", callback: Callback<StationInfo>): void + +注册wifi热点sta离开事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT + +**系统能力:** SystemCapability.Communication.WiFi.AP.Core + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"hotspotStaLeave"字符串。 | + | callback | Callback<StationInf]> | 是 | 状态改变回调函数。 | + +## wifi.off('hotspotStaLeave')7+ + +off(type: "hotspotStaLeave", callback: Callback<StationInfo>): void + +取消注册wifi热点sta离开事件。 + +**需要权限:** ohos.permission.MANAGE_WIFI_HOTSPOT + +**系统能力:** SystemCapability.Communication.WiFi.AP.Core + +**参数:** + + | **参数名** | **类型** | **必填** | **说明** | + | -------- | -------- | -------- | -------- | + | type | string | 是 | 固定填"hotspotStaLeave"字符串。 | + | callback | Callback<StationInf]> | 是 | 状态改变回调函数。 | + + **示例:** +```js +import wifi from '@ohos.wifi'; + +var recvHotspotStaLeaveFunc = result => { + console.info("Receive hotspot sta leave event: " + result); +} + +// Register event +wifi.on("hotspotStaLeave", recvHotspotStaLeaveFunc); + +// Unregister event +wifi.off("hotspotStaLeave", recvHotspotStaLeaveFunc); + +``` ## wifi.on('p2pStateChange')8+