Схема характеристик световых эффектов для умного дома
action.devices.traits.LightEffects — Этот трейт относится к устройствам, которые могут поддерживать сложные команды управления освещением для изменения состояния, например, циклическое переключение между различными цветами.
АТРИБУТЫ УСТРОЙСТВА
Устройства с этой особенностью могут сообщать следующие атрибуты в рамках операции SYNC . Для получения дополнительной информации об обработке намерений SYNC см. раздел «Выполнение намерений» .
| Атрибуты | Тип | Описание |
|---|---|---|
defaultColorLoopDuration | Целое число | (По умолчанию: Длительность эффекта, запускаемого командой |
defaultSleepDuration | Целое число | (По умолчанию: Длительность действия, запускаемого командой |
defaultWakeDuration | Целое число | (По умолчанию: Длительность действия, запускаемого командой |
supportedEffects | Множество | Необходимый. Список эффектов, поддерживаемых устройством. |
[ item, ... ] | Нить | Подтвержденный эффект. Поддерживаемые значения:
|
Примеры
Устройство, поддерживающее эффект циклической смены цветов.
{
"supportedEffects": [
"colorLoop"
]
}Устройство, поддерживающее эффекты сна/бодрствования.
{
"defaultSleepDuration": 300,
"defaultWakeDuration": 600,
"supportedEffects": [
"sleep",
"wake"
]
}СОСТОЯНИЯ УСТРОЙСТВА
Сущности с этим свойством могут сообщать о следующих состояниях в рамках операции QUERY . Для получения дополнительной информации об обработке намерений QUERY см. раздел «Выполнение намерений» .
| Штаты | Тип | Описание |
|---|---|---|
activeLightEffect | Нить | В данный момент активен световой эффект (если таковой имеется). Один из Поддерживаемые значения:
|
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