APP集成开发指南

1.1 概述

欧比特IOT是一款拥有完全自主知识产权的软硬件结合的门锁产品，通过手机 APP替代传统的钥匙实现开门。
针对合作伙伴系统定制的需求，欧比特提供了开放平台 Open API 和 APP SDK。合作伙 伴可方便地在自己的应用系统和 APP中集成欧比特IOT的各项功能。 
本文档对 APP的集成开发进行说明。

1.2 对接

对接如下图所示。

1.蓝牙对接  手机调用API通过蓝牙与锁通信，实现门锁的开锁；

2.卡功能对接  第三应用系统通过欧比特平台提供的 SDK实现发卡，通过卡片开锁。   

1.3 开发步骤

（1）注册开发者(管理中心--注册)，等待审核。
（2）创建应用与检验酒店SN。 
（3）酒店授权。 
（4）授权通过得到client_id、client_secret，获取访问令牌。
（5）携带访问令牌，就可以调用相关接口，具体的请参考后续应用流程。

1.3 应用流程

 a.蓝牙开锁\取电开关取电断电流程

   广播: OBT开头    服务: 'FFF0',    写特征值: 'FFF1',    通知特征值: 'FFF4'

   用户操作----权限检查----设备扫描（通过“获取房间列表或获取通道列表”得到mac、tid）---设备连接---服务发现（FFF0）--启用监听（FFF4）---请求开锁指令(可以提前通过“获取宾客蓝牙开门指令或获取员工蓝牙开门指令或获取取电开关控制指令“获取bin)--写入指令--监听响应(蓝牙开门数据包回调)--处理结果
   

 b.蓝牙乘梯流程

用户操作----权限检查---获取楼栋数据（通过”获取楼栋列表或获取宾客授权的电梯列表“获取楼栋ID，去哪个楼栋与楼层）---获取乘梯广播数据（通过”获取员工乘梯蓝牙广播数据或获取宾客乘梯蓝牙广播数据“）---启动BLE广播（获取的广播数据通过设备广播名称进行广播）---电梯接收广播数据----停止广播