Схема признаков сцены умного дома

action.devices.traits.Scene — этот трейт используется для реализации виртуальных устройств вместе с типом устройства SCENE.

Дополнительные сведения см. в руководстве по типам сцен .

Например, если устройство позволяет пользователям настраивать группировку команд в одно касание — настройку освещения на определенные цвета, последовательность различных функций безопасности или любую другую комбинацию действий — эта конфигурация может отображаться через SYNC как именованная сцена , а Помощник сделает эти сцены доступными для пользователей с помощью простой грамматики активации:

  • Запустите режим вечеринки.
  • Активировать полуночную сцену.

Как виртуальные объекты, сцены могут быть размещены в комнатах (если применимо) для устранения неоднозначности:

  • Начните вечеринку на кухне.
  • Активируйте режим ночного освещения в спальнях.

Одно из различий между сценами и физическими целями заключается в том, что Помощник автоматически применяет множественные эффекты к командам сцены, позволяя пользователям запускать сцены для нескольких партнеров. Например, если у пользователя есть сцена «Режим вечеринки» для двух разных партнеров, один для безопасности, а другой для освещения, Активация режима вечеринки активирует оба.

Сцены будут хорошо взаимодействовать с предстоящими личными действиями для пользовательской грамматики (например, Активировать режим вечеринки -> Давайте начнем вечеринку! ).

Сцены всегда должны иметь имена, предоставляемые пользователем, а не имена по умолчанию «Сцена BobCo». Каждая сцена представляет собой собственное виртуальное устройство со своими именами. Пользовательские имена могут поступать из SYNC .

АТРИБУТЫ устройства

Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
sceneReversible логический

(По умолчанию: false )

Указывает, что эту сцену можно отменить. Этот атрибут актуален только для сцен, которые изменяют состояние и запоминают предыдущее состояние. Устройство поддерживает команду ActivateScene с параметром deactivate , равным true.

Примеры

Устройство, поддерживающее обратимую сцену.

{
  "sceneReversible": true
}

СОСТОЯНИЯ устройства

Никто.

КОМАНДЫ устройства

Устройства с этой чертой могут отвечать на следующие команды как часть операции EXECUTE . Дополнительные сведения об обработке намерений EXECUTE см. в разделе Выполнение намерений .

action.devices.commands.ActivateScene

Активировать или деактивировать сцену.

Параметры

Параметры Тип Описание
deactivate логический

Необходимый.

True, чтобы отменить сцену, если она обратима, false, чтобы активировать сцену.

Примеры

Активируйте сцену по имени.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": false
  }
}

Деактивировать сцену по имени.

{
  "command": "action.devices.commands.ActivateScene",
  "params": {
    "deactivate": true
  }
}

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

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