Schéma Trait pour les effets de lumière pour la maison connectée

action.devices.traits.LightEffects : cette caractéristique appartient aux appareils pouvant accepter des commandes d'éclairage complexes afin de changer d'état, par exemple pour lire en boucle différentes couleurs.

Appareil : ATTRIBUTES

Les appareils associés à 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 page Traitement des intents.

Attributs	Type	Description
defaultColorLoopDuration	Entier	(Par défaut : 1800) Durée par défaut, en secondes, de l'effet déclenché par la commande action.devices.commands.ColorLoop.
defaultSleepDuration	Entier	(Par défaut : 1800) Durée par défaut, en secondes, de l'effet déclenché par la commande action.devices.commands.Sleep.
defaultWakeDuration	Entier	(Par défaut : 1800) Durée par défaut, en secondes, de l'effet déclenché par la commande action.devices.commands.Wake.
supportedEffects	Array	Obligatoire. Liste des effets acceptés par l'appareil.
[item, ...]	Chaîne	Effet compatible. Valeurs acceptées : colorLoop Boucle parmi différentes couleurs de manière aléatoire. sleep Diminue progressivement la luminosité et, éventuellement, ajuste la température des couleurs au fil du temps. wake Elle augmente progressivement la luminosité et, éventuellement, ajuste la température des couleurs au fil du temps.

Exemples

Appareil compatible avec les effets de boucle de couleur.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Appareil compatible avec les effets du sommeil.

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

Appareil : STATES

Les entités présentant 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 page Traitement des intents.

États	Type	Description
activeLightEffect	Chaîne	Effet de lumière actif, le cas échéant. Une des valeurs supportedEffects. Valeurs acceptées : colorLoop sleep wake
lightEffectEndUnixTimestampSec	Entier	Horodatage Unix quand l'effet est censé se terminer, s'il se termine tout seul.

Exemples

Quel est l'effet actuel sur mon appareil ?

{
  "activeLightEffect": "colorLoop"
}

Quel est l'effet actuel sur mon appareil ?

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

Aucun effet de lumière actif actuellement.

{}

Appareil COMMANDS

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 page Traitement des intents.

action.devices.commands.ColorLoop

Demandez à l'appareil de parcourir 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 couleur, en secondes.

Exemples

Je colorie mes lumières pendant 60 minutes.

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

action.devices.commands.Sleep

Diminuez progressivement la luminosité de l'appareil et ajustez éventuellement la température des couleurs au fil du temps.

Cette commande nécessite les attributs suivants :

{
  "supportedEffects": [
    "sleep"
  ]
}

Paramètres

Paramètres	Type	Description
duration	Entier	Durée de la commande de mise en veille, en secondes.

Exemples

Règle la lumière sur mon sommeil pendant 60 minutes.

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

action.devices.commands.StopEffect

Arrêter 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

Augmenter progressivement la luminosité de l'appareil et, si vous le souhaitez, ajuster la température des couleurs au fil du temps

Cette commande nécessite les attributs suivants :

{
  "supportedEffects": [
    "wake"
  ]
}

Paramètres

Paramètres	Type	Description
duration	Entier	Durée de la commande "Wake" (en secondes).

Exemples

Règle la lumière sur 60 minutes.

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

Émulation d'effets lumineux

Si votre appareil implémente la caractéristique Brightness, mais pas la caractéristique LightEffects, la plate-forme accepte les effets d'émulation "sommeil" et "réveillé" 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

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.