Схема характеристик световых эффектов для умного дома

action.devices.traits.LightEffects — Этот трейт относится к устройствам, которые могут поддерживать сложные команды управления освещением для изменения состояния, например, циклическое переключение между различными цветами.

АТРИБУТЫ УСТРОЙСТВА

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

Атрибуты Тип Описание
defaultColorLoopDuration Целое число

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

Длительность эффекта, запускаемого командой action.devices.commands.ColorLoop , по умолчанию указывается в секундах.

defaultSleepDuration Целое число

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

Длительность действия, запускаемого командой action.devices.commands.Sleep , по умолчанию, в секундах.

defaultWakeDuration Целое число

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

Длительность действия, запускаемого командой action.devices.commands.Wake , по умолчанию, в секундах.

supportedEffects Множество

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

Список эффектов, поддерживаемых устройством.

[ item, ... ] Нить

Подтвержденный эффект.

Поддерживаемые значения:

colorLoop
Циклически переключается между различными цветами в случайном порядке.
sleep
Постепенно снижает яркость и, при необходимости, регулирует цветовую температуру в течение определенного периода времени.
wake
Постепенно увеличивает яркость и, при необходимости, регулирует цветовую температуру в течение определенного периода времени.

Примеры

Устройство, поддерживающее эффект циклической смены цветов.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Устройство, поддерживающее эффекты сна/бодрствования.

{
  "defaultSleepDuration": 300,
  "defaultWakeDuration": 600,
  "supportedEffects": [
    "sleep",
    "wake"
  ]
}

СОСТОЯНИЯ УСТРОЙСТВА

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

Штаты Тип Описание
activeLightEffect Нить

В данный момент активен световой эффект (если таковой имеется). Один из supportedEffects .

Поддерживаемые значения:

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Целое число

Временная метка Unix, указывающая на ожидаемое завершение эффекта, если эффект завершается самостоятельно.

Примеры

Какое влияние это оказывает на моё устройство?

{
  "activeLightEffect": "colorLoop"
}

Какое влияние это оказывает на моё устройство?

{
  "activeLightEffect": "sleep",
  "lightEffectEndUnixTimestampSec": 1595286869
}

В данный момент световой эффект не активен.

{}

КОМАНДЫ УСТРОЙСТВА

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

action.devices.commands.ColorLoop

Попросите устройство переключаться между набором цветов.

Для выполнения этой команды требуются следующие атрибуты:
{
  "supportedEffects": [
    "colorLoop"
  ]
}

Параметры

Параметры Тип Описание
duration Целое число

Длительность выполнения команды циклического изменения цвета, в секундах.

Примеры

Включите циклическую смену цветов подсветки на 60 минут.

{
  "command": "action.devices.commands.ColorLoop",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.Sleep

Постепенно уменьшайте яркость устройства и, при необходимости, регулируйте цветовую температуру в течение определенного времени.

Для выполнения этой команды требуются следующие атрибуты:
{
  "supportedEffects": [
    "sleep"
  ]
}

Параметры

Параметры Тип Описание
duration Целое число

Длительность команды перехода в спящий режим, в секундах, в диапазоне от 300 до 3600.

Примеры

Перевести мои лампы в спящий режим на 60 минут.

{
  "command": "action.devices.commands.Sleep",
  "params": {
    "duration": 3600
  }
}

action.devices.commands.StopEffect

Остановить текущий световой эффект.

Параметры

Параметры Тип Описание

Нет объектов недвижимости

Примеры

Прекратите воздействие на мой светильник.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

Функция постепенного увеличения яркости устройства и, при необходимости, регулировки цветовой температуры в течение определенного времени.

Для выполнения этой команды требуются следующие атрибуты:
{
  "supportedEffects": [
    "wake"
  ]
}

Параметры

Параметры Тип Описание
duration Целое число

Длительность команды пробуждения, в секундах, в диапазоне от 300 до 3600.

Примеры

Пусть мои лампы будут гореть 60 минут.

{
  "command": "action.devices.commands.Wake",
  "params": {
    "duration": 3600
  }
}

Эмуляция световых эффектов

Если ваше устройство реализует трейт Brightness , но не трейт LightEffects , платформа поддерживает эмуляцию эффектов «сна» и «пробуждения» без необходимости в дополнительном коде. Платформа эмулирует эффекты, отправляя серию интентов EXECUTE.

Примеры высказываний

де-ДЕ

  • Den Aufwacheffekt der Lampen starten.
  • Einschlafmodus im Schlafzimmer aktivieren.
  • synchronisiere meine Geräte

en-US

  • Begin the sleep effect on my lights .
  • I want you to start wake effect on the lights

es-ES

  • pon la luz de despertarse lentamente durante 45 minutos
  • pon las luces de dormir

фр-ФР

  • Allume doucement les lumières .
  • Éteins progressivement les lumières .

хай-ИН

  • बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
  • लाइट को स्लीप मोड में डाल दो

ИТ-ИТ

  • Accendi le luci gradualmente
  • Avvia le luci per dormire

ja-JP

  • ライトを徐々に明るくなる設定にして
  • 照明を少しずつ暗くして

ко-КР

  • 안방 전등 기상 모드 시작해
  • 조명 에서 수면 모드 실행

nl-NL

  • Dim de lichten langzaam.
  • Laat mijn lamp langzaam feller worden.

пт-БР

  • Acenda lentamente as luzes do quarto por 1 hora .
  • Ativa as luzes de despertar no quarto dos miudos .
  • Iniciar o modo dormir por 1 hora nas luzes do quarto .
  • Liga a função adormecer das luzes .

sv-SE

  • Starta insomningsläge på lamporna
  • Tänd lamporna långsamt

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

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