SDK对接方式简单快捷,厂商服务器只需实现token鉴权接口,即可在APP上通过Sleepace SDK提供的接口实现单设备的所有功能。
整体框架
- Sleepace 提供sdk
- 合作厂商将Sleepace sdk 集成到厂商APP中
- 合作厂商需要实现用户验证接口,以便sleepace服务校验用户的合法性,详细接口请参考SDK鉴权
- Sleepace 提供WIFI SDK说明文件与服务操作设备的接口文档
交互流程
- 厂商app启动时需要从厂商服务器中获取token(用于sleepace校验用户合法性)
- 初始化sleepace sdk时传入token
- Sleepace sdk 使用token登录到sleepace 服务器
- Sleepace 服务器调用厂商服务器接口校验token的合法性,厂商需要根据sleepace 提供的接口规范实现token检验接口,接口定义请参考SDK鉴权
- 厂商校验Token成功后返回返回用户的基本信息到sleepace服务器
- 如果用户第一次使用的话,sleepace会为用户生成一个虚拟账号
- Sleepace返回校验成功
- 第一次使用设备时需要使用sleepace 配网SDK为设备配置wifi与服务器地址,SDK下载地址:
- Android https://github.com/sleepacesource/Android_wifi_config
- IOS https://github.com/sleepacesource/iOS_BLE_Wifi_Config
- 第一次使用设备除了配网外用户还需要绑定设备
- 用户认证成功后,可以使用sleepace sdk提供的接口操作.
开始接入
前期准备
| 资源 | 说明 | 获取方式 | | —- | —- | —- | | Sleepace服务器信息 | Sleepace分配给厂商测试账号信息 | 请联系Sleepace项目经理 | | 设备配网SDK | 用于给wifi设备配置服务地址与wiif账号 | 请联系Sleepace项目经理 | | 设备SDK与SDK文档 | 用于控制设备,实现业务 | 请联系Sleepace项目经理 |
Step 1
实现SDK鉴权接口,并将接口URL、appId和secureKey提供给Sleepace项目经理。
Step2
使用设备配网SDK为设备配置网络与服务地址(从“Sleepace服务器信息”获取)。
配网方式有两种:AP配网与BLE配网。
AP配网
BLE配网
点击下方链接,下载并安装配网工具App :
https://apph5.sleepace.com/appDownload/index.html?id=ble_wifi
或 用手机扫一扫下方二维码
Step3
使用“设备SDK”对设备进行绑定,并开发业务。