mini_program_gizwits_sdk 3.5.13-kuka → 3.6.0

package/README.md

@@ -3,13 +3,6 @@
 # 机智云小程序 SDK
 
 
-## 🔴 破坏性更新
-
-- 3.2.4（含）开始蓝牙广播包过滤增加了 `['ABF8', 'ABF0', 'F0AB', 'F8AB']` 四个过滤字段，为了兼容部分低端手机不过滤，长时间挂机会假死的问题。
-- 乐鑫_0ESP32C3_0403000G 和 博流_00BL602L_0403000B 之后的版本都支持这个特性。
-- 如果您使用的是更早期的固件，请联系我们。
-
-
 ## ⚠️ 重要
 
 使用小程序 sdk 前，请在微信开发者后台-开发管理-开发设置-服务器域名添加以下请求地址。
@@ -28,6 +21,17 @@ wss://wxstage.gizwits.com
 wss://wxm2m.gizwits.com
 ```
 
+- 关于services
+
+为了搜索效率，sdk会根据`services `过滤蓝牙设备。默认  ['ABF8', 'ABF0', 'F0AB', 'F8AB']。
+如果有特殊情况，不想用`services `过滤设备，可以
+
+```js
+sdk.scanBleDevice(3000, [])
+sdk.startAutoScan([])
+```
+
+
 ## 🔧 安装
 
 ```bash
@@ -40,13 +44,13 @@ yarn add mini_program_gizwits_sdk
 
 > 采用小程序代码片段，安装新版小程序开发工具，点击链接即可打开
 
-### 蓝牙和 softAp 配网
+### 蓝牙配网
 
-[点击打开微信开发者工具](https://developers.weixin.qq.com/s/UQI8fpm87jDI)
+[点击打开微信开发者工具](https://developers.weixin.qq.com/s/Wk0aZlmg7jOR)
 
 ### 设备控制
 
-[点击打开微信开发者工具](https://developers.weixin.qq.com/s/NZI5gpmX7qD1)
+[点击打开微信开发者工具](https://developers.weixin.qq.com/s/Kh0CMlmq77OA)
 
 ## 🏍 初始化 Sdk
 
@@ -82,9 +86,9 @@ export default class Index extends Component {
 ## 📋 日志
 sdk.setLogLevel("debug")
 
-## 📖 BLE API
+## 📖 API
 
-小程序 BLE 相关 API。
+小程序相关 API。
 
 ### sdk.initBle()
 
@@ -108,7 +112,7 @@ sdk.setLogLevel("debug")
 
 ### sdk.deviceSafetyRegister(Object object)
 
-安全注册目标设备，否则无法发起设备绑定。返回值中可以拿到注册结果。
+安全注册目标设备，蓝牙设备绑定前，需要调用这个接口，否则无法发起设备绑定。返回值中可以拿到注册结果。
 
 #### 参数
 
@@ -132,10 +136,14 @@ sdk.setLogLevel("debug")
 | mac        | string | 待绑定设备 mac     |
 | productKey | string | 待绑定设备所属产品 |
 
-### sdk.subscribe(device:[IDevice](#IDevice) )
+### sdk.subscribe(device:[IDevice](#IDevice),connectType:[TConnectType](#TConnectType))
 
 订阅目标设备，订阅成功后可控制设备。返回值中可以拿到订阅结果。
 
+### sdk.getDeviceStatus(device:[IDevice](#IDevice), attrNames?: string[])
+
+查询目标设备当前状态，attrNames 不传则查询所有数据
+
 ### sdk.write(device:[IDevice](#IDevice),cmd:{[key]:value})
 
 向目标设备发送指令。 其中`key`为数据点名称，value 为数据点的值。
@@ -194,15 +202,30 @@ this.gizSdk.addEventListener(
 
 ```ts
 interface IDevice {
-  mac: string; // 设备mac
-  productKey: string; // 机智云pk
-  did?: string; // 云平台did
-  name: string; // 设备名称
-  isBind: boolean; // 是否绑定
-  bleDeviceID?: string; // 本地蓝牙设备id
+  mac: string;
+  productKey: string;
+  did: string;
+  bleWorkStatus?: number; // 0 默认状态 1 配网状态
+  name: string;
+  isBind: boolean;
+  rootDeviceId?: string;
+  bleDeviceID?: string;
+  remark?: string;
+  passcode?: string;
+  connectType: TConnectType;
   isOnline: boolean; // 代表大循环在线
   isLanOnline: boolean; // 代表小循环在线
   isBleOnline: boolean; // 代表蓝牙在线
+  host?: string;
+  wss_port?: number;
+  ctime?: number;
+}
+```
+
+- <a id="TConnectType">TConnectType</a>
+
+```ts
+type TConnectType = 'BLE' | 'BLE_BROADCAST' | 'LAN' | 'WAN' | 'NONE';
 }
 ```
 
@@ -228,22 +251,24 @@ interface IError {
 
 销毁事件监听。
 
-# 机智云小程序 wifi SDK
+# 配网相关
 
 ## 使用方法
 
 ```javascript
 import GizwitsSdk, { errorCode } from 'mini_program_gizwits_sdk';
 
-const sdk = new GizwitsSdk({
-  appID: '8f187b1deb9e44b6aa1374b8f13bccb1',
-  appSecret: 'd73fa6d6d7c04d37b6b2cc13a18a9f37',
-  specialProductKeys: ['00e7e327afa74a3d8ff1cc190bad78c0'],
-  specialProductKeySecrets: ['aa3d301fa291466fbed20e4204609abc'],
-  token: token,
-  uid: uid,
-  cloudServiceInfo: null,
-});
+const configData = {
+  appID: "xxx",
+  appSecret: "xxx",
+  productInfo: [
+    {
+      productKey: "xxx",
+      productSecret: "xxx",
+    },
+  ],
+};
+const sdk = new GizwitsSdk(configData);
 
 try {
   const data = await sdk.setDeviceOnboardingDeploy({