文档中心 > AliGenie开发者平台

设备控制与设备状态查询

更新时间：2019/11/28 访问次数：65272

一、设备控制

1.1 电源类的操作

1.1.1 设备打开

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOn",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"powerstate",
       "value":"on",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应：

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOnResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

异常响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"ErrorResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
        "deviceId":"34234",
         "errorCode":"DEVICE_NOT_SUPPORT_FUNCTION",
         "message":"device not support"
    }
  ｝

1.1.2 关闭设备

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOff",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"powerstate",
       "value":"off",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOffResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.1.3 打开左电源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOn",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftPowerstate",
       "value":"on",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOnResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.1.4 关闭左电源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOff",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftPowerstate",
       "value":"off",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOffResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.1.5 打开右电源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOn",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightPowerstate",
       "value":"on",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOnResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.1.6 关闭右电源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOff",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightPowerstate",
       "value":"off",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"TurnOffResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.2 频道类的切换

1.2.1 按照频道名称切换

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SelectChannel",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceType":"XXX",
       "deviceId":"34234",
       "attribute":"channel",
       "value":"浙江卫视",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SelectChannelResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

异常响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"ErrorResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
        "deviceId":"34234",
        "errorCode":"DEVICE_NOT_SUPPORT_FUNCTION",
        "message":"device not support"
    }
  ｝

1.2.2 按照频道号切台

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SelectChannel",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceType":"XXX",
       "deviceId":"34234",
       "attribute":"number",
       "value":"1",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SelectChannelResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.3 声音类的控制

1.3.1 按照步长控制音量(加大或减少,默认步长为1)

调大声音

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpVolume",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"volumeStep",
       "value":"1",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpVolumeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

调小声音

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownVolume",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"volumeStep",
       "value":"1",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownVolumeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.3.2 直接设置音量达到指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetVolume",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"volume",
       "value":"20",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetVolumeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.3.3 声音设置成最值(最大、最小)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetVolume",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"volume",
       "value":"max",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetVolumeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝
最值 说明
max 对应最大值
min 对应最小值

1.3.4 静音设置

1
2
3
4
5
6
7
8
9
10
11
12
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetMute",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "accessToken":"access token",
      "deviceId":"34234" 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetMuteResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.3.5 取消静音设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CancelMute",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234" ,
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CancelMuteResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4 播放类的控制

1.4.1 播放

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Play",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"PlayResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4.2 暂停

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Pause",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"PauseResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4.3 继续播放

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Continue",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"ContinueResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4.4 下一首或者下一台

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Next",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"NextResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4.5 上一首或者上一台

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Previous",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"PreviousResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.4.6 快进播放

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"FastForward",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"forward",  
       "value":"30",            // 快进到多少分钟
       "extensions":{
          "extension1":"",
          "extension2":""
      }
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"FastForwardResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.5. 亮度的控制

1.5.1 亮度设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetBrightness",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"brightness",  
       "value":"30",
       "extensions":{
          "extension1":"",
          "extension2":""
      }           
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetBrightnessResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.5.2 亮度调成最值(最大、最小)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetBrightness",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"brightness",  
       "value":"max",
       "extensions":{
          "extension1":"",
          "extension2":""
      }           
    }
  ｝
最值 说明
max 对应最大值
min 对应最小值

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetBrightnessResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.5.3 步长设置亮度(默认步长 25)

调亮

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpBrightness",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"brightnessStep",  
       "value":"25",
       "extensions":{
          "extension1":"",
          "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpBrightnessResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

调暗

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownBrightness",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"brightnessStep",  
       "value":"10" ,
       "extensions":{
          "extension1":"",
          "extension2":""
      }           
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownBrightnessResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6. 温度的控制

1.6.1 温度设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"temperature",  
       "value":"27",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6.2 温度设置最值(最大、最小)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"temperature",  
       "value":"max",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝
最值 说明
max 对应最大值
min 对应最小值

1.6.3 步长设置温度（默认步长为1）

调高温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"temperatureStep",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

调低温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"temperatureStep",  
       "value":"10",
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6.4 左温度设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLeftTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftTargetTemperature",  
       "value":"27",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLeftTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6.5 右温度设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetRightTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightTargetTemperature",  
       "value":"27",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetRightTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6.6 步长设置左温度（默认步长为1）

调高左温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpLeftTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftTargetTemperatureStep",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpLeftTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

调低左温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownLeftTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftTargetTemperatureStep",  
       "value":"10",
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownLeftTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.6.7 步长设置右温度（默认步长为1）

调高右温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpRightTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightTargetTemperatureStep",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpRightTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

调低右温度

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownRightTargetTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightTargetTemperatureStep",  
       "value":"10",
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
  ｝

响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownRightTargetTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.7 湿度的控制

1.7.1 湿度设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetHumidity",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"humidity",  
       "value":"27",
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetHumidityResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.7.2 湿度设置最值(最大、最小)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetHumidity",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"humidity",  
       "value":"max",
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetHumidityResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝
最值 说明
max 对应最大值
min 对应最小值

1.7.3 湿度调整（按照默认步长 1 调整）

湿度增加

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpHumidity",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"humidityStep",  
       "value":"1",
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpHumidityResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

湿度减少

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownHumidity",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"humidityStep",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }           
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownHumidityResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.8 风速的控制

1.8.1 风速的控制

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetWindSpeed",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"windspeed",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
  ｝

风扇类的风速对应值

风速值 说明
1 对应风速 1档
2 对应风速 2档
3 对应风速 3档
4 对应风速 4档

空调类的风速对应值

风速值 说明
auto 自动风
low 低风
medium 中风
high 高风

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetWindSpeedResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.8.2 风速设置最值(最大、最小)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetWindSpeed",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"windspeed",  
       "value":"max" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
  ｝
最值 说明
max 对应最大值
min 对应最小值

1.8.3 风速的步长调整（默认步长为1）

调大风速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpWindSpeed",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"windspeedStep",  
       "value":"1",
       "extensions":{
           "extension1":"",
           "extension2":""
      }             
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpWindSpeedResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

调小风速

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownWindSpeed",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"windspeedStep",  
       "value":"1" ,
       "extensions":{
           "extension1":"",
           "extension2":""
      }            
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownWindSpeedResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.9 风向的控制

1.9.1 开启摆风

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"OpenSwing",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"OpenSwingResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
  ｝

1.9.2 关闭摆风

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CloseSwing",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

1.9.3 按照角度摆风

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"XXX",            
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"angle",
       "value":"30",           // 度为单位
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

按照角度的摆风name 列表取值以及属性如下：

name名称 参数说明 属性 属性值枚举
OpenUpAndDownSwing 开启上下X度摆动 angle 30,60(默认60 度) , 90
OpenUpSwing 开启向上X度摆动 angle 30,60(默认60 度) , 90
OpenDownSwing 开启向下X度摆动 angle 30,60(默认60 度) , 90
OpenLeftAndRightSwing 开启左右X度摆动 angle 30,60(默认60 度) , 90
OpenLeftSwing 开启向左X度摆动 angle 30,60(默认60 度) , 90
OpenRightSwing 开启向右X度摆动 angle 30,60(默认60 度) , 90
OpenForwardAndBackSwing 开启前后X度摆动 angle 30,60(默认60 度) , 90
OpenForwardSwing 开启向前X度摆动 angle 30,60(默认60 度) , 90
OpenBackSwing 开启向后X度摆动 angle 30,60(默认60 度) , 90

1.10 模式的控制

1.10.1 模式的设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetMode",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"mode",
       "value":"auto",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetModeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.10.2 工作模式左的设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLeftMode",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"leftMode",
       "value":"auto",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLeftModeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.10.3 工作模式右的设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetRightMode",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"rightMode",
       "value":"auto",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetRightModeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

mode取值表

模式名称 参数说明
auto 自动模式
cold 制冷模式
heat 制热模式
ventilate 通风模式
airsupply 送风模式
dehumidification 除湿模式
reading 阅读模式
movie 影院模式
sleep 睡眠模式
live 生活模式
manual 手动模式
silent 静音模式
energy 省电模式
normalWind 正常风模式
natureWind 自然风模式
sleepWind 睡眠风模式
quietWind 静音风模式
comfortableWind 舒适风模式
babyWind 宝宝风模式
cottons 棉织物模式
synthetics 化纤模式
wool 羊毛模式
hygiene 除菌模式
drumClean 筒清洁模式
silk 丝绸模式
holiday 假日模式
smart 智能模式
music 音乐模式
zeroGravity 零重力模式
snoreStop 止鼾模式
diffuse 多人模式
swing 摇摆模式
power 强效模式
common 普通模式
work 工作模式
cool 速冷模式
frozen 速冻模式
microDry 微干模式
fullDry 全干模式
superDry 超干模式
summer 夏季模式
winter 冬季模式
standard 标准模式
fastWash 快洗模式
babyWash 婴童洗模式
singleDehydration 单脱水模式
energySaveWash 节能洗模式
illumination 照明模式
childLock 童锁模式
hotWind 热风模式

1.11 颜色的设置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetColor",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"color",   
       "value":"Red",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetColorResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

颜色对应表参考本页中设备状态查询的颜色对应表

1.12 XX功能的开关

1.12.1 打开XX功能

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"OpenFunction",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"function",   
       "value":"XXX",       // 功能值如下功能属性值表所示
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"OpenFunctionResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.12.2 关闭XX功能

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CloseFunction",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"function",   
       "value":"XXX",   // 功能值如下功能属性值表所示
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

1.13 取消类操作

1.13.1 取消操作

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"Cancel",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX", 
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CancelResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.13.2 取消模式

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CancelMode",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"mode",   
       "value":"XXX",   // 参考模式取值表
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"CancelModeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

模式表参考本页章节10.1 中的mode取值表

1.14 色温控制

1.14.1 色温设置指定值

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetColorTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"colorTemperature",  
       "value":"27",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetColorTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

1.14.2 步长设置色温（默认步长为100）

色温调冷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustUpColorTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"colorTemperatureStep",   
       "value":"100", 
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

色温调暖

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"AdjustDownColorTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"colorTemperatureStep",   
       "value":"100", 
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

1.15 设置本地食谱

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
｛
    "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLocalRecipe",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "attribute":"localRecipe",  
       "value":"steamedBun",
       "extensions":{
         "extension1":"",
         "extension2":""
      }            
    }
  ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Control",
      "name":"SetLocalRecipeResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
      "deviceId":"34234"
    }
 ｝

mode取值表

模式名称 参数说明
清洗 clean
保温 Insulation
蒸水蛋 steamedEggs
清蒸鱼 steamedFish
蒸馒头/包子 steamedBun
低温蒸 LowTempSteaming
元气蒸 vitalitySteam
慢蒸 slowSteaming
健康蒸 healthSteaming
消毒 disinfection
健康炸 heathyFired
有预热烘烤 preheatedBaking
无预热烘烤 nonepreheatedBaking
发酵 ferment
有预热蒸汽烘烤 preheatingSteamBaking
无预热蒸汽烘烤 nonepreheatingSteamBaking
炖 stew
蒸冷冻食品 frozenFoodSteamed
蒸时蔬 steamedVegetables
蒸鸡 steamedChicken
宝宝薯丁 babyPotato
披萨 pizza
叉烧 charSiew
煎鱼 fishFiring
炸虾 friedShrimp
法棍面包 frenchBaguette
水浴奶酪蛋糕 cheeseCake
杀菌 sterilization
全烤 fullRoast
高温蒸 highTemSteam
上烤 upRoast
下烤 downRoast
蒸烤 steamBaking
纯蒸 pureSteam
嫩烤 lightBaking
烘焙 baking
预热 warmup

二、设备状态查询

2.1 所有属性的查询

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"Query",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token",
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
  ｝

正常响应：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
｛
     "properties":[
       {
       "name":"powerstate",        // 电源状态
       "value":"on"
       },
        {
        "name":"color",
        "value":"Red"
       },
        {
        "name":"temperature",
        "value":"27"         //标准单位 摄氏度
       },{
         "name":"humidity",
         "value":"20"
       },{
         "name":"windspeed",
         "value":"2"   //  1对应 1档, 2对应2档， 3 对应 3档
       },{
         "name":"humidity",
         "value":"23"
      },{
         "name":"pm2.5",
         "value":"20"
     } ,{
         "name":"direction",  // 摆向方向
         "value":"left"
     } ,{
         "name":"angle",  // 角度
         "value":"60"
     }     
    ],
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "deviceId":"34234"
    }
 ｝

注： Query 请求电源状态(powerstate)必须返回，其他属性的返回与否视设备自身情况而定

2.2 单个属性的查询(例：温度属性)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryTemperature",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
     "properties":[
        {
        "name":"temperature",
        "value":"27"
       }
    ],
   "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryTemperatureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "deviceId":"34234"
    }
 ｝

2.3 血压属性的查询(需返回舒张压和收缩压)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryBloodPressure",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
｛
     "properties":[
        {
        "name":"systolicPressure",
        "value":"80"
       } ,
       {
        "name":"diastolicPressure",
        "value":"120"
       }
    ],
   "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryBloodPressureResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "deviceId":"34234"
    }
 ｝

2.4 血糖属性的查询

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryBloodGlucose",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
     "properties":[
        {
        "name":"bloodGlucose",
        "value":"80"
       }
    ],
   "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryBloodGlucoseResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "deviceId":"34234"
    }
 ｝

2.5 心率/脉搏属性的查询

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryHeartRate",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "accessToken":"access token"
       "deviceId":"34234",
       "deviceType":"XXX",
       "extensions":{
           "extension1":"",
           "extension2":""
      } 
    }
 ｝

正常响应

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
｛
     "properties":[
        {
        "name":"heartRate",
        "value":"80"
       }
    ],
   "header":{
      "namespace":"AliGenie.Iot.Device.Query",
      "name":"QueryHeartRateResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
       "deviceId":"34234"
    }
 ｝

目前支持的查询属性如下：

属性 说明 属性值参考 AliGenie 所支持的对应单位
powerstate 电源状态 on(打开)，off(关闭) 无
leftPowerstate 左电源状态 on(打开)，off(关闭) 无
rightPowerstate 右电源状态 on(打开)，off(关闭) 无
color 颜色 参考颜色对应表 无
temperature 温度 数值 摄氏度
leftTemperature 左温度 数值 摄氏度
rightTemperature 右温度 数值 摄氏度
windspeed 风速 数值 档
brightness 亮度 数值 无
fog 雾量 数值 无
humidity 湿度 数值 无
pm2.5 pm2.5 数值 无
channel 电视频道 标准的频道名称 无
number 电视频道号 数值 无
direction 方向 取值left,right,forward,back,up,down 无
angle 角度 数值 度
anion 负离子功能 on(打开)，off(关闭) 无
effluent 出水功能 on(打开)，off(关闭) 无
mode 模式 参考mode 设置中的mode取值表 无
lefttime 剩余时间 数值 秒
remotestatus 设备远程状态 on(打开)，off(关闭) 无
onlinestate 设备在线状态 online(在线)，offline(离线) 无
colorTemperature 色温 数值 无
RO 滤水芯寿命RO值 数值 无
PCB 滤水芯寿命PCB值 数值 无
TDS 水质TDS值 数值 无
systolicPressure 收缩压 数值 无
diastolicPressure 舒张压 数值 无
bloodGlucose 血糖 数值 无
heartRate 心率 数值 无
workstatus 工作状态 stop(停止),pause(暂停),standby(待机),done(完成),error(错误),wifisetting(WIFI设置),powerOff(关机),working(正在工作) 无

支持控制的颜色对应表

AliGenie支持控制的颜色 对应中文描述
Red 红色
Yellow 黄色
Blue 蓝色
Green 绿色
White 白色
Black 黑色
Cyan 青色
Purple 紫色
Orange 橙色

支持查询的颜色对应表（上述支持控制的颜色对应表同样支持，这里不再列出）

AliGenie支持查询的颜色 对应中文描述
Pink 粉红
Violet 紫罗兰
Magenta 洋红
Indigo 靛青
SlateBlue 蓝灰色
DarkBlue 深蓝色
SkyBlue 天蓝色
DarkCyan 深青色
Beige 浅褐色
Brown 棕色

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

三、响应信息

3.1 错误响应

1
2
3
4
5
6
7
8
9
10
11
12
13
｛
  "header":{
      "namespace":"AliGenie.Iot.Device.XXXX",
      "name":"ErrorResponse",
      "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
      "payLoadVersion":1
   },
   "payload":{
        "deviceId":"34234",
        "errorCode":"DEVICE_NOT_SUPPORT_FUNCTION",
        "message":"device not support"
    }
 ｝

错误响应header协议中name为ErrorResponse

错误响应payload 协议如下

参数 说明
deviceId 设备ID
errorCode 错误码，详见 3.2章节
message 错误信息

3.2 异常响应的信息列表

错误码 errorCode 错误码说明 对应message
INVALIDATE_CONTROL_ORDER 控制指令不正确 invalidate control order
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

注意事项：
1.请求响应response header 的Content-Type 头部需要是 application/json 格式
2. 天猫精灵云端请求厂商服务接口目前设置的超时时间为2秒，如果出现服务不可用的情况，请接入方进行优化
3. messageId 是不重复的消息id
4. 通用协议的请求都是POST请求
5.app 上显示产品icon有问题时请注意icon链接是https以及大小是160*160

FAQ

关于此文档暂时还没有FAQ
有用(0) 我要提问
返回
顶部
阿里巴巴集团 | 淘宝网 | 天猫 | 聚划算 | 全球速卖通 | 阿里巴巴国际交易市场 | 1688 | 阿里妈妈 | 阿里旅行·去啊 | 阿里云计算 | YunOS | 阿里通信 | 万网 | 高德 | 优视 | 友盟 | 酷盘 | 虾米 | 天天动听 | 来往 | 钉钉 | 11Main | 支付宝
关于淘宝 合作伙伴 营销中心 联系客服 开放平台 诚征英才 联系我们 网站地图 法律声明 © 2016 Taobao.com 版权所有
网络文化经营许可证：文网文[2010]040号 | 增值电信业务经营许可证：浙B2-20080224-1 | 信息网络传播视听节目许可证：1109364号