mini_program_gizwits_sdk 3.7.0 → 3.7.1-beta.1

package/README.md

@@ -48,6 +48,33 @@ yarn add mini_program_gizwits_sdk
 
 [点击打开微信开发者工具](https://developers.weixin.qq.com/s/Wk0aZlmg7jOR)
 
+#### 配网过程回调（3.7.1-beta.1）
+
+`setDeviceOnboardingDeploy({ ..., eventCallBack })` 保留原有事件，并新增
+`GIZ_CONFIG_PROGRESS`。应用可收集事件，在配网结束时统一上报。
+
+```ts
+const processDetails: ConfigEventData[] = [];
+const result = await sdk.setDeviceOnboardingDeploy({
+  ssid, password, mode: 3, timeout: 60,
+  eventCallBack: event => processDetails.push(event),
+});
+// 应用侧结束事件：monitorTarget.sdkResult.msg = JSON.stringify({ processDetails })
+```
+
+过程事件包含 `stage`、`status`、毫秒时间戳 `timestamp` 和本次配网累计耗时
+`elapsedMs`。阶段包括 `discover`、`connect`、`services`、`characteristics`、
+`notify`、`protocol`、`write`、`ack`、`cloud_search`、`bind`、`complete`。
+状态包括 `start`、`success`、`failure`、`timeout`、`retry`、`ignored`、`cancelled`。
+按实际结果附带 `reason`、`errorCode`、`errno`、写入次数 `attempt` 和包头元数据，
+不附带密码、原始数据包或任意错误对象。`attempt: 0` 表示尚未写入。
+
+`GIZ_CONFIG_SEND_SUCCESS` 仅在蓝牙写入调用成功后触发；
+`GIZ_CONFIG_RECV_SUCCESS` 仅在同一设备的回复通过配网 ACK 校验后触发。
+ACK 不代表设备已经联网：云端发现设备由 `cloud_search/success` 和原有
+`GIZ_CONFIG_SUCCESS` 表示。无效或否定回复会产生 `ack/ignored` 并保留命令码、状态。
+阶段失败可能重试，最终结果仍以配网方法返回值为准。应用回调抛错不会中断配网。
+
 ### 设备控制
 
 [点击打开微信开发者工具](https://developers.weixin.qq.com/s/Kh0CMlmq77OA)