飞尔智能AIoT方案接入指南 Powered by MM-Wiki

飞尔智能AIoT方案接入指南

创建于 2020/08/14 10:18:52

修改于 2020/08/14 10:19:45

### 功能概述
飞尔智家AIoT方案为开发者提供飞尔智家生态下AIoT设备的相关能力，从而实现对设备的远程控制。该方案通过集成SDK（目前仅支持安卓平台）的方式，开发者可以轻松接入飞尔智家的AIoT平台，获取绑定的设备列表，控制设备。
### 获取SDK及接入参数的方式
SDK接入参数用以安全校验和权限分配，主要包括appId、bizId及公钥等，请以邮件形式将应用名称、包名发送至kefu@feiersmart.com，我们会将相关信息及SDK通过邮件的方式提供。
### 方案描述
飞尔智家的AIoT平台SDK（以下简称飞尔SDK）提供了登录飞尔账号、获取设备列表、设备控制功能接口。App集成SDK后，调用SDK的登录接口登录飞尔账号获取Token，便可通过SDK获取设备列表，控制设备，场景编辑等操作。设备控制的状态由飞尔Cloud同步到App Cloud后，在经App Cloud通知App更新。具体过程，如下图所示：
![](/images/3/14/iot5.png)
### SDK接口描述
FRIotInstance用以描述上述功能，具体接口如下表：

| 接口  |  接口描述 | 备注  |
| ------------ | ------------ | ------------ |
| getIotList()  | 获取IoT设备列表  |   |
| sendIotCommand(IotControlParamsBean)  | 向指定Iot设备发送指令  | 传入语料文本  |

### 接口数据实体

+ **SourceDeviceInfo IoT设备列表返回结果**

|	参数名| 参数类型| 说明|
|----|----|----|
|source_type|String|来源类型|
|source_name|String|来源名称|
|device_infos|List(<a href="#iotdevice">IotDeviceInfo</a>)|设备列表数据|

+ <div id="iotdevice"/>**IotDeviceInfo 设备详细信息**

|	参数名| 参数类型| 说明|
|----|----|----|
|device_id|String|设备ID|
|device_name|String|设备名|
|connect_status|String|连接状态|
|category_id|String|分类类型|
|category_name|String|分类名称|
|category_img|String|分类图片地址|
|product_id|String|产品ID|
|product_name|String|产品名称|
|product_img|String|产品图片地址|
|location|String|位置，如卧室、厨房等|
|location_id|String|位置ID|
|family_id|String|家庭编号|
|family_name|String|家庭名称|
|brand|String|品牌|
|model|String|型号|

+ **IotControlParamsBean 控制接口参数**

|	参数名| 参数类型| 说明|
|----|----|----|
|content|String|控制话术|
|type|String|请求类型1、正常请求 2、测试话术是否支持|
|scene_data|<a href="#ctrlscene">IotControlScene</a>|操作命令|

+ <div id="ctrlscene"/>**IotControlScene**

|	参数名| 参数类型| 说明|
|----|----|----|
|scene_id|String|场景ID|
|scene_name|String|场景名称|
|scene_detail|<a href="#scenedetail">IotControlSceneDetail</a>|场景设备列表|

+ <div id="scenedetail"/>**IotControlSceneDetail**

|	参数名| 参数类型| 说明|
|----|----|----|
|device_id|String|设备ID|
|content|String|控制话术|

+ **IotControlResponse 控制接口返回结果**

|	参数名| 参数类型| 说明|
|----|----|----|
|reply_type|String|回复的类型，text、voice|
|reply_value|String|text-文本内容，voice-语音的地址|