SDK对接方式简单快捷,厂商服务器只需实现token鉴权接口,即可在APP上通过Sleepace SDK提供的接口实现单设备的所有功能。

整体框架

SDK对接 - 图2

  1. Sleepace 提供sdk
  2. 合作厂商将Sleepace sdk 集成到厂商APP中
  3. 合作厂商需要实现用户验证接口,以便sleepace服务校验用户的合法性,详细接口请参考SDK鉴权
  4. Sleepace 提供WIFI SDK说明文件与服务操作设备的接口文档

    交互流程

SDK对接 - 图3

  1. 厂商app启动时需要从厂商服务器中获取token(用于sleepace校验用户合法性)
  2. 初始化sleepace sdk时传入token
  3. Sleepace sdk 使用token登录到sleepace 服务器
  4. Sleepace 服务器调用厂商服务器接口校验token的合法性,厂商需要根据sleepace 提供的接口规范实现token检验接口,接口定义请参考SDK鉴权
  5. 厂商校验Token成功后返回返回用户的基本信息到sleepace服务器
  6. 如果用户第一次使用的话,sleepace会为用户生成一个虚拟账号
  7. Sleepace返回校验成功
  8. 第一次使用设备时需要使用sleepace 配网SDK为设备配置wifi与服务器地址,SDK下载地址:
  9. Android https://github.com/sleepacesource/Android_wifi_config
  10. IOS https://github.com/sleepacesource/iOS_BLE_Wifi_Config
  11. 第一次使用设备除了配网外用户还需要绑定设备
  12. 用户认证成功后,可以使用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配网

image.png

BLE配网

点击下方链接,下载并安装配网工具App :
https://apph5.sleepace.com/appDownload/index.html?id=ble_wifi
或 用手机扫一扫下方二维码
image.png
image.png

Step3

使用“设备SDK”对设备进行绑定,并开发业务。