From e8dbf4b9a4cca292f161981432190672d4460f7b Mon Sep 17 00:00:00 2001 From: liujiaojiao Date: Thu, 27 Jul 2023 17:09:28 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E7=BC=BA=E5=A4=B1=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liujiaojiao --- .../reference/apis/js-apis-wifi.md | 148 ++++++++++++++++++ 1 file changed, 148 insertions(+) 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 7ccc783711..07614ac052 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+ -- GitLab