一、概述

智能家居协议是智能家居技能与DUI SERVER之间的通讯协议。基于这些协议可以轻松的通过语音控制家里的智能设备，与设备进行交互。

思必驰智能家居服务会以协议中规定的请求格式，向厂商的服务发送控制请求，厂商服务需要根据协议中规定的响应格式来返回请求结果。

智能家居协议使用HTTPS传输，协议采用JSON消息格式。

推荐厂商将无法处理或有问题的请求均按照协议中设计的错误响应的格式来返回，思必驰服务会根据错误响应做对应的处理和播报。

注:

1）关于请求的响应， 其 response header 的 Content-Type 头部需要是 application/json 格式；
2）DUI SERVER请求厂商服务接口目前设置的超时时间为2秒，如果出现服务不可用的情况，请接入方进行优化；
3）家居协议的请求采用POST请求。

二、认证方式

智能家居协议遵循OAuth2.0规范。协议交互的每个请求都需要包含OAuth的access token。

三、协议内容

智能家居协议主要分为两部分: header 及 payload ( 均为HTTPS请求的BODY部分 )。

3.1 header参数

Header包含指令空间、指令名称、payloadVersion和消息标识符。

参数名	参数类型	参数说明	是否必须
namespace	string	DUI.SmartHome.Discovery DUI.SmartHome.Control DUI.SmartHome.Query	是
name	string	具体操作指令的名称，如：“TurnOn”，“SetVolume”等	是
payloadVersion	int	payload的版本号，当前全部传1	是
messageId	string	消息的唯一标识符，可用于跟踪请求	是

3.2 payload参数

Payload的内容与Header中的具体指令相关，不同类型的指令，其payload内容也不相同。

这里仅罗列各个请求中的典型参数，具体传参请查阅各个指令的详细设计。

参数名	参数类型	参数说明
accessToken	string	云端获取的accessToken
appliances.applianceId	string	设备ID
appliances.group	string	设备属于的分组或家庭组。 家庭组是为当一个用户账号拥有或管理了多个家庭或酒店多个房间的设备，期望控制时对这些家庭或房间做隔离的场景而设计的。 使用家庭组时，思必驰服务将仅从对应组下面筛选目标设备，用户语音指令中无需特别指明设备位置即可轻松控制，实现与无分组场景无差别的用户体验，适合酒店、学校、图书馆等场景使用
appliances.applianceType	string	设备类型，设备商只能传规定值。目前支持以下设备： LIGHT：电灯 SWITCH：开关 SOCKET：插座 CURTAIN：窗帘 AIR_CONDITION：空调 AIR_FRESHER：新风系统 TV_SET：电视 AIR_PURIFIER：空气净化器 FAN：电风扇 WATER_HEATER：热水器 HEATER：电暖器 WASHING_MACHINE：洗衣机 GAS_STOVE：燃气灶 RANGE_HOOD：油烟机 OVEN：烤箱 MICROWAVE_OVEN：微波炉 PRESSURE_COOKER：电压力锅 RICE_COOKER：电饭煲 INDUCTION_COOKER：电磁炉 HIGH_SPEED_BLENDER：破壁机 SWEEPING_ROBOT：扫地机器人 FRIDGE：冰箱 HUMIDIFIER：加湿器 AROMA_DIFFUSER：香薰机 SET_TOP_BOX：机顶盒 SENSOR：传感器 HANGER：晾衣架 SMART_GATING：智能门控 WATER_PURIFIER：净水器 DISHWASHER：洗碗机 STEAM_OVEN：蒸烤箱 WEBCAM：摄像头 ACTIVITY_TRIGGER：组合场景，场景中的设备必须以特定顺序操作 SCENE_TRIGGER：组合场景，场景中的设备间无关联 WINDOW_CONTROLLER：开窗器 WINE_CABINET：酒柜 WATER_DISPENSER：饮水机 FLOOR_HEATER：地暖 BATH_HEATER：浴霸 MATTRESS：床垫 PROJECTOR：投影仪 DOORBELL：门铃 DISINFECTION_CABINET：消毒柜 STEAMER：蒸箱
appliances.friendlyName	string	用户用来识别设备的名称
appliances.manufacturerName	string	设备厂商
appliances.modelName	string	设备型号
appliances.zone	string	设备的位置
appliances.actions	json array	设备支持的操作指令，目前合法的action包括： TurnOn：打开 TurnOff：关闭 StartUp：启动 TimingTurnOn：定时打开 TimingTurnOff：定时关闭 TimingStartUp：定时启动 TimingSetmode：定时模式（定时开始/持续） TimingCancelMode：定时取消模式 SetSchedule：设置预约时间 CancelSchedule：取消预约 Pause：暂停 Continue：取消暂停 SetBrightness：设置灯光亮度 IncreaseBrightness：调大亮度 DecreaseBrightness：调小亮度 SetTemperature：设置温度 IncreaseTemperature：升高温度 DecreaseTemperature：降低温度 SetColorTemperature：设置色温 IncreaseColorTemperature：升高色温 DecreaseColorTemperature：降低色温 SetVolume：设置音量 IncreaseVolume：调高音量 DecreaseVolume：调低音量 SetMute：设置静音状态 CancelMute：取消静音状态 IncreaseWindSpeed：增加风速 DecreaseWindSpeed：减小风速 SetWindSpeed：设置风速 IncreaseFogLevel：增加雾量 DecreaseFogLevel：减小雾量 SetFogLevel：设置雾量 SetMode：设置模式 CancelMode：取消模式 SetHumidity：设置湿度 SetChannel：设置频道号 SetChannelName：设置频道名称 IncreaseChannel：向前跳N个频道 DecreaseChannel：向后跳N个频道 SetUpWind：向上调整风向 SetDownWind：向下调整风向 SetLeftWind：向左调整风向 SetRightWind：向右调整风向 SetUpAndDownWind：上下摆风 SetRightAndLeftWind：左右摆风 SetFrontFacingWind：正向风 CloseSwing：关闭摆风 SetColor：设置颜色 SetOpenDegree：设置打开程度 IncreaseOpenDegree：调大打开程度 DecreaseOpenDegree：调小打开程度 SetHeight：设置高度 IncreaseHeight：调高高度 DecreaseHeight：调低高度 OpenFunction：打开设备功能 CloseFunction：关闭设备功能 Charge：电源充电 Discharge：结束充电 SetHeatLevel：设置热力档位 IncreaseHeatLevel：调高热力档位 DecreaseHeatLevel：调低热力档位 SetAngle：设置角度 IncreaseAngle：调大角度 DecreaseAngle：调小角度 SetHardness：设置硬度 IncreaseHardness：增加硬度 DecreaseHardness：减小硬度 SetButton：设置按键 SetUpAngle：设置向上转动 SetDownAngle：设置向下转动 SetLeftAngle：设置向左转动 SetRightAngle：设置向右转动 SetUpperLeftAngle：设置向左上转动 SetUpperRightAngle：设置向右上转动 SetLowerLeftAngle：设置向左下转动 SetLowerRightAngle：设置向右下转动 SetFrontFacingAngle：设置朝向正面 QueryPowerState：查询电源状态 QueryTemperature：查询温度 QueryWindSpeed：查询风速 QueryBrightness：查询亮度 QueryHumidity：查询湿度 QueryChannel：查询频道号 QueryChannelName：查询频道名称 QueryColor：查询颜色 QueryPM25：查询PM2.5 QueryAQI：查询空气质量 QueryVOC：查询挥发物浓度 QueryCO2：查询二氧化碳浓度 QueryTDS：查询水质TDS值 QueryRemainingTime：查询剩余时间 QuerySchedule：查询预约时间 QueryMode：查询模式 QueryRO：查询净水滤芯RO膜剩余寿命 QueryBattery：查询电池电量 QueryAngle：查询角度 QueryHardness：查询硬度 QueryPM1：查询PM1.0 QueryPM10：查询PM10 QueryHCHO：查询甲醛 QueryOpenDegree：查询打开程度
appliances.description	string	设备的描述信息
appliances.additionalApplianceDetails	json object	供给设备云使用，存放设备相关的附加信息。DUI不关注不使用这些数据，如果设备信息包含此字段，DUI控制设备时将原样返回，最大长度不能超过2000字节
timestamp	int	定时操作对应的触发时间，为时间戳，精确到秒。仅在namespace:DUI.SmartHome.Control且name:TimingXXX的指令中出现
duration	int	操作的持续时间。单位:秒。仅在namespace:DUI.SmartHome.Control的指令中存在
endtime	int	定时操作对应的完成时间，为时间戳，精确到秒。仅在namespace:DUI.SmartHome.Control且name:TimingXXX的指令中出现
compartment	string	指定受控的区域/隔间，非必传参数，仅在DUI.SmartHome.Control指令中存在。 设备类型对应的合法值如下： FRIDGE: REFRIGERATOR(冷藏室), FREEZER(冷冻室), SMARTCONVERTIBLE(变温区) GAS_STOVE: LEFT_STOVE(左灶具), RIGHT_STOVE(右灶具) INDUCTION_COOKER: LEFT_STOVE(左灶具), RIGHT_STOVE(右灶具) MATTRESS：LEFT(左半部),RIGHT(右半部),HEAD(头部),WAIST(腰部),LEG(腿部),LEFT_HEAD(左头部),RIGHT_HEAD(右头部),LEFT_WAIST(左腰部),RIGHT_WAIST(右腰部),LEFT_LEG(左腿部),RIGHT_LEG(右腿部) STEAMER:WATER _BOX(水箱)

3.3 模式对照表

对于支持模式的设备，不同的类型可以控制的模式也不同。下面仅列出支持模式设置的设备及其对应的模式：

设备类型	设备模式
LIGHT	WHITE_LIGHT：白光模式 COLOR_LIGHT：彩光模式 LIFE_MODE：生活模式  NIGHT_LIGHT：夜灯模式  SOFT_MODE：柔和模式 READING：阅读模式 LEISURE：休闲模式 WARM：温馨模式 SLEEP：睡眠模式 MUSIC：音乐模式 SCENE_MODE：场景模式 LEARNING：学习模式 FLOWING：流光模式 MORNING：起床/早安模式 OFFICE：工作模式/办公模式
AIR_CONDITION	COOL：制冷 HEAT：制热 AUTO：自动 FAN：送风 DEHUMIDIFICATION：除湿 SLEEP：睡眠 COMFORTABLE：舒适
AIR_PURIFIER	SLEEP：睡眠 HOME：回家 OUT：离家 AUTO：自动 MANUAL：手动 MUTE：静音 INTELLIGENT：智能 HIGHSPEED：急速 DUST：除尘 HCHO_FREE：除甲醛 ENERGY_SAVING：节能 POWERFUL：强效/强力
AIR_FRESHER	SLEEP：睡眠 HEAT：制热 AUTO：自动 DUST：除尘 HCHO_FREE：除甲醛
INDUCTION_COOKER	QUICK_FIRE：快速火 SLOW_FIRE：温火 FRYING：煎炸 STEWING：蒸煮/炖煮 SOUP：汤粥/煲汤 HOT_POT：火锅 COOKING：炒菜
SWEEPING_ROBOT	RANDOM：随机 AUTO：自动 FOCUS：重点/定点 EDGE：沿边 BOW：弓形/Z形 POWERFUL：强力 STANDARD：标准 SPIRAL：螺旋 LEFT_BOW：左弓形 RIGHT_BOW：右弓形 LEFT_SPIRAL：左螺旋 RIGHT_SPIRAL：右螺旋 SWEEPING：扫地 MOPPING：拖地 PARTIAL_BOW：局部弓形
MICROWAVE_OVEN	MICROWAVE：微波 BARBECUE：烧烤 THAW：解冻
OVEN	FERMENTATION：发酵 DOUBLE_TUBE：双管 THAW：解冻 PREHEAT：快速预热 BOTTOM_HEAT：底加热模式 AIR_BAKE：风焙烤模式 AIR_BARBECUE：风扇烤模式 FRY_ROAST：煎烤模式 FAST_HEAT：快热模式 STRONG_ROAST：强烧烤模式 ROTARY_ROAST：旋转烤模式 THAW：解冻模式 BARBECUE：烧烤模式
RICE_COOKER	HOTTING：加热/热饭/再加热 INSULATED：保温 SOUP：煮粥/煲汤/杂粮粥 FAST_SOUP：快速粥 STEWING：蒸煮/炖煮/美味蒸 NORMAL_RICE：蒸米饭 MIXED_RICE：杂粮饭 SMALL_RICE：小米饭 GERMINATED_RICE：发芽饭
WASHING_MACHINE	STANDARD：标准 DRY：干洗 WASH_DRY：洗烘 FAST_WASH：快洗 DOWN_JACKET：羽绒服
FRIDGE	INTELLIGENT：智能 FAST_FREEZE：速冻 FAST_COOLING：速冷 MANUAL：手动设定 ICE_DRINK：冰饮功能
HUMIDIFIER	AUTO：自动 SLEEP：睡眠 STANDARD：标准 LOW_HUMIDITY：低湿 HIGH_HUMIDITY：高湿
AROMA_DIFFUSER	AUTO：自动 CONTINIOUS_SPRAY：连续喷雾 INTERMITTENT_SPRAY：间隔喷雾 SLEEP：睡眠
HANGER	DRYING：烘干 AIR_DRY：风干 NAI：负离子 DISINFECT：消毒 UP_DOWN：一键升降
DISHWASHER	STANDARD：标准 FAST_WASH：快洗 DISINFECT：消毒 POWERFUL：强力 SOFT：轻柔 DRYING：烘干 INTELLIGENT：智能 FRUIT：水果洗 ENERGY_SAVING：节能 CUSTOM：自定义 PREWASH：预洗 STORE：存储 HOTTING：热碗
STEAM_OVEN	FERMENTATION：发酵 DOUBLE_TUBE：双管 THAW：解冻 STEAM：普通蒸 LOW_STEAM：低温蒸 HIGH_STEAM：高温蒸 HOT_ROAST：热风烤 BAKE：烘焙、焙烤 FAST_ROAST：快烤 SLOW_ROAST：慢烤 TENDER_ROAST：嫩烤 STEAMING_ROAST：蒸烤 STEAM_THEN_ROAST：先蒸后烤 SLEF_CLEAN：自清洁
WATER_HEATER	HALF_WATER：半胆加热 FULL_WATER：全胆加热 MAX_WATER： 速热增容 DISINFECT：抑菌/消毒 BATH：洗浴模式 COOKING：厨宝模式 STANDARD：标准模式 PREHEAT：单次预热 SMART_PREHEAT：智能预热 HEAT：即时加热 NIGHT：峰谷夜电 PLAN：预约预热
BATH_HEATER	VENTILATE：换气 FAN：吹风 HIGH_HEAT：强暖 LOW_HEAT：弱暖 COOL：冷风 HEAT：暖风 STAND_BY：待机
FAN	SLEEP：睡眠 STANDARD：标准 BABY：宝宝
MATTRESS	MOVIE：影院模式 READING：阅读模式 ZEROGRAVITY：零重力模式 LEISURE：休闲模式 YOGA：瑜伽模式 PREGNANT：孕妇模式 CHILDREN：儿童模式 PRIVACY：隐私模式 SNORESTOP：止鼾模式 SLEEP：睡眠模式
CURTAIN	OUTSIDE_VISIBLE：外部可见 INSIDE_VISIBLE：内部可见 TRANSPARENCY：通透模式
DISINFECTION_CABINET	FAST_CLEAN：快洁模式 MATERNAL_CHILD：母婴模式 PLATE_WARM：暖碟模式 DRYING：烘干模式 DISINFECT：消毒模式 INTELLIGENT：智能模式
RANGE_HOOD	RANGE_HOOD_STOVE_LINKAGE：烟灶联动模式
STEAMER	EGG：蛋类模式 PASTRY：面点模式 STRONG_STEAM：强力蒸模式 FISH：鱼类模式 INSULATED：保温模式 FERMENTATION：发酵模式 DISINFECT：杀菌模式 STEWING：营养蒸模式

3.4 支持设置的颜色表

支持控制的颜色	中文描述
Red	红色
Yellow	黄色
Blue	蓝色
Green	绿色
White	白色
Black	黑色
Cyan	青色
Purple	紫色
Orange	橙色
Pink	粉红色
Violet	紫罗兰色
Magenta	洋红色
Indigo	靛青色
SlateBlue	蓝灰色
DarkBlue	深蓝色
SkyBlue	天蓝色
DarkCyan	深青色
Beige	浅褐色
Brown	棕色

注：若上述颜色厂商对应表中无，请近似匹配

3.5 设备属性的规格说明

属性名称	增量型名称	中文含义	取值范围	说明
brightness	deltaBrightness	亮度	0-100(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	亮度的百分比（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低亮度,中亮度,高亮度, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
volume	deltaVolume	音量	0-100(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	音量的百分比（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低音量,中音量,高音量, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
temperature	deltaTemperature	温度	-30-250(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	温度的数值，单位ºC（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低温,中温,高温, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
channel	deltaChannel	频道号	0-1000(整型),'min','max','step'(仅在增量型属性时有效)	频道号（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
channelName	无增量形式	频道名称	string	“中央一套”，“东方卫视”，“湖南卫视” 等标准频道名称
speedLevel	deltaSpeedLevel	风速	1-4(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效) 风扇类:(1档,2档,3档,4档) 空调类:(自动,低,中,高)	风速的等级（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低风,中风,高风, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
fogLevel	deltaFogLevel	雾量	1-3(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	雾量的等级（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低雾量,中雾量,高雾量, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
仅支持增量形式	deltaAngel	风向角度	0-180(整型),'min','max','step'(仅在增量型属性时有效)	风向偏转的角度（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
humidity	deltaHumidity	湿度	0-100(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	相对湿度的百分比（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低湿,中湿,高湿, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
mode	无增量形式	模式	string	模式名称，参见 “3.3模式对照表”
color	无增量形式	颜色	string	颜色的名称，参见 “3.4支持设置的颜色表”
openDegree	deltaOpenDegree	设备的打开程度	0-100(整型),'min','max','step'(仅在增量型属性时有效)	窗帘等设备的打开程度百分比（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
height	deltaHeight	高度	0-1000(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	高度的数值，单位cm（对于增量型属性，数值为绝对值，只表征变化量） 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低,中,高, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
colorTemperature	deltaColorTemperature	色温	2700-10000(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	色温的数值，单位卡尔文（对于增量型属性，数值为绝对值，只表征变化量），如果传参超过厂商设备最大、小值，厂商取该设备最大、小值进行设置 支持'max'和'min'来指代最冷最暖, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代暖色,均衡,冷色, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
heatLevel	deltaHeatLevel	热力档位	1-10(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	热力加热的档位(对于增量型属性,数值为绝对值,只表征变化量) 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低档,中档,高档, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
function	无增量形式	设备功能	string 合法值： 'LIGHTING'：照明功能 'DISPLAY'：数字屏显功能 'VIDEO'：视频摄像功能 'SPEECH'：语音功能 'LOCK'：童锁功能 'FAN'：排风/换气 'VENTILATION'：新风 'EA_HEATING'：电辅热 'PURIFY'：净化功能 'FAN_AVOID'：风避人吹 'FAN_CHASE'：风对人吹	设备要操作的子功能, 如油烟机打开照明, 油烟机关闭排风, 电暖器打开屏显, 门锁开启摄像
angle	deltaAngle	角度	0-180(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	调整角度,单位度，如果传参超过厂商设备最大、小值，厂商取该设备最大、小值进行设置 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低档,中档,高档, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理
hardness	deltaHardness	硬度	0-100(整型),'min','max','low','mid','high','step'(仅在增量型属性时有效)	硬度百分比(对于增量型属性,数值为绝对值,只表征变化量) 支持'max'和'min'来指代最大最小, 厂商可根据实际情况做对应处理 支持'low','mid','high'来指代低档,中档,高档, 厂商可根据实际情况做对应处理 增量型控制时,支持'step'来指代一段步长, 厂商可根据实际情况做对应处理

3.6 各指令对定时相关操作的支持情况

操作类型	指令格式	示例
定时开始	指令名称:Timing+普通指令，如'TimingTurnOn'等 payload中增加'timestamp'字段，value为时间戳，精确到秒	见 4.2.4节 '定时打开'
持续时间	payload中增加'duration'字段，精确到秒	见 4.2.31节 '设置模式'
定时完成	指令名称:Timing+普通指令，如'TimingSetMode'等 payload中增加'endtime'字段，value为时间戳,精确到秒	见 4.2.55节 '定时完成'

3.7 模拟按键对照表

设备类型	按键码	中文描述
电视	Back	返回
电视	Home	打开主页
电视	Settings	打开设置页

4.1 设备发现

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Discovery",
        "name":"Discover",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "group":"xxx" //仅当使用家庭组功能会出现此字段，表示仅期望获取对应家庭组下的设备列表，IOT厂商仅返回对应group下的设备即可
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Discovery",
        "name":"DiscoverResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "appliances":[
            {
                "applianceId":"xxxxx",
                "group":"xxxxx",
                "friendlyName":"多孔插座",
                "applianceType":"SOCKET",
                "manufacturerName":"xxxxx",
                "modelName":"xxxx",
                "zone":"客厅",
                "description":"",
                "actions":[
                    "TurnOn",
                    "TurnOff"
                ],
                "additionalApplianceDetails":{
                    "extraDetail1":"xxxx",
                    "extraDetail2":"xxxx",
                    "extraDetail3":"xxxx",
                    "extraDetail4":"xxxx"
                }
            },
            {
                "applianceId":"xxxxx",
                "group":"xxxxx",
                "friendlyName":"灯",
                "applianceType":"LIGHT",
                "manufacturerName":"xxxxx",
                "modelName":"xxxx",
                "zone":"客厅",
                "description":"",
                "actions":[
                    "TurnOn",
                    "TurnOff"
                ],
                "additionalApplianceDetails":{

                }
            },
            {
                "applianceId":"xxxxx",
                "group":"xxxxx",
                "friendlyName":"单孔插座",
                "applianceType":"SOCKET",
                "manufacturerName":"xxxxx",
                "modelName":"xxxx",
                "zone":"客厅",
                "description":"",
                "actions":[
                    "TurnOn",
                    "TurnOff"
                ],
                "additionalApplianceDetails":{

                }
            }
        ]
    }
}

4.2 设备控制

4.2.1 打开设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TurnOn",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TurnOnResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.2 关闭设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TurnOff",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

 {
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TurnOffResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.3 启动设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"StartUp",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"StartUpResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.4 定时打开设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingTurnOn",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "timestamp":{
            "value":1524030874
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingTurnOnResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.5 定时关闭设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingTurnOff",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "timestamp":{
            "value":1524030874
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingTurnOffResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.6 定时启动设备

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingStartUp",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "timestamp":{
            "value":1524030874
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingStartUpResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.7 设备暂停

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"Pause",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"PauseResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.8 取消暂停

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"Continue",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"ContinueResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.9 设置亮度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetBrightness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "brightness":{
            "value":50
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetBrightnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.10 设置最大亮度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetBrightness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "brightness":{
            "value":"max"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetBrightnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.11 调大亮度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseBrightness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaBrightness":{
            "value":20
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseBrightnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.12 调小亮度

请求

    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseBrightness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaBrightness":{
            "value":10
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseBrightnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.13 设置温度

请求 (如果设备是冰箱,且说法中指明了'冷藏室'或'冷冻室',则请求体中会附带'compartment'字段)

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetTemperature",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "temperature":{
            "value":26
        },
        "compartment":"FREEZER"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetTemperatureResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.14 调大温度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseTemperature",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaTemperature":{
            "value":3
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseTemperatureResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.15 调小温度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseTemperature",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaTemperature":{
            "value":5
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseTemperatureResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.16 设置音量

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetVolume",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "volume":{
            "value":60
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetVolumeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.17 调大音量

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseVolume",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaVolume":{
            "value":20
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseVolumeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.18 调小音量

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseVolume",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaVolume":{
            "value":20
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseVolumeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.19 设置静音

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetMute",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetMuteResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.20 取消静音

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelMute",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelMuteResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.21 设置频道

请求（按频道号设置）

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetChannel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "channel":{
            "value":12
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetChannelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.22 设置频道名称

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetChannelName",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "channelName":{
            "value":"湖南卫视"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetChannelNameResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.23 向前跳N个频道

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseChannel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaChannel":{
            "value":3
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseChannelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.24 向后跳N个频道

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseChannel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaChannel":{
            "value":4
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseChannelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.25 设置风速

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetWindSpeed",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "speedLevel":{
            "value":2
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetWindSpeedResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.26 增大风速

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseWindSpeed",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaSpeedLevel":{
            "value":1
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseWindSpeedResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.27 减小风速

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseWindSpeed",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaSpeedLevel":{
            "value":2
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseWindSpeedResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.28 设置湿度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHumidity",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "humidity":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHumidityResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.29 增大湿度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHumidity",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHumidity":{
            "value":20
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHumidityResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.30 减小湿度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHumidity",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHumidity":{
            "value":10
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHumidityResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.31 设置模式

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetMode",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "mode":{
            "deviceType":"AIR_CONDITION",
            "value":"COOL"
        },
        "duration":3600
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetModeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.32 取消模式

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelMode",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "mode":{
            "deviceType":"AIR_CONDITION",
            "value":"COOL"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelModeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.33 定时设置模式

请求

{
    "header":{
        "messageId":"2aad6761-d4d9-4538-9272-4e95d6ab211d",
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingSetMode",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"xxx",
        "timestamp":{
            "value":1576721722
        },
        "appliance":{
            "additionalApplianceDetails":{

            },
            "applianceId":"xxx"
        },
        "mode":{
            "value":"DISINFECT",
            "deviceType":"HANGER"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingSetModeResponse",
        "messageId":"2aad6761-d4d9-4538-9272-4e95d6ab211d",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.34 向上调整风向

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngel":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.35 向下调整风向

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetDownWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngel":{
            "value":20
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetDownWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.36 向左调整风向

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLeftWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngel":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLeftWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.37 向右调整风向

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngel":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.38 上下摆风

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpAndDownWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpAndDownWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.39 左右摆风

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightAndLeftWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightAndLeftWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.40 设置颜色

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetColor",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "color":{
            "value":"Yellow"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetColorResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.41 设置打开程度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetOpenDegree",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "openDegree":{
            "value":50
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetOpenDegreeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.42 调大打开程度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseOpenDegree",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaOpenDegree":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseOpenDegreeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.43 调小打开程度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseOpenDegree",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaOpenDegree":{
            "value":10
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseOpenDegreeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.44 关闭摆风

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CloseSwing",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CloseSwingResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.45 打开功能

请求（例如打开油烟机照明）

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"OpenFunction",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        }
        "function":{
             "value":"LIGHTING"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"OpenFunctionResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.46 关闭功能

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CloseFunction",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        }
        "function":{
             "value":"LIGHTING"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CloseFunctionResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.47 设置时间预约

说明：某些设备“预约“与其他操作是两个按钮（如电饭煲），需要两条指令触发定时时使用本指令。用法：先发一条设置时间预约指令，紧随其后下发的下一条指令为定时操作。

timestamp:预约开始时间, 单位:时间戳,精确到秒. 请求中可单独出现

endtime:预约完成时间,单位:时间戳,精确到秒. 请求中可单独出现

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetSchedule",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "timestamp":{
            "value":1524030874
        },
        "endtime":{
            "value":1524031074
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetScheduleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.48 取消时间预约

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelSchedule",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelScheduleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.49 以虚拟步长的方式调整数值

请求（例:'温度调高一点', 协议设虚拟数值'step',实际调整值由厂商自行决定）

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseTemperature",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaTemperature":{
            "value":"step"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseTemperatureResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.50 电源充电

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"Charge",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"ChargeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.51 结束充电

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"Discharge",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DischargeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.52 设置热力档位

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHeatLevel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "heatLevel":{
            "value":3
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHeatLevelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.53 调高热力档位

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHeatLevel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHeatLevel":{
            "value":1
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHeatLevelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.54 调低热力档位

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHeatLevel",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHeatLevel":{
            "value":1
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHeatLevelResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.55 定时完成

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingSetMode",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{

            }
        },
        "mode":{
            "deviceType":"RICE_COOKER",
            "value":"SOUP"
        },
        "endtime":{
            "value":1524030874
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"TimingSetModeResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922869",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.56 设置角度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "angle":{
            "value":180
        },
        "compartment":"LEFT_HEAD"

    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.57 调大角度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":10
        },
        "compartment":"LEFT_HEAD"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.58 调小角度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":10
        },
        "compartment":"LEFT_HEAD"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.59 设置硬度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHardness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "hardness":{
            "value":50
        },
        "compartment":"RIGHT"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetHardnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.60 增加硬度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHardness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHardness":{
            "value":10
        },
        "compartment":"RIGHT"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"IncreaseHardnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.61 减小硬度

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHardness",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaHardness":{
            "value":10
        },
        "compartment":"RIGHT"
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"DecreaseHardnessResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.62 设置按键

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetButton",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "button":{
            "value":"Back"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetButtonResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.63 设置向上转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.64 设置向下转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetDownAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetDownAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.65 设置向左转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLeftAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLeftAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.66 设置向右转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetRightAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.67 设置向左上转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpperLeftAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpperLeftAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

 

4.2.68 设置向右上转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpperRightAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUpperRightAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.69 设置向左下转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLowerLeftAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLowerLeftAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.70 设置向右下转动

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLowerRightAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetLowerRightAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.71 设置向正前方

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetFrontfacingAngle",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetFrontfacingAngleAngleResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.72 设置正向风（向正前方调整风向）

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetFrontFacingWind",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "deltaAngle":{
            "value":30
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetFrontFacingWindResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.73 设置待机模式

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetStand_BY",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "model":{
            "device Type":"BATH_HEATER",
            "value":"Stand_BY"
        },
        "duration":3600
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetStand_BYResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.74 取消待机模式

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelStand_BY",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "model":{
            "deviceType":"BATH_HEATER",
            "value":"Stand_BY"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"CancelStand_BYResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.2.75 一键升降模式

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUP_DOWN",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        },
        "model":{
            "deviceType":"HANGER",
            "value":"UP_DOWN"
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Control",
        "name":"SetUP_DOWNResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
    }
}

4.3 设备查询

4.3.1 支持的查询属性列表

属性名	heander name	说明	属性类型	备注
powerState	QueryPowerState	电源状态	string	“on”（通电状态），“off”（断电状态）
temperature	QueryTemperature	温度	int	-30-250（单位ºC）
speedLevel	QueryWindSpeed	风速	int	1-4 风扇类: （1档，2档，3档，4档） 空调类: （自动，低，中，高）
brightness	QueryBrightness	亮度	int	0-100（亮度百分比）
humidity	QueryHumidity	湿度	int	0-100（相对湿度百分比）
channel	QueryChannel	频道号	int	0-1000（频道号）
channelName	QueryChannelName	频道名称	string	“中央一套”，“东方卫视”等 （必须为标准频道名称）
color	QueryColor	颜色	string	参见“4.3.2支持查询的颜色列表”
PM25	QueryPM25	PM2.5	int	0-1000（浓度值）
AQI	QueryAQI	空气质量	int	1-6（优，良，轻度，中度，重度，严重）
VOC	QueryVOC	挥发物浓度	int	0-1000(浓度值)
CO2	QueryCO2	二氧化碳浓度	int	0-1000(浓度值)
TDS	QueryTDS	水质TDS值	int	0-1000(TDS值)
remainingTime	QueryRemainingTime	剩余时间	int	单位：秒
schedule	QuerySchedule	预约时间	int	预约时间的时间戳，精确到秒
mode	QueryMode	模式	string	参见 “3.3模式对照表”
RO	QueryRO	净水滤芯RO膜剩余寿命	int	单位：天
battery	QueryBattery	电池电量	int	0-100(电量百分比)
onlineState	QueryOnline	在线情况	string	'online'(在线) , 'offline'(离线)(本属性不支持语音查询)
watersensorAlarm	QueryWatersensorAlarm	水浸告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
smokeAlarm	QuerySmokeAlarm	烟雾告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
gasAlarm	QueryGasAlarm	燃气告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
ch4Alarm	QueryCh4Alarm	甲烷告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
coAlarm	QueryCoAlarm	一氧化碳告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
ch2oAlarm	QueryCh2oAlarm	甲醛告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
SOSAlarm	QuerySOSAlarm	SOS告警	string	'ok'(正常) , 'alarm'(报警)(本属性不支持语音查询)
detectionState	QueryDetectionState	检测状态	string	'detected'(检测到),'not_detected'(未检测到)(本属性不支持语音查询)
humanPresenceDetectionState	QueryHumanPresenceDetectionState	人体检测状态	string	'detected'(检测到),'not_detected'(未检测到)(本属性不支持语音查询)
openDegree	QueryOpenDegree	打开程度	int	0-100(打开百分比)
soundLightAlarm	QuerySoundLightAlarm	声光报警	string	'ok'(正常) , 'alarm_sound'(声音报警), 'alarm_light'(光报警), 'alarm_sound_light'(声光报警)
angle	QueryAngle	查询角度	int	0-360(角度)
hardness	QueryHardness	查询硬度	int	0-100(百分比)
PM1	QueryPM	PM1	int	0-1000(浓度值)
PM10	QueryPM	PM10	int	0-1000(浓度值)
HCHO	QueryHCHO	甲醛浓度	int	0-1000(浓度值)

4.3.2 支持查询的颜色列表

支持查询的颜色	中文描述
Red	红色
Yellow	黄色
Blue	蓝色
Green	绿色
White	白色
Black	黑色
Cyan	青色
Purple	紫色
Orange	橙色
Pink	粉红
Violet	紫罗兰
Magenta	洋红
Indigo	靛青
SlateBlue	蓝灰色
DarkBlue	深蓝色
SkyBlue	天蓝色
DarkCyan	深青色
Beige	浅褐色
Brown	棕色

注：若上述颜色厂商对应表中无，请近似匹配。

4.3.3 查询单个属性

• 属性查询指令，厂商必须在响应体的payload字段中返回指令指定查询的属性结果，属性名参考表4.3.1
• 另外，属性查询指令，支持厂商配置自定义播报(可选), 方式为: 在响应的payload字段中, 除正常必须要返回的属性字段外, 增加custom字段
• 若配置了自定义播报，则思必驰服务采用custom字段中配置的内容，而不再读取指定属性名里的值

custom字段格式	字段内容	取值	说明
json对象	nlg	string类型, 自定义播报内容,内容仅支持中英文,数字,逗号,句号	厂商自定义播报的内容, 思必驰直接播报内容, 中间不做任何处理
	details	为json对象, 一些附加的要说明或展示的信息	思必驰不关心也不处理字段内容, 仅透传出去

 

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Query",
        "name":"QueryTemperature",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Query",
        "name":"QueryTemperatureResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "temperature":{
            "value":10
        },
        "custom":{
            "nlg":"冰箱冷藏室当前温度为摄氏十度,冷冻室当前温度为零下八度",
            "details":{

            }
        }
    }
}

4.3.4 查询全部属性

• 厂商需返回当前设备支持的4.3.1节所列的所有属性
• 全属性查询，同样支持厂商配置自定义播报(可选)，配置方式同单属性查询

请求

{
    "header":{
        "namespace":"DUI.SmartHome.Query",
        "name":"QueryAll",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "accessToken":"access token",
        "appliance":{
            "applianceId":"123456789",
            "additionalApplianceDetails":{}
        }
    }
}

响应

{
    "header":{
        "namespace":"DUI.SmartHome.Query",
        "name":"QueryAllResponse",
        "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
        "payloadVersion":1
    },
    "payload":{
        "powerState":{
            "value":"on"
        },
        "temperature":{
            "value":30
        },
        "speedLevel":{
            "value":2
        },
        "brightness":{
            "value":60
        },
        "humidity":{
            "value":70
        },
...
        "custom":{
            "nlg":"XXX",
            "details":{

            }
        }
    }
}

4.4 错误信息

错误响应 header 协议中name固定为 “ErrorResponse”；

“namespace”，“messageId”，“payloadVersion”三个参数使用请求消息中对应字段内容。

payload字段说明如下：

error code	说明	message
SERVICE_ERROR	服务异常	服务错误原因
DEVICE_NOT_SUPPORT_FUNCTION	设备不支持该操作	device not support
INVALIDATE_PARAMS	请求参数有误	invalidate params
DEVICE_IS_NOT_EXIST	设备未找到	device is not exist
IOT_DEVICE_OFFLINE	设备离线状态	device is offline
ACCESS_TOKEN_INVALIDATE	access_token 无效（包括失效）	access_token is invalidate
VALUE_OUT_OF_RANGE	参数值超出有效值范围（如：温度，模式）	value out of range
IOT_DEVICE_SHUTDOWN	设备关机状态	device is in shutdown state
NOT_SUPPORT_ON_CURRENT_STATUS	设备当前状态下不支持该操作	not support on current status
STATUS_NOT_SUPPORT_RESET	设备已是目标状态,不允许重复设置	status not support reset

错误信息示例:

响应

{
    "header":{
        "namespace":"DUI.SmartHome.XXXXX",
        "name":"ErrorResponse",
        "messageId":"26fa11a8-accb-4f66-a272-8b1ff7abd722",
        "payloadVersion":1
    },
    "payload":{
        "errorCode":"ACCESS_TOKEN_INVALIDATE",
        "message":"access_token is invalidate"
    }
}

五、示例说法

DUI智能家居技能内置了丰富的指令说法，开发商不需要再进行说法的开发及定制。我们从中选取了一些常用的指令说法，以供测试及参考。

5.1 各指令示例说法

操作指令	说法示例
打开设备	“打开电灯”，“打开客厅的电灯”
关闭设备	“关闭空调”，“关闭卧室的窗帘”
定时打开	“一小时后打开电灯”，“一小时后打开客厅的空调”
定时关闭	“一小时后关闭电灯”，“一小时后关闭卧室的空调”
设备暂停	“洗衣机暂停一下”，“卫生间的洗衣机暂停一下”，“暂停洗衣机”，“暂停卫生间的洗衣机”
取消暂停	“洗衣机取消暂停”，“卫生间的洗衣机取消暂停”，“取消暂停洗衣机”
设置亮度	“灯亮度调到百分之五十”，“客厅的灯亮度调到百分之五十”
调大亮度	“把灯调亮一些”，“把客厅的灯调亮一些”，“卧室的灯亮度调亮百分之二十”
调小亮度	“把灯调暗一些”，“把客厅的灯调暗一些”，“卧室的灯亮度调暗百分之二十”
设置温度	“空调温度调到二十六度”，“卧室的空调温度调到二十六度”
调高温度	“空调的温度调高点”，“调高客厅的空调温度”，“客厅的空调温度调高三度”，“调高客厅空调的温度三度”
调低温度	“空调的温度调低点”，“调低客厅的空调温度”，“客厅的空调温度调低三度”，“调低客厅空调的温度三度”
设置音量	“电视音量调到六十”，“客厅的电视音量调到六十”
调高音量	“调高电视的音量”，“客厅的电视音量调大二十”
调低音量	“调低电视的音量”，“客厅的电视音量调低二十”
设置静音	“电视静音”，“客厅的电视静音”，“客厅的电视调成静音”
取消静音	“取消电视静音”，“客厅的电视取消静音”，“取消客厅电视的静音”
设置频道	“电视频道调到十二”，“电视频道调到十二台”，“客厅电视的频道调到十二”，“电视频道调到湖南卫视”，“电视调到东方卫视”
向前调N个频道	“电视频道往前调三个”，“电视频道往前调三个台”，“电视往前调三个频道”，“电视往前调三个台”，“往前调三个电视频道”，“客厅的电视往前调三个频道”
向后调N个频道	“电视频道往后调三个”，“电视频道往后调三个台”，“电视往后调三个频道”，“电视往后调三个台”，“客厅的电视往后调三个频道”，“电视频道往回调三个台”，“往回调三个电视频道”，“电视往回调三个频道”
设置风速	“空调的风速设为中速”，“空调的风速设为高风”，“风扇的风速设置为二档”
增大风速	“调高空调的风速”，“调高风扇的风速”，“风扇的风速调高一档”，空调的风速调高一档”
减小风速	“调低空调的风速”，“调低风扇的风速”，“风扇的风速调低一档”，“空调的风速调低一档”
设置湿度	“加湿器湿度调到百分之三十”，“客厅的加湿器湿度调到百分之三十”
增大湿度	“加湿器湿度调高百分之十”，“客厅的加湿器湿度调高百分之十”
减小湿度	“加湿器湿度调低百分之十”，“客厅的加湿器湿度调低百分之十”
设置模式	“空调设为制冷模式”，“厨房的电饭煲设为保温模式”
向上调整风向	“空调的风向调高一点”，“空调的风向调高二十度”，“客厅空调的风向调高二十度”
向下调整风向	“空调的风向调低一点”，“空调的风向调低二十度”，“客厅空调的风向调低二十度”
向左调整风向	“空调的风向向左调一点”，“向左调一点空调的风向”，“空调的风向向左调二十度”，“风扇的风向向左调一点”
向右调整风向	“空调的风向向右调一点”，“向右调一点空调的风向”，“风扇的风向向右调二十度”，“风扇的风向向右调一点”
上下摆风	“空调设置上下摆风”，“客厅的空调设置上下摆风”
左右摆风	“空调设置左右摆风”，“客厅的空调设置左右摆风”，“客厅的风扇设置左右摆风”
设置颜色	“书房的台灯调成黄色”，“客厅的电灯调成蓝色”
设置打开程度	“卧室的窗帘打开百分之五十”，“客厅的窗帘打开百分之九十”
调大打开程度	“客厅的窗帘开大一些”，“客厅的窗帘调大百分之三十”，“客厅的窗帘再打开一些”，“客厅的窗帘再打开百分之三十”
调小打开程度	“客厅的窗帘再关闭一些”，“客厅的窗帘再关闭百分之三十”，“客厅的窗帘调小一些”，“客厅的窗帘调小百分之三十”
查询温度	“查一下空调的温度”，“查一下客厅空调的温度”
查询风速	“查一下空调的风速”，“查一下客厅风扇的风速”
查询亮度	“查一下灯的亮度”，“查一下客厅的灯的亮度”
查询湿度	“加湿器查一下湿度”，“客厅的净化器查一下湿度”
查询频道	“查一下电视频道”，“查一下客厅电视频道”，“客厅的电视查一下频道”
查询颜色	“查一下灯的颜色”，“查一下客厅灯的颜色”
查询模式	“查一下空调的模式”，“查一下客厅加湿器的模式”，“客厅的加湿器查一下模式”
查询PM25	“净化器查一下PM二点五”，“客厅的净化器查一下PM二点五”
查询空气质量	“净化器查一下空气质量”，“客厅的净化器查一下空气质量”
查询VOC	“查一下新风系统的挥发物浓度”
查询CO2	“查一下新风系统的二氧化碳浓度”
查询TDS	“查一下净水器的水质”
查询剩余时间	“查一下洗衣机的剩余工作时间”，“查一下电饭煲剩余工作时间”
查询预约时间	“查一下洗衣机预约时间”
扫地机充电	"扫地机充电", "扫地机回去充电"
打开照明	"油烟机打开照明", "油烟机打开照明功能"
打开数字屏显	"电暖器打开屏显"
设置色温	"灯调成冷色","灯调成暖色","书房的灯调成暖色"
调高色温	"灯调冷一点","书房的灯调冷一点"
调低色温	"灯调暖一点","书房的灯调暖一点"
打开童锁	"打开燃气灶的童锁","把燃气灶的童锁打开"
关闭童锁	"关闭燃气灶的童锁","把燃气灶的童锁取消"
打开排风	"打开油烟机的风机","把油烟机的风机打开"
关闭排风	"关闭油烟机的风机","把油烟机的风机关闭"