Schéma du Trait LightEffects de la maison connectée

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

ATTRIBUTS D'appareils

Les appareils présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération SYNC. Pour apprendre Pour en savoir plus sur la gestion des intents SYNC, consultez 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
Elle fait défiler différentes couleurs de manière aléatoire.
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 veille et de veille.

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

STATES de l'appareil

Les entités présentant cette caractéristique peuvent signaler les éléments suivants : dans le cadre de l'opération QUERY. Pour apprendre Pour en savoir plus sur la gestion des intents QUERY, consultez Traitement des intents.

États Type Description
activeLightEffect String

Effet de lumière actuellement activé, le cas échéant. Au choix : supportedEffects.

Valeurs acceptées :

colorLoop
sleep
wake
lightEffectEndUnixTimestampSec Entier

Code temporel Unix du moment où l'effet devrait se terminer, si l'effet 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 de lumière n'est actuellement actif.

{}

COMMANDS d'appareils

Les appareils présentant cette caractéristique peuvent répondre aux éléments suivants : dans le cadre de l'opération EXECUTE. Pour apprendre Pour en savoir plus sur la gestion des intents EXECUTE, consultez Traitement des intents.

action.devices.commands.ColorLoop

Demander à l'appareil de faire défiler un jeu 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

Diminuer progressivement la luminosité de l'appareil et, éventuellement, ajuster la température des couleurs sur un certain laps de 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

Laisse 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 mon éclairage.

{
  "command": "action.devices.commands.StopEffect",
  "params": {}
}

action.devices.commands.Wake

Augmentez progressivement la luminosité de l'appareil et, si vous le souhaitez, règle 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 wakeup, en secondes.

Exemples

Règle mes lumières sur 60 minutes.

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

Émulation d'effets lumineux

Si votre appareil met en œuvre l' Brightness, mais pas la trait LightEffects, la prend en charge les émulations de "sleep" et "activer" sans avoir besoin de code supplémentaire. La plate-forme émule les effets en envoyant une série d'intents EXECUTE.

Exemples d'énoncés

<ph type="x-smartling-placeholder">

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 d'appareil

Voir la liste complète les erreurs et les exceptions.