客户无账号系统对接方案
概述
本方案适用于客户无需对接 BroadLink
账号系统,客户APP集成配网SDK,自己对设备进行配网,发现,配对,然后将配对之后信息保存到自身云端。
设备控制的时候,通过云云对接接口,携带之前保存的设备配对信息,进行控制。
主要功能:
1. 客户 APP 集成 配网SDK
2. 客户 APP 通过 配网SDK 相关接口,对设备进行 配网、局域网发现、设备配对等操作
3. 客户 APP 通过上一步操作,获取设备配对信息之后,将该信息保存到自身云端
4. 客户 APP 通过云云对接接口进行设备控制
License 申请
为了设备的安全,所有使用SDK的用户必须向 BroadLink DNAKit 开发者平台 申请 License。
注意:License 必须与应用的包名(PackageName)相关联,不同的应用包名需要申请不同的 License。
申请流程(图文):
- 进入 BroadLink DNAKit 开发者平台
- 登录账号,没有账号的请先注册,并申请为开发者
- 等待审核通过
- 审核通过后,进入主页,选择 平台接入 -> SDK接入
- 选择 License申请 -> 新建License申请,按要求填写信息,若要控制第三方厂家的设备,请在备注中说明厂家的名称以及具体的产品型号,提交审核
审核通过之后,可以在申请页面看见 License
注意:本方案中基本信息里面 用户账号类型 需要选择为 BroadLink账号系统
以上工作需要由技术对接人员指导客户完成申请。
SDK 集成
调用流程:
- SDK初始化: sdkInit
- 设备配网:deviceEasyConfig
- 设备发现:deviceProbe
- 设备配对: devicePair
配对完成之后信息:
{
"status":0,
"msg": "success",
"devicePairedInfo": devicePairedInfo //配置成功上的设备信息
}
请将上面 devicePairedInfo
信息保存
云云对接
针对云云对接中的数据和响应详细说明:
- 云云对接中的控制数据包含几个部分:
设备的唯一标识:
"endpointId": "Some-Device-ID",//注册返回。对于没有注册流程的第三方,也可直接使用sdk返回的devicePairedInfo中的did。
设备的属性:
"devicePairedInfo":{},//注册时返回。对于没有注册流程的第三方,也可由sdk返回中得到。
控制字段:
由namespace,name和payload确定,
消息唯一标识:
messageId。
- 云云对接中,正确响应中event.name=“Response”,错误响应中event.name=“ErrorResponse”,payload中是具体错误类型和原因。
比较常见的错误类型是:ENDPOINT_UNREACHABLE(设备离线)和DEVICE_RESET(设备已经复位)