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 : 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
Fait défiler différentes couleurs en boucle 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 au fil du temps.

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 : supportedEffects.

Valeurs acceptées :

colorLoop
sleep
wake
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

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.