氦氪云入门教程09-设备端用户端接入云端指南

lawrencedon

如果你不打算使用我们的设备端和APP端SDK开发你的产品的话，那可以自己按照我们的文档完成和云端的对接，本教程来梳理一下你需要用到哪些文档和接口。

先简单的来给设备端和用户端做个定义：
设备端：上报数据，接受用户端的控制。
用户端：查看设备上报的数据，控制设备。设备发送的数据，云端会转发给在线的用户端，用户端发送的数据，云端会转发给在线的设备端。

用户端接入云端的步骤如下：
1.调用接口3.5 使用账号登录获得用户token。
   有了用户token之后，你可以使用任何和用户相关的云端API。
2.调用接口4.1.2 列举设备列表获得本账号下的设备列表。
   获得设备列表之后，从列表中可以查看设备的详细信息，在做实时控制时，需要用到设备的devTid和ctrlKey。
3.如果想实时的控制设备和收到设备发送的数据，就需要和云端建立一个实时通信的通道。
   2.2 APP和云端建立通道    
    特别注意一点，在通道中，发送给云端的数据最后一定要加上\n，接收到的数据云端也在结尾放了\n。
    建立通道就是和云端建立TCP或者WebSocket连接，连接地址为2. 基础通信API 服务地址，建立连接之后就可以和云端实时收发数据，收发的数据需要符合以下规范：
    2.4 APP发送数据到设备 2.4.1 设备使用JSON主控协议时
    2.4 APP发送数据到设备 2.4.2 设备使用JSON透传协议时
    2.6 设备、APP发送心跳   
    设备云端通信协议

用户端接入云端实例：
氦氪云入门教程06-在PC端调试H5设备控制页面
使用nodejs作为用户端接入氦氪云平台

设备端接入云端的步骤如下：
如果想实时的接受用户端的控制和向用户端发送数据，设备端需要和云端建立一个实时通信的通道。
2.1 设备和云端建立通道

特别注意一点，在通道中，发送给云端的数据最后一定要加上\n，接收到的数据云端也在结尾放了\n。
建立通道就是和云端建立TCP或者WebSocket连接，连接地址为2. 基础通信API 服务地址，建立连接之后就可以和云端实时收发数据，收发的数据需要符合以下规范：
2.5 设备发送数据到APP 2.5.1 设备使用JSON主控协议时
2.5 设备发送数据到APP 2.5.2 设备使用JSON透传协议时
2.6 设备、APP发送心跳
设备云端通信协议

设备端接入云端实例：
运行Espruino固件的ESP8266模块接入氦氪云之SDK演示插座
使用nodejs作为设备端接入氦氪云平台之SDK演示插座

想了解终端接入云端更为详细的信息，请参看文档氦氪云联网功能组件。