Schéma Trait de couleur pour la maison connectée

action.devices.traits.ColorSetting : cette caractéristique s'applique aux appareils comme les systèmes d'éclairage connectés, qui peuvent modifier la couleur ou la température des couleurs.

RVB, HSV et température des couleurs

Le RVB représente les couleurs sous la forme d'un triplet (rouge, vert, bleu). RVB est le modèle de couleurs par défaut. Tout triplet RVB peut être représenté par un code hexadécimal, équivalent aux valeurs hexadécimales du triplet concaténé. Par exemple, "bleu" correspond à (0, 0, 255) et à #0000FF. Vous pouvez utiliser n'importe quelle valeur dans l'espace colorimétrique RVB, c'est-à-dire RV(x, y, z), où x, y et z sont compris dans la plage [0, 255], inclus.

HSV représente les couleurs par un triplet (teinte, saturation, valeur). N'importe quelle valeur de couleur dans HSV peut être convertie en RVB, et inversement. La plage de Hue est comprise entre 0 et 360 degrés (hors 360 degrés, car elle couvre 0 degré environ). La saturation et la valeur sont représentées par des floats compris dans la plage [0,0, 1.0].

La température des couleurs représente certaines couleurs sous forme de valeurs décimales non négatives en kelvin. Cet attribut décrit des lumières "blanches" ou "chaudes", avec des noms de couleur tels que "blanc frais" ou "ciel étoilé". Les ampoules connectées compatibles avec la température de couleur ont généralement une plage de [2 000, 9 000] Kelvin, ce qui correspond aux lumières classiques avec un kelvin fixe. La température des couleurs est une échelle linéaire et un sous-ensemble des modèles de couleurs complets RVB/HSV. Consultez le tableau ci-dessous pour obtenir des exemples de températures et les noms de couleur correspondants.

Température (Kelvin)	Nom de la couleur
2 000	Bougie
2 500	Blanc très chaud
3 000	Blanc doux, blanc matin, blanc
4 000	Blanc froid
5 000	Lumière du jour, blanc
6 000	Blanc floral
7000	Nuageux, lumière blanche et fumée
8000	Ciel bleu
9000	Ciel bleu

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs	Type	Description
commandOnlyColorSetting	Booléen	(Par défaut : false) Indique si l'appareil est compatible avec la communication unidirectionnelle (true) ou bidirectionnelle (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Report Report pour cette caractéristique.
Contient l'un des éléments suivants:
0	Objet	Compatibilité avec les modèles de couleur.
colorModel	Chaîne	Obligatoire. Modèle de couleurs à spectre complet compatible avec l'appareil. Valeurs acceptées : rgb hsv
1	Objet	Compatibilité avec la température des couleurs.
colorTemperatureRange	Objet	Obligatoire. Plage de température de couleur acceptée en kelvin.
temperatureMinK	Entier	Obligatoire. Température des couleurs minimale acceptée en kelvin.
temperatureMaxK	Entier	Obligatoire. Température de couleur maximale acceptée en kelvin.

Exemples

Appareil compatible avec le modèle de couleurs à spectre RVB et la température des couleurs.

{
  "colorModel": "rgb",
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Appareil compatible uniquement avec le modèle de couleurs à spectre HSV.

{
  "colorModel": "hsv"
}

Appareil uniquement compatible avec la température des couleurs.

{
  "colorTemperatureRange": {
    "temperatureMinK": 2000,
    "temperatureMaxK": 9000
  }
}

Appareil compatible uniquement avec les commandes du modèle de couleur HSV.

{
  "colorModel": "hsv",
  "commandOnlyColorSetting": true
}

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

États	Type	Description
color	Objet	Obligatoire. Paramètre de couleur actuel actuellement utilisé sur l'appareil.
Contient l'un des éléments suivants:
0	Objet	Compatibilité avec la température des couleurs.
temperatureK	Entier	Obligatoire. Température en kelvin.
1	Objet	Compatibilité avec le spectre des couleurs RVB.
spectrumRgb	Entier	Obligatoire. Valeur du spectre RVB sous forme de nombre décimal.
2	Objet	Prise en charge du spectre couleur HSV.
spectrumHsv	Objet	Obligatoire. Valeur HSV du spectre.
hue	Number	Teinte
saturation	Number	Saturation.
value	Number	Valeur.

Exemples

Quelle est la couleur du voyant ? (blanc chaud)

{
  "color": {
    "temperatureK": 3000
  }
}

Quelle est la couleur du voyant ? (Magenta).

{
  "color": {
    "spectrumRgb": 16711935
  }
}

Quelle est la couleur du voyant ? (Magenta).

{
  "color": {
    "spectrumHsv": {
      "hue": 300,
      "saturation": 1,
      "value": 1
    }
  }
}

Appareil COMMANDS

Les appareils disposant 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 Traitement des intents.

action.devices.commands.ColorAbsolute

Définissez la valeur de couleur absolue.

Paramètres

Paramètres	Type	Description
color	Objet	Obligatoire. Couleur à définir.
name	Chaîne	Nom de la couleur analysé à partir de la commande de l'utilisateur ; peut-être pas toujours disponible (en cas d'utilisation de commandes relatives, par exemple).
Contient l'un des éléments suivants:
0	Objet	Compatibilité avec la température des couleurs.
temperature	Entier	Obligatoire. Température en kelvin. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
1	Objet	Compatibilité avec le spectre des couleurs RVB.
spectrumRGB	Entier	Obligatoire. Valeur du spectre RVB sous forme de nombre décimal. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
2	Objet	Prise en charge du spectre couleur HSV.
spectrumHSV	Objet	Obligatoire. Valeur HSV du spectre. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
hue	Number	Teinte
saturation	Number	Saturation.
value	Number	Valeur.

Exemples

Mets la lumière en blanc chaud.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Warm White",
      "temperature": 3000
    }
  }
}

Définissez l'éclairage comme un magenta.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumRGB": 16711935
    }
  }
}

Définissez l'éclairage comme un magenta.

{
  "command": "action.devices.commands.ColorAbsolute",
  "params": {
    "color": {
      "name": "Magenta",
      "spectrumHSV": {
        "hue": 300,
        "saturation": 1,
        "value": 1
      }
    }
  }
}

Notez que les noms des paramètres diffèrent légèrement entre les paramètres de commande et d'état. Cela permet d'éviter les conflits avec les paramètres d'état pour les caractéristiques obsolètes ColorSpectrum et ColorTemperature.

Commande	State
temperature	temperatureK
spectrumRGB	spectrumRgb
spectrumHSV	spectrumHsv

Exemples d'énoncés

de-DE

• Stell die Farbe der Lampe auf blau
• Stelle die Farbtemperatur auf 3000 Kelvin ein.

en-US

• can you adjust my lights color to 4000 kelvins
• set the lights to blue

es-ES

• pon azul la luz de la cocina
• pon la luz a 2000 k de temperatura de color

fr-FR

• Allume la lampe de la chambre à 3500 kelvins .
• mets les lampes en rose dans la chambre

hi-IN

• तुम लाइट को ब्लू कर दो
• लैम्प 2000 केल्विन पर लगाओ।

it-IT

• Imposta la lampada a 2000 K .
• metti la luce gialla

ja-JP

• 照明 の色を 青 にして
• 照明 の色温度を 5000K にセットして

ko-KR

• 조명 색깔 흰색 으로 바꿔 줘
• 주방 전등 색 온도를 5000 켈빈 으로 설정해

nl-NL

• Zet de keukenlamp op 2000 Kelvin .
• maak het licht rood

pt-BR

• Colocar a lâmpada em 2000 K .
• Define a lâmpada para 2000 K .
• colocar a luz da sala em azul
• põe a luz da sala a vermelho

sv-SE

• Ställ in lampan på 2000 Kelvin
• tänd blått ljus i köket

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.