Руководство по сценарию умного дома

action.devices.types.SCENE — в случае сцен тип сопоставляется 1:1 с чертой, поскольку сцены не объединяются с другими чертами для формирования составных устройств. Сцены всегда должны иметь имена, предоставляемые пользователем. Каждая сцена представляет собой собственное виртуальное устройство со своими именами.

Этот тип указывает, что устройство получает значок сцены и некоторые связанные с ним синонимы и псевдонимы.

См. черту Scene для получения дополнительной информации.

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

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

Требуемые черты

Эти свойства и команды являются обязательными, если они применимы к вашему устройству. Если ваше устройство не поддерживает эти черты, введите код ошибки functionNotSupported в ответе на запрос или выполнение. Дополнительные сведения см. в разделе Ошибки и исключения .

Требования к качеству

  • Задержка: должна быть меньше или равна 3000 мс .
  • Надежность: должна быть больше или равна 97% .

Пример устройства: простая сцена

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

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

Запрос
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Ответ
{
  "requestId": "6894439706274654512",
  "payload": {
    "agentUserId": "user123",
    "devices": [
      {
        "id": "123",
        "type": "action.devices.types.SCENE",
        "traits": [
          "action.devices.traits.Scene"
        ],
        "name": {
          "name": "Simple scene"
        },
        "willReportState": true,
        "attributes": {
          "sceneReversible": true
        },
        "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
      }
    }
  }
}

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

активировать сцену

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

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

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

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