Schéma LightEffects Trait pour la maison connectée
action.devices.traits.LightEffects
: cette caractéristique appartient aux appareils pouvant accepter des commandes d'éclairage complexes pour changer d'état, comme la lecture en boucle de différentes couleurs.
Attributs d'appareil
Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC
. Pour en savoir plus sur la gestion des intents SYNC
, consultez la section Traitement des intents.
Attributs | Type | Description |
---|---|---|
defaultColorLoopDuration |
Entier |
(Par défaut : Durée par défaut, en secondes, de l'effet déclenché par la commande |
defaultSleepDuration |
Entier |
(Par défaut : Durée par défaut, en secondes, de l'effet déclenché par la commande |
defaultWakeDuration |
Entier |
(Par défaut : Durée par défaut, en secondes, de l'effet déclenché par la commande |
supportedEffects |
Array |
Obligatoire. Liste des effets compatibles avec l'appareil. |
[item, ...] |
String |
Effet compatible. Valeurs acceptées :
|
Exemples
Appareil compatible avec l'effet de boucle de couleurs
{ "supportedEffects": [ "colorLoop" ] }
Appareil compatible avec les effets de sommeil/réveil
{ "defaultSleepDuration": 300, "defaultWakeDuration": 600, "supportedEffects": [ "sleep", "wake" ] }
Device STATES
Les entités dotées de cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY
. Pour en savoir plus sur la gestion des intents QUERY
, consultez la section Traitement des intents.
États | Type | Description |
---|---|---|
activeLightEffect |
String |
Effet lumineux actuellement actif, le cas échéant. Choix possible : Valeurs acceptées :
|
lightEffectEndUnixTimestampSec |
Entier |
Horodatage Unix indiquant la date à laquelle l'effet doit se terminer s'il se termine individuellement. |
Exemples
Quel est l'impact actuel sur mon appareil ?
{ "activeLightEffect": "colorLoop" }
Quel est l'impact actuel sur mon appareil ?
{ "activeLightEffect": "sleep", "lightEffectEndUnixTimestampSec": 1595286869 }
Aucun effet lumineux actuellement actif.
{}
COMMANDS d'appareil
Les appareils dotés de cette caractéristique peuvent répondre aux commandes suivantes dans le cadre de l'opération EXECUTE
. Pour en savoir plus sur la gestion des intents EXECUTE
, consultez la section Traitement des intents.
action.devices.commands.ColorLoop
Demander à l'appareil de faire défiler une série de couleurs
Cette commande nécessite les attributs suivants :{ "supportedEffects": [ "colorLoop" ] }
Paramètres
Paramètres | Type | Description |
---|---|---|
duration |
Entier |
Durée de la commande de boucle de couleurs, en secondes. |
Exemples
Mettre mes lumières en boucle pendant 60 minutes
{ "command": "action.devices.commands.ColorLoop", "params": { "duration": 3600 } }
action.devices.commands.Sleep
Baissez progressivement la luminosité de l'appareil et, si vous le souhaitez, ajuste la température des couleurs sur une période donnée.
Cette commande nécessite les attributs suivants :{ "supportedEffects": [ "sleep" ] }
Paramètres
Paramètres | Type | Description |
---|---|---|
duration |
Entier |
Durée de la commande "sleep" en secondes. |
Exemples
Mets mes lumières en veille pendant 60 minutes.
{ "command": "action.devices.commands.Sleep", "params": { "duration": 3600 } }
action.devices.commands.StopEffect
Arrête l'effet de lumière actuel.
Paramètres
Paramètres | Type | Description |
---|---|---|
Aucune propriété |
Exemples
Arrête l'effet sur ma lumière.
{ "command": "action.devices.commands.StopEffect", "params": {} }
action.devices.commands.Wake
Augmentez progressivement la luminosité de l'appareil et, si vous le souhaitez, ajuste la température des couleurs sur une période donnée.
Cette commande nécessite les attributs suivants :{ "supportedEffects": [ "wake" ] }
Paramètres
Paramètres | Type | Description |
---|---|---|
duration |
Entier |
Durée de la commande d'activation, en secondes. |
Exemples
Réactive mes lumières pendant 60 minutes.
{ "command": "action.devices.commands.Wake", "params": { "duration": 3600 } }
Émulation d'effets de lumière
Si votre appareil implémente la caractéristique
Brightness
, mais pas la caractéristique LightEffects
, la plate-forme accepte les effets de veille et d'activation émulés, sans code supplémentaire.
La plate-forme émule les effets en envoyant une série d'intents EXECUTE.
Exemples d'énoncés
de-DE
- 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
fr-FR
- Allume doucement les lumières .
- Éteins progressivement les lumières .
hi-IN
- बेडरूम में धीरे-धीरे रोशनी बढ़ाओ
- लाइट को स्लीप मोड में डाल दो
it-IT
- Accendi le luci gradualmente
- Avvia le luci per dormire
ja-JP
- ライト を徐々に明るくなる設定にして
- 照明 を少しずつ暗くして
ko-KR
- 안방 전등 기상 모드 시작해
- 조명 에서 수면 모드 실행
nl-NL
- Dim de lichten langzaam.
- Laat mijn lamp langzaam feller worden.
pt-BR
- 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