海极网

IoT SDK

1. 简述

IoT SDK即设备端SDK（SmartDevice SDK），是一款基于Android系统或Linux系统的应用开发套件，能够使用在有屏、无屏的Android系统或Linux系统的智能设备上，将设备接入到U+平台，并与U+设备交互。主要包括设备接入功能和设备控制功能。

设备接入功能，主要的业务功能包括上线宣告、接收控制指令、上报属性信息、上报报警信息、上报大数据信息、OTA升级包下载功能、P2P功能、http域名解析功能等。

设备控制功能，主要的业务包括设备入网功能、设备搜索功能、设备控制功能、接收状态变化上报功能、接收报警信息上报功能等。

SDK具备如下特点：

2. 设备端SDK能力介绍

2.1. 能力图集

2.2. 上线宣告能力

当设备端SDK成功启动并添加设备后，该接入设备会在当前WIFI网络中宣告上线信息，使自己能够被该网络中的APP（移动端SDK）发现，这种能力被称作上线宣告能力。

2.3. 接收控制指令能力

作为接入设备，能够接收手机APP、控制侧SDK或云服务下发的控制指令，更改设备状态的一种能力。

2.4. 上报能力

作为接入设备，SDK具有上报设备属性、报警和大数据的能力。当设备属性或报警状态发生变化时、或接受到设备控制命令后，需要及时上报设备的实际属性和报警状态，同时可以根据需求自定义大数据的上报，这种能力被成为上报能力。

2.5. 控制设备能力

作为控制设备，SDK具有控制同一账号体系下其他设备的能力。通过对SDK进行授权或者是设置token的方式赋予SDK控制设备的能力。

2.6. OTA升级包下载功能

作为接入设备，SDK能够提供OTA升级包的下载通道，开发者可以自定义OTA包的内容，可以为设备底板升级程序或者是IoT SDK升级程序，然后根据不同的内容选择进行不同的升级操作。

2.7. P2P功能

作为接入设备，SDK具有传输图片、音频*、视频*等资源的能力，通过特定的通道对相应的资源进行传输，为确保资源的安全性，此功能只支持在大循环进行传输。

注：带有“*”标记的能力为正在开发中的能力，暂时还未正式发布。

2.8. HTTP域名解析功能

作为接入设备，此功能可以有的效防止DNS被非法劫持，所导致的设备无法连接至U+云平台生产环境的情况发生。打开此功能后，设备只能够连接至U+的生产环境。

3. 应用场景

可以把设备端SDK理解为一套标准的中间连接件，能够完成控制命令的传输，设备报警、设备属性状态、大数据等数据收发。用于和设备底板、U+云、移动端SDK进行数据通信，完成大小循环的建立，功能与海尔uPlug模块功能基本相同，使用在有屏、无屏的Android系统或Linux系统的智能设备上。开发者只需要集中精力在底板和设备端SDK之间的数据转换上，就可以快速完成设备的接入。

4. 使用方式