3.4 IoT对象

# 3.4 IoT对象 </br> ## 数据结构说明 | 字段 | 数据类型 | 释义 | 取值 | 取值释义 | |-----------------|----------|--------------|-------------------|--------------------| | id | int | 目标对象ID | 301 | | | equip_type | int | 设备类别 | 1000 | 灯 | | | | | 1001 | 空调 | | | | | 1002 | 风扇 | | | | | 1003 | 电热器/电暖器 | | | | | 1004 | 洗衣机 | | | | | 1005 | 浴霸/风暖 | | | | | 1006 | 热水器 | | | | | 1007 | 排风扇 | | | | | 1008 | 电吹风 | | | | | 1009 | 冰箱 | | | | | 1010 | 电压力锅/电饭煲 | | | | | 1011 | 微波炉 | | | | | 1012 | 咖啡机 | | | | | 1013 | 油烟机 | | | | | 1014 | 净水器 | | | | | 1015 | 面包机 | | | | | 1016 | 消毒柜 | | | | | 1017 | 榨汁机/料理机 | | | | | 1018 | 电磁炉 | | | | | 1019 | 烤箱/电烤箱 | | | | | 1020 | 电饼铛 | | | | | 1021 | 豆浆机 | | | | | 1022 | 酸奶机 | | | | | 1023 | 电水壶 | | | | | 1024 | 电视机 | | | | | 1025 | 按摩器 | | | | | 1026 | 音箱/音响 | | | | | 1027 | 按摩椅 | | | | | 1028 | 收音机 | | | | | 1029 | 录音机 | | | | | 1030 | 影碟机 | | | | | 1031 | 录像机 | | | | | 1032 | 投影机 | | | | | 1033 | 净化器 | | | | | 1034 | 吸尘器 | | | | | 1035 | 加湿器 | | | | | 1036 | 扫地机器人 | | | | | 1037 | 熨斗 | | | | | 1038 | 除湿机/抽湿机 | | | | | 1039 | 计算机/电脑/笔记本 | | | | | 1040 | 平板 | | | | | 1041 | 手机 | | | | | 1042 | 身高仪 | | | | | 1043 | 体重秤 | | | | | 1044 | 温度计 | | | | | 1045 | 湿度计 | | | | | 1046 | 空气质量仪 | | | | | 1047 | 门 | | | | | 1048 | 窗 | | | | | 1049 | 窗帘 | | | | | 1050 | 新风系统 | | | | | 1051 | 饮水机 | | | | | 1052 | 电话机 | | | | | 1053 | 机顶盒 | | | | | 1054 | 打印机 | | | | | 1055 | 插座 | | | | | 1056 | 电动锁 | | | | | 1057 | 煤气罐 | | | | | 1058 | 门磁开关 | | | | | 1059 | 幕帘 | | | | | 1060 | 门铃 | | | | | 1061 | 水表 | | | | | 1062 | 智能终端 | | | | | 1063 | 开关 | | | | | 1064 | 电表 | | | | | 1065 | 面板 | | | | | 1066 | 探测器 | | | | | 1067 | 门磁传感器 | | | | | 1068 | 排烟罩 | | | | | 1069 | 燃气灶 | | | | | 1070 | 门锁 | | | | | 1071 | 摄像头 | | | | | 1072 | 破壁机 | | | | | 1073 | 网关 | | | | | 1074 | 断路器 | | | | | 1075 | 制冰机 | | | | | 1076 | 报警器 | | | | | 1077 | 电热毯 | | | | | 1078 | 液位传感器 | | | | | 1079 | 温湿度采集单元 | | | | | 1080 | 跑步机 | | | | | 1081 | 浴缸 | | | | | 1082 | 按钮 | | | | | 1083 | 空气盒子 | | | | | 1084 | 地暖器 | | | | | 1085 | 机器人 | | | | | 1086 | 推窗器 | | | | | 1087 | 马桶 | | | | | 1088 | 中控屏 | | | | | 1089 | 遥控器 | | | | | 1090 | 鱼缸 | | | | | 1091 | 控制器 | | | | | 1092 | 网络存储 | | equip_id | String | 设备id | | | | name | String | 设备名称 | | | | alias | String | 设备别名 | | | | equip_location | String | 设备所属地点 | 客厅 | 客厅 | | | | | 卧室 | 卧室(主卧) | | | | | 次卧 | 次卧 | | | | | 客房 | 客房 | | | | | 书房 | 书房 | | | | | 儿童房 | 儿童房 | | | | | 餐厅 | 餐厅 | | | | | 阳台 | 阳台/客厅阳台 | | | | | 生活阳台 | 生活阳台 | | | | | 门厅 | 门厅(厅) | | | | | 厨房 | 厨房 | | | | | 卫生间 | 公共卫生间 | | | | | 主卧卫生间 | 主卧卫生间 | | | | | 储藏室 | 储藏室(储藏间) | | | | | 仓库 | 仓库 | | | | | 走廊 | 走廊 (过道) | | | | | 保姆房 | 保姆房 | | | | | 玄关 | 玄关 | | | | | 门口 | 门口 | | brightness | Object | 亮度 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | volume | Object | 音量 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | electricity | Object | 电量 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | range | Object | 打开幅度 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | wakeup | String | 唤醒 | ON | 开启唤醒 | | | | | OFF | 关闭唤醒 | | facerecognition | String | 人脸识别 | ON | 开启人脸识别 | | | | | OFF | 关闭人脸识别 | | temperature | Object | 温度 | | <a href="https:/api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | humidity | Object | 湿度 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | weight | double | 重量 | | | | height | double | 高度 | | | | level | Object | 档位 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | winddirection | String | 风向 | LEFTRIGHT | 左右风向 | | | | | UPDOWN | 上下风向 | | | | | UP | 向上 | | | | | DOWN | 向下 | | | | | LEFT | 向左 | | | | | RIGHT | 向右 | | | | | ALL | 左右风向+上下风向 | | windtype | String | 风种 | CONCENTRATE | 集中 | | | | | SPREAD | 扩散 | | windswept | String | 扫风 | ON | 开启扫风 | | | | | OFF | 关闭扫风 | | lighting | String | 照明 | ON | 开启照明 | | | | | OFF | 关闭照明 | | shuxian | String | 数显 | ON | 开启数显 | | | | | OFF | 关闭数显 | | childlock | String | 童锁 | ON | 开启童锁 | | | | | OFF | 关闭童锁 | | water | Object | 水量 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | quality | String | 质量 | | | | kougan | String | 口感 | QINGXIANG | 清香 | | | | | BIAOZHUN | 标准 | | | | | NONGYU | 浓郁 | | rotatecycle | int | 旋转周期 | | | | baoya | String | 保压 | ON | 开启保压 | | | | | OFF | 关闭保压 | | rotate | String | 旋转 | ON | 开启旋转 | | | | | OFF | 关闭旋转 | | shangxiapan | String | 上下盘 | UP | 上盘 | | | | | DOWN | 下盘 | | view3d_2d | String | 3D/2D | | | | power | String | 功率 | | | | turnover | String | 翻面 | ON | 开启翻面 | | | | | OFF | 关闭翻面 | | grainsize | String | 颗粒大小 | SMALL | 小 | | | | | MEDIUM | 中等 | | | | | BIG | 大 | | concentration | Object | 浓度 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | quantity | double | 份量 | | | | cups | double | 杯数 | | | | storages | String | 存储内容 | AUDIO | 音频 | | | | | VIDEO | 视频 | | | | | IMAGE | 图片 | | autofeeding | String | 自动投料 | ON | 开启自动投料 | | | | | OFF | 关闭自动投料 | | inputtext | String | 文字输入 | ON | 开启文字输入 | | | | | OFF | 关闭文字输入 | | photograph | String | 拍照 | ON | 开启拍照 | | | | | OFF | 关闭拍照 | | videotape | String | 录像 | ON | 开启录像 | | | | | OFF | 关闭录像 | | bluetooth | String | 蓝牙 | ON | 开启蓝牙 | | | | | OFF | 关闭蓝牙 | | wifi | String | Wifi | ON | 开启Wifi | | | | | OFF | 关闭WiFi | | location | String | 定位 | ON | 开启定位 | | | | | OFF | 关闭定位 | | status | String | 状态 | OPEN | 打开状态 | | | | | CLOSE | 关闭状态 | | | | | BEGIN | 开始状态 | | | | | FINISH | 结束状态 | | | | | PAUSE | 暂停状态 | | | | | CONTINUE | 继续状态 | | channel | int | 频道 | | | | menu | String | 菜单 | ON | 开启菜单 | | | | | OFF | 关闭菜单 | | grade | int | 等级/强度 | | | | screen | String | 屏幕 | ON | 开启屏幕 | | | | | OFF | 关闭屏幕 | | timing | String | 定时 | ON | 开启定时 | | | | | OFF | 关闭定时 | | heat | String | 电辅热 | ON | 开启电辅热 | | | | | OFF | 关闭电辅热 | | color | String | 颜色 | | | | colortemp | Object | 色温 | | <a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/g4m5eYsk">progress对象</a> | | repeat | int | 重复次数 | | | | soundtrack | String | 声道 | | | | model_name| String | 当前模式名称 | | | | model_id| String | 当前模式 ID | | | | contextual_model| List| 情景模式 | | | | mode | String | 设备运行模式 | DEFAULT | 常规模式 | | | | | MUTE | 静音模式 | | | | | VIBRATOR | 震动模式 | | | | | FLIGHT | 飞行模式 | | | | | INLAY | 内置模式 | | | | | OUTLAY | 外置模式 | | | | | ZHILENG | 制冷模式 | | | | | ZHIRE | 制热模式 | | | | | CHOUSHI | 抽湿模式 | | | | | LENGDONG | 冷冻模式 | | | | | RUANLENGDONG | 软冷冻模式 | | | | | PIAOXI | 漂洗模式 | | | | | TUOSHUI | 脱水模式 | | | | | CHUJUN | 除菌模式 | | | | | HUANQI | 换气模式 | | | | | GANZAO | 干燥模式 | | | | | BAOWEN | 保温模式 | | | | | LENGCANG | 冷藏模式 | | | | | SONGFENG | 送风模式 | | | | | JIASHI | 加湿模式 | | | | | SHUIMIAN | 睡眠模式 | | | | | JIENENG | 节能模式 | | | | | QINGJIE | 清洁模式 | | | | | ZUIKUAI | 最快模式 | | | | | ZUIJING | 最净模式 | | | | | XICUNSHAN | 洗寸衫模式 | | | | | XIYANGMAO | 洗羊毛模式 | | | | | XICHUANGDAN | 洗床单模式 | | | | | XINIUZAI | 洗牛仔模式 | | | | | XIMIANMA | 洗棉麻模式 | | | | | XIYURONG | 洗羽绒模式 | | | | | XISICHOU | 洗丝绸模式 | | | | | HUNHE | 混合模式 | | | | | YEJIANXI | 夜间洗模式 | | | | | YEWAN | 夜晚模式 | | | | | ZHAOMING | 照明模式 | | | | | CHUIFENG | 吹风模式 | | | | | KUAISUFENGGAN | 快速风干模式 | | | | | QUJINGDIAN | 去静电模式 | | | | | BAOSHI | 保湿模式 | | | | | CHUILIAN | 吹脸模式 | | | | | PENGSONG | 蓬松模式 | | | | | HENGWEN | 恒温模式 | | | | | KUAISUZHU | 快速煮模式 | | | | | ZHUZHOU | 煮粥模式 | | | | | ZHENGCAI | 蒸菜模式 | | | | | ZHUFAN | 煮饭模式 | | | | | BAOTANG | 煲汤模式 | | | | | DOULEITIJIN | 豆类蹄筋 | | | | | ROULEI | 肉类模式 | | | | | DANGAO | 蛋糕模式 | | | | | YULEI | 鱼类模式 | | | | | ZAIJIARE | 再加热模式 | | | | | ZALIANGZHOU | 杂粮粥模式 | | | | | RECAI | 热菜模式 | | | | | SHAOKAO | 烧烤模式 | | | | | YETI | 液体模式 | | | | | JIEDONG | 解冻模式 | | | | | MIFAN | 米饭模式 | | | | | APP | 手机APP模式 | | | | | SHENGKONG | 声控模式 | | | | | ROUSONG | 翻炒干货模式 | | | | | MIANBAO | 面包模式 | | | | | SHENGDIAN | 省电模式 | | | | | NAIPAO | 奶泡制作模式 | | | | | YISHIKAFEI | 意式咖啡模式 | | | | | CHA | 茶模式 | | | | | NATIE | 拿铁模式 | | | | | MAQIDUO | 玛奇朵模式 | | | | | KABUQINUO | 卡布奇诺模式 | | | | | SUANXING | 酸性模式 | | | | | RUOSUANXING | 弱酸性模式 | | | | | JIANXING | 碱性模式 | | | | | RUOJIANXING | 弱碱性模式 | | | | | KUAISU | 快速模式 | | | | | TUSI | 土司模式 | | | | | FASHIMIANBAO | 法式面包模式 | | | | | QUANMAIMIANBAO | 全麦面包模式 | | | | | HEIMAIMIANBAO | 黑麦面包模式 | | | | | DANMAIMIANBAO | 丹麦面包模式 | | | | | HUASHIMIANBAO | 花式面包模式 | | | | | SHUANGFENGMIANBAO | 双峰面包模式 | | | | | OUSHIMIANBAO | 欧式面包模式 | | | | | HEFENGMIANBAO | 和风面包模式 | | | | | WUJINMIANBAO | 无筋面包模式 | | | | | WUTANGMIANBAO | 无糖面包模式 | | | | | PISAMIANTUAN | 披萨面团模式 | | | | | JIAOMUMIANBAO | 酵母面包模式 | | | | | YINGSHISIKANG | 英式茶饼思康饼模式 | | | | | SHUSHIDANGAO | 蔬食蛋糕模式 | | | | | GUOJIANG | 果酱模式 | | | | | DOUSHAXIAN | 豆沙馅模式 | | | | | MASHU | 麻薯模式 | | | | | WUDONGMIAN | 乌冬面模式 | | | | | YIDALIMIAN | 意大利面模式 | | | | | NIANGAO | 年糕模式 | | | | | XIAODU | 消毒模式 | | | | | HONGGAN | 烘干模式 | | | | | DOUJIANG | 豆浆模式 | | | | | GUOSHU | 果蔬模式 | | | | | NONGTANG | 浓汤模式 | | | | | MIHU | 米糊模式 | | | | | YUMIZHI | 玉米汁模式 | | | | | AOZHOU | 熬粥模式 | | | | | SHOUDONG | 手动模式 | | | | | YAOKONG | 遥控模式 | | | | | BINGSHA | 冰沙模式 | | | | | NAIXI | 奶昔模式 | | | | | WUGU | 五谷模式 | | | | | HUOGUO | 火锅模式 | | | | | CHAOCAI | 炒菜模式 | | | | | SHAOSHUI | 烧水模式 | | | | | TIEBANSHAO | 铁板烧模式 | | | | | FAJIAO | 发酵模式 | | | | | XUANZHUAN | 旋转模式 | | | | | CUIPIHONGBEI | 脆皮烘焙模式 | | | | | CHUANTONGHONGBEI | 传统烘焙模式 | | | | | ZHENGQIXIAODU | 蒸汽消毒模式 | | | | | KAOYU | 烤鱼模式 | | | | | GUOTIE | 锅贴模式 | | | | | JIANDAN | 煎蛋模式 | | | | | ROUBING | 肉饼模式 | | | | | PISA | 披萨模式 | | | | | BINGGAN | 饼干模式 | | | | | CONGHUABING | 葱花饼模式 | | | | | XIANBING | 馅饼模式 | | | | | GANDOUDOUJIANG | 干豆豆浆模式 | | | | | SHIDOUDOUJIANG | 湿豆豆浆模式 | | | | | WUGUDOUJIANG | 五谷豆浆模式 | | | | | LVDOUDOUJIANG | 绿豆豆浆模式 | | | | | GUOCU | 果醋模式 | | | | | MIJIU | 米酒模式 | | | | | NADOU | 纳豆模式 | | | | | ROUNIE | 揉捏模式 | | | | | JIARE | 加热模式 | | | | | ZHENYA | 针压模式 | | | | | JINGJI | 经济模式 | | | | | SUANNAI | 酸奶模式 | | | | | PAOCAI | 泡菜模式 | | | | | FANCHAO | 翻炒干货模式 | | | | | ROUSONG | 肉松模式 | | | | | APP | 手机APP模式 | | | | | SHENGKONG | 声控模式 | | | | | SHOUDONG | 手动模式 | | | | | YAOKONG | 遥控模式 | | | | | RIGUANG | 日光模式 | | | | | QIANGJING | 强劲模式 | | | | | LAOREN | 老年人模式 | | | | | ERTONG | 老年人模式 | PS:以上为所有设备的字段属性说明,单个设备的字段说明参考附录中的<a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/MNC9az8d">设备属性说明(一)</a>和<a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/CeCDt5i6">设备属性说明(二)</a> </br> ## 接入方式说明 * 方式一: 需要通过接口上传设备信息到灵聚服务器。上传设备时,需保证equip_id和name的唯一性,没有上传的设备将会报设备找不到。(上传接口详见:HTTP API接口文档中的<a href="https://api.docs.lingju.ai/doc/43609919/wMpYycjg/akac63s6">设备信息同步接口</a>) 设备对象须先上传设备信息,上传设备要求一次将所有需要控制的设备上传。 当设备的属性或状态改变时,需要重新上传更新设备的状态和属性。更新上传时,须一次更新上传所有设备的状态和属性。 * 方式二: 无需上传设备,目前支持大部分常用设备(详见上表中的设备类别)。 该方式只能控制某一类设备,例如,打开灯,只会返回一个打开灯的指令,需要客户端自行判断打开哪个灯。 </br> ## 返回结果json示例 ~~~ 输入:帮我打开卧室的灯 输出: { "rtext":"已经发出打开灯指令", "outc":0, "actions":[ { "action":"OPEN", "target":{ "id":301, "equip_type":1000, "equip_id":"d1", "name":"灯", "alias":"电灯", "equip_location":"卧室" } } ], "intention":"SMART_HOME" } 语义解释:立即执行(OPEN)打开动作,回复朗读(outc=0)。此场景为将卧室的灯打开。方式一会先判断设备是否存在,并且未打开才会发送开启指令;方式二则直接返回该指令由客户端自行判断。 ~~~ ~~~ 输入:帮我把空调温度设置为20度 输出: { "rtext":"好的,已发出指令", "outc":0, "actions":[ { "action":"SET", "target":{ "id":301, "equip_type":1001, "equip_id":"kt1", "name":"空调", "alias":"空调机", "temperature":{ "type":5, "progress":"20" } } ], "intention":"SMART_HOME" } 语义解释:立即执行(SET)设置动作,回复朗读(outc=0)。此场景为将空调的温度设置为20摄氏度。方式一会先判断设备是否存在,设置的值是否符合规范;方式二则直接返回该指令由客户端自行判断。 ~~~ ~~~ 输入:帮我查询热水器现在的水温是多少 输出: { "rtext":"已发出查询指令", "outc":0, "actions":[ { "action":"QUERY", "target":{ "id":301, "equip_type":1006, "equip_id":"rsq1", "name":"热水器" }, "get":{ "property":"temperature", "type":"VALUE" } } ], "intention":"SMART_HOME" } 语义解释:立即执行(QUERY)查询动作,回复朗读(outc=0)。此场景为查询热水器的温度。方式一会自行查询设备属性后播报给用户,无该指令;方式二则返回查询指令,需客户端自行查询后播报给用户; ~~~ ~~~ 输入:每天8点打开热水器 输出: { "rtext":"已经发出打开热水器指令", "outc":0, "actions":[ { "action":"OPEN", "etime":{ "when":1610150400000, "interval":1, "unit":"D" }, "target":{ "id":301, "equip_type":1006, "equip_id":"rsq1", "name":"热水器" } } ], "intention":"SMART_HOME" } 语义解释:每天8点执行(OPEN)动作,回复朗读(outc=0)。此场景为每天八点打开热水器设备。方式一会先判断设备是否存在,并且未打开才会发送开启指令;方式二则直接返回该指令由客户端自行判断。 ~~~