客户无账号系统对接方案

概述

本方案适用于客户无需对接 BroadLink 账号系统,客户APP集成配网SDK,自己对设备进行配网,发现,配对,然后将配对之后信息保存到自身云端。 设备控制的时候,通过云云对接接口,携带之前保存的设备配对信息,进行控制。

主要功能:

1. 客户 APP 集成 配网SDK
2. 客户 APP 通过 配网SDK 相关接口,对设备进行 配网、局域网发现、设备配对等操作
3. 客户 APP 通过上一步操作,获取设备配对信息之后,将该信息保存到自身云端
4. 客户 APP 通过云云对接接口进行设备控制


License 申请

为了设备的安全,所有使用SDK的用户必须向 BroadLink DNAKit 开发者平台 申请 License

注意:License 必须与应用的包名(PackageName)相关联,不同的应用包名需要申请不同的 License。

申请流程(图文):

  1. 进入 BroadLink DNAKit 开发者平台
  2. 登录账号,没有账号的请先注册,并申请为开发者
  3. 等待审核通过
  4. 审核通过后,进入主页,选择 平台接入 -> SDK接入
  5. 选择 License申请 -> 新建License申请,按要求填写信息,若要控制第三方厂家的设备,请在备注中说明厂家的名称以及具体的产品型号,提交审核
  6. 审核通过之后,可以在申请页面看见 License

    注意:本方案中基本信息里面 用户账号类型 需要选择为 BroadLink账号系统

以上工作需要由技术对接人员指导客户完成申请。


SDK 集成

SDK 接口文档

调用流程:

  1. SDK初始化: sdkInit
  2. 设备配网:deviceEasyConfig
  3. 设备发现:deviceProbe
  4. 设备配对: devicePair

配对完成之后信息:

{
    "status":0,
    "msg": "success", 
    "devicePairedInfo": devicePairedInfo //配置成功上的设备信息
}

请将上面 devicePairedInfo 信息保存


云云对接

OPENPROXY云端接口参考

针对云云对接中的数据和响应详细说明:

  1. 云云对接中的控制数据包含几个部分:

设备的唯一标识:

"endpointId": "Some-Device-ID",//注册返回。对于没有注册流程的第三方,也可直接使用sdk返回的devicePairedInfo中的did。

设备的属性:

"devicePairedInfo":{},//注册时返回。对于没有注册流程的第三方,也可由sdk返回中得到。

控制字段:

由namespace,name和payload确定,

消息唯一标识:

messageId。
  1. 云云对接中,正确响应中event.name=“Response”,错误响应中event.name=“ErrorResponse”,payload中是具体错误类型和原因。

比较常见的错误类型是:ENDPOINT_UNREACHABLE(设备离线)和DEVICE_RESET(设备已经复位)