Руководство по выбору умного домашнего обогревателя

action.devices.types.HEATER - Обогреватели похожи на термостаты, но не поддерживают охлаждение и могут не поддерживать установку целевых температур.

Этот тип указывает на то, что устройству присваивается значок «Обогреватель», а также некоторые связанные с ним синонимы и псевдонимы.

Возможности устройства

Для получения подробной информации о реализации, такой как атрибуты и состояния, которые должна поддерживать ваша служба, а также о том, как формировать ответы EXECUTE и QUERY, обратитесь к соответствующей документации по трейту.

Необходимые характеристики

These traits and commands are required, if applicable to your device. If your device does not support these traits, enter the error code of functionNotSupported in a QUERY or EXECUTE response. See Errors and exceptions for more info.

Эти характеристики рекомендуются, если они применимы к вашему устройству. Однако вы можете свободно комбинировать все доступные характеристики, чтобы наилучшим образом соответствовать функциональности вашего существующего продукта.

Пример устройства: Простой обогреватель

This section contains example intent payloads representing a common "Heater" based on the device type and traits above. If you add or remove traits in your implementation, modify your responses accordingly to reflect those changes.

Пример ответа SYNC

Запрос 
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Ответ 
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.HEATER",
        "traits": [
          "action.devices.traits.FanSpeed",
          "action.devices.traits.TemperatureSetting"
        ],
        "name": {
          "name": "Simple heater"
        },
        "willReportState": true,
        "attributes": {
          "availableFanSpeeds": {
            "speeds": [
              {
                "speed_name": "low_key",
                "speed_values": [
                  {
                    "speed_synonym": [
                      "Low",
                      "Slow"
                    ],
                    "lang": "en"
                  }
                ]
              },
              {
                "speed_name": "high_key",
                "speed_values": [
                  {
                    "speed_synonym": [
                      "High"
                    ],
                    "lang": "en"
                  }
                ]
              }
            ],
            "ordered": true
          },
          "availableThermostatModes": [
            "off",
            "heat",
            "fan-only",
            "on"
          ],
          "thermostatTemperatureUnit": "C"
        },
        "deviceInfo": {
          "manufacturer": "smart-home-inc",
          "model": "hs1234",
          "hwVersion": "3.2",
          "swVersion": "11.4"
        }
      }
    ]
  }
}

Пример ответа на запрос

Запрос 
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Ответ 
{
  "requestId": "6894439706274654514",
  "payload": {
    "devices": {
      "123": {
        "status": "SUCCESS",
        "online": true,
        "currentFanSpeedSetting": "low_key",
        "thermostatMode": "heat",
        "thermostatTemperatureSetpoint": 30,
        "thermostatTemperatureAmbient": 25
      }
    }
  }
}

Примеры команд EXECUTE

SetFanSpeed

Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.FanSpeed .

Запрос 
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.SetFanSpeed",
                "params": {
                  "fanSpeed": "high_key"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Ответ 
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "currentFanSpeedSetting": "high_key"
        }
      }
    ]
  }
}

ТермостатУстановленная температура

Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.TemperatureSetting .

Запрос 
{
  "requestId": "6894439706274654518",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ThermostatTemperatureSetpoint",
                "params": {
                  "thermostatTemperatureSetpoint": 28
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Ответ 
{
  "requestId": "6894439706274654518",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "thermostatMode": "heat",
          "thermostatTemperatureSetpoint": 28,
          "thermostatTemperatureAmbient": 25
        }
      }
    ]
  }
}

Режим установки термостата

Дополнительные сведения о параметрах команды см. в справочнике action.devices.traits.TemperatureSetting .

Запрос 
{
  "requestId": "6894439706274654520",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.ThermostatSetMode",
                "params": {
                  "thermostatMode": "heat"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Ответ 
{
  "requestId": "6894439706274654520",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "thermostatMode": "heat",
          "thermostatTemperatureSetpoint": 30,
          "thermostatTemperatureAmbient": 25
        }
      }
    ]
  }
}

ОШИБКИ устройства

См. полный список ошибок и исключений .