这套方案主要针对不需要实现Android和IOS客户端的厂商,Sleepace 设备产生的数据由Sleepace服务器直接推送厂商服务器。
服务架构
- sleepace 设备将监测数据上传到sleepace服务;
- Sleepace服务通过消息队列发布数据;
- 第三方服务向sleepace消息队列订阅感兴趣的数据主题,当消息队列收到sleepace服务发布该主题消息时,向第三方服务推送消息;
- 第三方可以通过sleepace 提供的http接口向sleepace服务发送设备控制指令。
交互流程
- 合作方服务连接到mqtt服务,并订阅数据
- 使用sleepace提供的设备配网SDK为设备配置wifi与服务器地址
- 为设备绑定用户
- 执行完以上操作后,我们就可以开始对设备进行操作了,操作开始前可以通过设备联网状态状态查询接口确实一下设备是否在线
- 如果你想查看设备的实时监测数据,可以通过“View realtim data”接口发送请求
- 设备接收到“View realtim data”后,会开始上报实时监测数据,并通过Mqtt service 转发给合作方
开始接入
前期准备
1、资源准备
资源 | 说明 | 获取方式 |
---|---|---|
Sleepace服务器信息 | Sleepace分配给厂商测试账号信息 | 请联系Sleepace项目经理 |
设备配网SDK | 用于给wifi设备配置服务地址与wiif账号 | 请联系Sleepace项目经理 |
需要接入的设备 |
2、确认需要推送的数据(将确认后的数据,提交Sleepace项目经理;后期厂商可以在Sleepace后台系统自行设置),默认推送所有数据:
dataKey | 说明 |
---|---|
connectionStatus | 设备上线、下线时间 |
realtime | 用户实时心率、呼吸率、翻身、温度和湿度,(数据开启方式有:1、调用viewRealtime接口,并可以通过stopRealtime接口实时数据(设备与服务器重连也会自动关闭),适用智能家居业务;2、由Sleepace进行配置后,设备会一直上报,适用于监护类业务 |
inBedStatus | 用户上床、离床事件 |
analysis | 报告睡眠报告生成事件 |
sleepStage | 用户睡眠状态(清醒、浅睡、中睡和深睡) |
sleepChange | 用于上报用户入睡点和唤醒点,该事件可用于用户入睡和清醒进行设备间互联操作,如:入睡点可以用关闭助眠设备的助眠模式;唤醒点可用于设备智能闹钟。 |
Step1
厂商服务器连接Sleepace消息队列订阅数据(目前使用的消息队列协议为mqtt,测试过程可以使用第三方客户端测试,如:mqtt.fx)
Step2
使用设备配网SDK为设备配置网络与服务地址(从“Sleepace服务器信息”获取)。设备配网成功并连接到Sleepace服务器后,Sleepace服务器会将设备上线事件推送给厂商,厂商也可以通过http接口自行查询设备在线状态
配网方式有两种:AP配网与BLE配网。
AP配网(步骤同BIE配网,将配置文档中的地址填写入SDK当中)
BLE配网
Step3
在操作设备前,需要将设备与用户进行绑定。
Step4
以上步骤完成后,就可以通过接口文档的接口对设备进行控制和查看数据了。