- 3.2.4（含）开始蓝牙广播包过滤增加了
['ABF8', 'ABF0', 'F0AB', 'F8AB']四个过滤字段，为了兼容部分低端手机不过滤，长时间挂机会假死的问题。 - 乐鑫_0ESP32C3_0403000G 和 博流_00BL602L_0403000B 之后的版本都支持这个特性。
- 如果您使用的是更早期的固件，请联系我们。
使用小程序 sdk 前，请在微信开发者后台-开发管理-开发设置-服务器域名添加以下请求地址。
- request 合法域名
https://api.gizwits.com
https://site.gizwits.com- socket 合法域名
wss://wxstage.gizwits.com
wss://wxm2m.gizwits.comnpm install mini_program_gizwits_sdk
// or
yarn add mini_program_gizwits_sdk采用小程序代码片段，安装新版小程序开发工具，点击链接即可打开
import GizwitsSdk from 'mini_program_gizwits_sdk';
import { Component } from 'react';
import { View } from '@tarojs/components';
export default class Index extends Component {
private gizSdk: GizwitsSdk;
componentDidMount() {
this.gizSdk = new GizwitsSdk({
appID: 'appID',
appSecret: 'appSecret',
productInfo: [
{
productKey: 'productKey',
productSecret: 'productSecret',
},
],
uid: 'giz_uid', // 必填
token: 'giz_token', // 必填
});
}
render() {
return <View>hello</View>;
}
}sdk.setLogLevel("debug")
小程序 BLE 相关 API。
初始化 sdk 蓝牙能力。使用其他BLE API前必须进行初始化。
搜索蓝牙设备。搜索到的蓝牙设备会被 onScanListChange 事件监听。
- delay: 超时时间。
- services: 过滤services的条件，不传默认 ['ABF8', 'ABF0', 'F0AB', 'F8AB']
间隔自动搜索蓝牙设备 onScanListChange 事件监听。
- services: 过滤services的条件，不传默认 ['ABF8', 'ABF0', 'F0AB', 'F8AB']
安全注册目标设备，否则无法发起设备绑定。返回值中可以拿到注册结果。
- Object object
| 属性 | 类型 | 描述 |
|---|---|---|
| mac | string | 待注册设备 mac |
| productKey | string | 待注册设备所属产品 |
绑定远程设备，否则无法发起设备订阅。返回值中可以拿到绑定结果。
- Object object
| 属性 | 类型 | 描述 |
|---|---|---|
| mac | string | 待绑定设备 mac |
| productKey | string | 待绑定设备所属产品 |
sdk.subscribe(device:IDevice )
订阅目标设备，订阅成功后可控制设备。返回值中可以拿到订阅结果。
sdk.write(device:IDevice,cmd:{[key]:value})
向目标设备发送指令。 其中key为数据点名称，value 为数据点的值。
sdk.unSubscribe(device:IDevice)
取消订阅目标设备。蓝牙设备会断开连接。返回值中可拿到取消订阅结果。
| 事件种类 type | 回调参数类型 | 回调参数描述 |
|---|---|---|
| onScanListChange | IDevice[] | 扫描设备列表变更通知 |
| GizDeviceAttrsNotifications | IDeviceAttrsNoti | 设备数据点变更通知 |
| onBleHandleError | IError | ble 错误通知 |
const initBle = () => {
this.gizSdk.initBle();
};
const scanBle = async () => {
const data = await this.gizSdk.scanBleDevice(60000);
console.log('scanBle', data);
};
this.gizSdk.addEventListener('onScanListChange', (deviceList: IDevice[]) => {
console.log('扫描列表发生变化', deviceList);
deviceListModal.updateScan(deviceList);
});
initBle();
scanBle();监听设备上报数据。
this.gizSdk.addEventListener(
'GizDeviceAttrsNotifications',
({ device, data }) => {
console.log("====设备状态发生变化====", device,data);
};
);interface IDevice {
mac: string; // 设备mac
productKey: string; // 机智云pk
did?: string; // 云平台did
name: string; // 设备名称
isBind: boolean; // 是否绑定
bleDeviceID?: string; // 本地蓝牙设备id
isOnline: boolean; // 代表大循环在线
isLanOnline: boolean; // 代表小循环在线
isBleOnline: boolean; // 代表蓝牙在线
}interface IDeviceAttrsNoti {
device: IDevice;
data: object; // 设备上报数据点
}interface IError {
errorCode: number;
errorMessage?: string; // 错误信息
}销毁事件监听。
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,
});
try {
const data = await sdk.setDeviceOnboardingDeploy({
ssid: SSID,
password: password,
mode: 3, // 蓝牙配网
// mode:0 // softAp
timeout: 60,
softAPSSIDPrefix: 'XPG-GAgent-',
});
} catch (error) {
console.log(error);
}其中data代表配网成功的设备。
如果失败的话会返回数据
{
success: false,
err: {
errorCode: 'code',
errorMessage: 'message',
}
}const errorCode: IErrorCode = {
GIZ_OPENAPI_DEVICE_NOT_BOUND: {
errorCode: 9017,
errorMessage: 'not bind',
},
GIZ_SDK_HTTP_REQUEST_FAILED: {
errorCode: 8099,
errorMessage: '网络请求失败',
},
GIZ_SDK_SDK_NOT_INITIALIZED: {
errorCode: 8300,
errorMessage: 'not init',
},
CONFIG_TIME_OUT: {
errorCode: 8023,
errorMessage: 'Config Timeout',
},
WECHAT_ERROR: {
errorCode: 10000,
errorMessage: 'wechat error',
},
GIZ_SDK_ONBOARDING_STOPPED: {
errorCode: 8318,
errorMessage: '配网中断',
},
GIZ_SDK_DEVICE_CONFIG_IS_RUNNING: {
errorCode: 8022,
errorMessage: '配置正在进行中',
},
GIZ_OPENAPI_TOKEN_INVALID: {
errorCode: 9004,
errorMessage: 'token 失效',
},
GIZ_SDK_BIND_DEVICE_FAILED: {
errorCode: 8039,
errorMessage: '设备绑定失败',
},
GIZ_SDK_BLE_BLUETOOTH_FUNCTION_NOT_TURNED_ON: {
errorCode: 8281,
errorMessage: '蓝牙未启用',
},
GIZ_SDK_OTHERWISE: {
errorCode: 8100,
errorMessage: '',
},
GIZ_SDK_DEVICE_NOT_SUBSCRIBED: {
errorCode: 8029,
errorMessage: '设备还未订阅',
},
GIZ_SDK_PRODUCTKEY_NOT_IN_SPECIFY: {
errorCode: 8250,
errorMessage: '产品类型不在指定范围内',
},
};