I-使用流程简介

一般情况下,物联云平台SDK(以下简称SDK)的使用过程大致如下图所示:


                       1.配置/初始化/启动SDK
                               +
                               |
                               v
                           2.用户授权
                               +
                               |
                     +---------+---------+
                     |                   |
                     v                   v
                5.同步设备列表         3.扫描设备
                     +                   +
                     |                   |
                     |                   v
                     +-------------+4.绑定并订阅设备
                     |
        +------------v---------+---------------------+
        |                      |                     | 
        v                      v                     v
6.设置/查询物模型属性     7.接收设备状态回调       8.接收云端推送
  接收设备物模型属性上报

1.配置/初始化/启动SDK

在使用SDK之前,必须先配置/初始化SDK,因为SDK的正常运行依赖于这些配置,因此务必设置正确,正常情况下使用默认配置就可以。

另外在调用SDK的其他方法,或者要接收SDK的回调是,必须先启动SDK,即调用**[[XLinkSDK share] start]或者[[XLinkSDK share] startWithConfig:config]**。

2.用户授权

用户授权即常见的用户登录,如果需要使用SDK的云端功能,例如需要通过云端控制设备,或者订阅设备,必须保证用户授权成功。

3.扫描设备

这个指的是APP在局域网中发现设备。成功扫描到设备的必要前提是APP和设备连接同一个局域网,并且在同一网段,简单理解就是连接着同一个路由器。同时需要保证扫描设备的时候传入的产品ID和设备的产品ID一致。

4.绑定并订阅设备

绑定设备是指APP和设备在局域网中通过相关的协议获取到局域网的配对信息,之后APP和设备的局域网连接的凭证就是这个配对信息。

订阅设备指的是在云端建立用户和设备的绑定关系。用户在订阅设备之后,才可以通过云端连接设备、控制设备以及监听设备的上报数据,另外可以通过获取设备列表的接口获取到用户已订阅的设备。

绑定并订阅设备成功之后,SDK内部会维护APP和设备之间的连接。

5.同步设备列表

同步设备列表会获取用户已经订阅的设备列表并且返回,另外同步设备列表之后,SDK内部会维护APP和设备之间的连接。

6.设置/查询数据端点、接收设备数据端点上报

在APP和设备建立连接之后,APP可以对设备进行设置或者查询数据端点。一般来说,设置数据端点就是APP对设备进行控制的指令操作。查询数据端点就是获取设备上的最新的状态。

另外当设备的数据发生变化时,会向APP和云端发送数据端点列表,这个会通过设备数据端点上报的回调。

7.接收设备状态回调

APP调用了同步设备列表、连接设备或者绑定订阅设备操作后,SDK都会维护和设备之间的连接,并且通过设备状态的回调方法给到APP。APP可以根据最新回调的设备连接状态进行界面的更新。

8.接收云端推送

云端推送可以理解为应用内推送,在APP和云端连接之后,可以接收到云端发送过来的实时消息,包括有设备的告警消息、分享消息等。可以根据具体业务的情况处理对应的云端推送。

没找到需要的文档?
你可以提交工单反馈 或 阅读常见问题