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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

{
  "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
  }
}

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

Полный список ошибок и исключений смотрите . ,

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примеры

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

{
  "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
  }
}

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

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