Schéma des caractéristiques de la couleur des maisons connectées

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

RVB, HSV et température de couleur

RVB représente les couleurs sous forme de triplet (rouge, vert, bleu). RVB est le modèle de couleurs par défaut. Tout triplet RVB peut être représenté sous forme d'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 sous forme de triplet (teinte, saturation, valeur). Toute valeur de couleur dans le composant HSV peut être convertie en RVB, et inversement. La plage de Hue est comprise entre [0, 360] degrés (hors 360°, car elle s'étend jusqu'à 0 degré). Saturation et valeur sont représentées par des nombres à virgule flottante 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 couleurs tels que "blanc froid" ou "lumière couverte". Les lumières intelligentes compatibles avec la température des couleurs ont généralement une plage de [2 000, 9 000] kelvins, ce qui correspond aux lumières conventionnelles avec Kelvin fixe. La température des couleurs est une échelle linéaire et un sous-ensemble des modèles de couleurs à double spectre RVB/HSV. Consultez le tableau ci-dessous pour obtenir des exemples de températures et les noms de couleurs 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, journée, fumée blanche
8000	Ciel couvert bleu
9000	Bleu ciel

Appareil : ATTRIBUTES

Les appareils associés à 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 page Traitement des intents.

Attributs	Type	Description
commandOnlyColorSetting	Booléen	(Par défaut : false) Indique si l'appareil est compatible avec la communication unidirectionnelle (vraie) ou bidirectionnelle (fausse). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou Signaler un état 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 à spectre complet compatible avec l'appareil. Valeurs acceptées : rgb hsv
1	Objet	Température des couleurs.
colorTemperatureRange	Objet	Obligatoire. Plage de température des couleurs compatible en kelvin.
temperatureMinK	Entier	Obligatoire. Température minimale des couleurs acceptée (en kelvin)
temperatureMaxK	Entier	Obligatoire. Température maximale des couleurs 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 n'acceptant que les commandes de modèle de couleur HSV.

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

Appareil : STATES

Les appareils associés à 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 page Traitement des intents.

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

Exemples

Quelle est la couleur de la lumière ? (Blanc chaud)

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

Quelle est la couleur de la lumière ? (Magenta).

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

Quelle est la couleur de la lumière ? (Magenta).

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

Appareil COMMANDS

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 page 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 couleur analysé à partir de la commande de l'utilisateur. Il est possible qu'il ne soit pas toujours disponible (c'est-à-dire lorsque vous utilisez des commandes relatives).
Contient l'un des éléments suivants :
0	Objet	Température des couleurs.
temperature	Entier	Obligatoire. Valeur de température en kelvin.
1	Objet	Compatibilité avec le spectre RVB.
spectrumRGB	Entier	Obligatoire. Valeur du spectre RVB sous forme d'entier décimal.
2	Objet	Compatibilité avec le spectre de couleurs HSV.
spectrumHSV	Objet	Obligatoire. Valeur HSV du spectre.
hue	Number	Teinte.
saturation	Number	Saturation.
value	Number	Valeur.

Exemples

Mets une lumière blanche.

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

Créez un magenta clair.

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

Créez un magenta clair.

{
  "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 ColorTempérature.

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 liées à l'appareil

Consultez la liste complète des erreurs et exceptions.