Schéma de trait Smart Home LightEffects

action.devices.traits.LightEffects : ce trait appartient aux appareils compatibles avec les commandes d'éclairage complexes permettant de changer d'état, par exemple en parcourant différentes couleurs.

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

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 pris en charge par l'appareil.
[item, ...] String

Effet compatible.

Valeurs acceptées :

colorLoop
Parcourt différentes couleurs de manière aléatoire.
sleep
Diminue progressivement la luminosité et, si vous le souhaitez, ajuste la température des couleurs sur une période donnée.
wake
 Augmente progressivement la luminosité et, éventuellement, ajuste la température des couleurs sur une période donnée.

Exemples

Appareil compatible avec l'effet de boucle de couleur.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Appareil compatible avec les effets de mise en veille/sortie de veille.

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

États Type Description
activeLightEffect String

Effet de lumière actuellement actif, le cas échéant. Spécifiez l'un des contrôles suivants : supportedEffects.

Valeurs acceptées :

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Entier

Code temporel Unix indiquant la fin prévue de l'effet, si celui-ci se termine de lui-même.

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 lumineux n'est actuellement actif.

{}

COMMANDES de l'appareil

Les appareils dotés de ce trait 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 Fulfillment d'intent.

action.devices.commands.ColorLoop

Demandez à l'appareil de parcourir un ensemble 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

Mets mes lumières en mode Colorloop pendant 60 minutes.

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

action.devices.commands.Sleep

Diminue progressivement la luminosité de l'appareil et, si vous le souhaitez, ajuste la température des couleurs pendant une certaine durée.

Cette commande nécessite les attributs suivants : 
{
  "supportedEffects": [
    "sleep"
  ]
}

Paramètres

Paramètres Type Description
duration Entier

Durée de la commande de veille, en secondes, comprise entre 300 et 3 600.

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 en cours.

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

Augmente progressivement la luminosité de l'appareil et, éventuellement, ajuste la température des couleurs pendant une certaine durée.

Cette commande nécessite les attributs suivants : 
{
  "supportedEffects": [
    "wake"
  ]
}

Paramètres

Paramètres Type Description
duration Entier

Durée de la commande de réveil, en secondes, comprise entre 300 et 3 600.

Exemples

Allume doucement la lumière pendant 60 minutes.

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

Émulation des effets de lumière

Si votre appareil implémente le trait Brightness, mais pas le trait LightEffects, la plate-forme prend en charge les effets "veille" et "réveil" émulés, sans nécessiter de code supplémentaire. La plate-forme émule les effets en envoyant une série d'intentions 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.