Schéma de trait LightEffects pour la maison connectée

action.devices.traits.LightEffects : cette caractéristique appartient aux appareils pouvant prendre en charge des commandes d'éclairage complexes pour modifier l'état, par exemple en faisant défiler différentes couleurs.

ATTRIBUTS de l'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 : 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 compatibles avec l'appareil.
[item, ...] String

Effet compatible.

Valeurs acceptées :

colorLoop
Parcours aléatoire de différentes couleurs.
sleep
Réduit 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, si vous le souhaitez, ajuste la température des couleurs au fil du temps.

Exemples

Appareil compatible avec l'effet de boucle de couleurs.

{
  "supportedEffects": [
    "colorLoop"
  ]
}

Appareil compatible avec les effets de mise en veille/réactivation.

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

ÉTATS DE L'APPAREIL

Les entités avec 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 de lumière actuellement actif, le cas échéant. supportedEffects.

Valeurs acceptées :

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Entier

Code temporel Unix du moment où l'effet est censé se terminer, si l'effet se termine de lui-même

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 de lumière n'est actuellement actif.

{}

COMMANDES DE L'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

Demandez à l'appareil de faire défiler 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 boucle de couleur pendant 60 minutes.

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

action.devices.commands.Sleep

Elle réduit progressivement la luminosité de l'appareil et, si nécessaire, 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 de mise en veille, 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êtez l'effet lumineux actuel.

Paramètres

Paramètres Type Description

Aucune propriété

Exemples

Arrête l'effet sur mon éclairage.

{
  "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 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 de réveil, en secondes.

Exemples

Allume doucement la lumière pendant 60 minutes.

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

Émulation des effets lumineux

Si votre appareil implémente la caractéristique Brightness, mais pas la caractéristique LightEffects, la plate-forme prend en charge les effets "sleep" (mode veille) et "wake" (mode éveil) é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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.