查询红外设备标准指令集

更新时间:2023-07-06 08:27:50下载pdf

本文介绍查询红外设备标准指令集的 API。

接口描述

只支持自动化和一键执行支持红外设备标准指令集。

接口地址

GET: /v2.0/iot-03/automations/infrared/devices/{device_id}/specifications

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID

返回参数

参数名类型说明
resultInfraredSupportKeyRes返回结果

result 说明

参数名类型说明
is_acBoolean是否是空调。true:是;false:不是。
functionsList红外指令集
mode_rangeList模式取值范围。此字段只有当设备类型为红外空调(is_ac = true)的时候才有值,否则为空。

functions 说明

参数名类型说明
codeString指令 Code
nameString指令名称
valueString指令值

mode_range 说明

参数名类型说明
modeInteger空调支持的模式:
  • 0:制冷
  • 1:制热
  • 2:自动
  • 3:送风
  • 4:除湿
不同的品牌或者型号的空调支持的模式可能会有差异。
mode_nameString模式名称
temperature_rangeList当前模式下的温度取值范围。空调设备比较特殊,当在不同的模式下,其温度支持的范围可能会有所不同。此取值范围同样受限于空调的品牌或型号。例如:当模式为制冷的时候,支持的温度范围为1622℃;而当模式为制热的时候,支持的温度范围为2030℃。

temperature_range 说明

参数名类型说明
temperatureInteger温度
temperature_nameString温度名称
fan_rangeSet当前温度下的风速取值范围。同模式和温度的关系类似,当在不同的温度下,支持的风速也会有所不同。此取值范围同样受限于空调的品牌或型号。例如:在制冷模式下,当温度为16℃的时候,只支持低风速;而当温度为17℃的时候,支持低风速和中风速。

fan_range 说明

参数名类型说明
fanInteger风速:
  • 0:自动风
  • 1:低风速
  • 2:中风速
  • 3:高风速
不同的品牌型号支持的模式可能会有差异。
fan_nameString风速名称

请求示例

GET: /v2.0/iot-03/automations/infrared/devices/6c819d650100a35f9e****/specifications

返回示例

{
    "result": {
        "functions": [
            {
                "code": "F",
                "name": "风速",
                "value": "F"
            },
            {
                "code": "M",
                "name": "模式",
                "value": "M"
            },
            {
                "code": "PowerOff",
                "name": "关闭",
                "value": "PowerOff"
            },
            {
                "code": "PowerOn",
                "name": "开启",
                "value": "PowerOn"
            },
            {
                "code": "T",
                "name": "温度",
                "value": "T"
            }
        ],
        "is_ac": true,
        "mode_range": [
            {
                "mode": 0,
                "temperature_range": [
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度16℃",
                        "temperature": 16
                    },
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度17℃",
                        "temperature": 17
                    }
                ],
                "mode_name": "模式制冷"
            },
            {
                "mode": 1,
                "temperature_range": [
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速高",
                                "fan": 3
                            },
                            {
                                "fan_name": "风速自动",
                                "fan": 0
                            },
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度16℃",
                        "temperature": 16
                    },
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速高",
                                "fan": 3
                            },
                            {
                                "fan_name": "风速自动",
                                "fan": 0
                            },
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度17℃",
                        "temperature": 17
                    }
                ],
                "mode_name": "模式制热"
            },
            {
                "mode": 2,
                "temperature_range": [
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速高",
                                "fan": 3
                            },
                            {
                                "fan_name": "风速自动",
                                "fan": 0
                            },
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ]
                    }
                ],
                "mode_name": "模式自动"
            },
            {
                "mode": 3,
                "temperature_range": [
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速高",
                                "fan": 3
                            },
                            {
                                "fan_name": "风速自动",
                                "fan": 0
                            },
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度16℃",
                        "temperature": 16
                    },
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速高",
                                "fan": 3
                            },
                            {
                                "fan_name": "风速自动",
                                "fan": 0
                            },
                            {
                                "fan_name": "风速中",
                                "fan": 2
                            },
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度17℃",
                        "temperature": 17
                    }
                ],
                "mode_name": "模式送风"
            },
            {
                "mode": 4,
                "temperature_range": [
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度16℃",
                        "temperature": 16
                    },
                    {
                        "fan_range": [
                            {
                                "fan_name": "风速低",
                                "fan": 1
                            }
                        ],
                        "temperature_name": "温度17℃",
                        "temperature": 17
                    }
                ],
                "mode_name": "模式除湿"
            }
        ]
    },
    "t": 1635391392286,
    "success": true
}

错误码

参考 错误码