Schéma de caractéristiques ColorSetting pour la maison connectée

action.devices.traits.ColorSetting : cette caractéristique s'applique aux appareils, comme les ampoules connectées, qui peuvent changer la couleur ou la température des couleurs.

RVB, HSV et température des couleurs

RVB représente les couleurs sous la forme d'un triplet (rouge, vert, bleu). Le modèle de couleur par défaut est RVB. Tout triplet RVB peut être représenté sous la forme d'un code hexadécimal, ce qui équivaut 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 RVB(x, y, z) où x, y, z sont compris dans la plage [0, 255] inclus.

La TSL représente les couleurs sous la forme d'un triplet (teinte, saturation, valeur). Toute valeur de couleur dans HSV peut être convertie en RVB, et inversement. La plage de nuance est comprise entre [0 et 360 degrés] (sans compter 360), car elle s'étend sur 0 degré. La saturation et la valeur sont représentées par des valeurs à virgule flottante comprises 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 kelvins. Cet attribut décrit les lumières "blanche" ou "chaleureuse", avec des noms de couleurs tels que "blanc froid" ou "lumière du jour nuageuse". Les ampoules connectées prenant en charge la température des couleurs ont généralement une plage de [2 000 et 9 000] Kelvin, ce qui correspond aux éclairages conventionnels dotés d'une température fixe en Kelvin. La température de couleur est une échelle linéaire et un sous-ensemble des modèles de couleurs à spectre complet 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 000Bougies
2 500Blanc ultra chaud
3 000Blanc doux, Blanc matinal, Blanc de lecture
4 000Blanc froid
5 000Éclairage du jour, blanc
6 000Blanc floral
7000Lumière du jour nuageuse, fumée blanche
8000Ciel bleu
9000Ciel bleu

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
commandOnlyColorSetting Booléen

(Par défaut : false)

Indique si l'appareil est compatible avec la communication unidirectionnelle (vrai) ou bidirectionnelle (faux). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ni à un état de rapport pour cette caractéristique.
Contient l'un des éléments suivants:
0 Objet

Prise en charge des modèles de couleur.
colorModel String

Obligatoire.

Modèle colorimétrique complet compatible avec l'appareil.

Valeurs acceptées :

rgb
hsv
1 Objet

Prise en charge de la température des couleurs.
colorTemperatureRange Objet

Obligatoire.

Plage de températures de couleur en kelvins acceptée.
temperatureMinK Entier

Obligatoire.

Température des couleurs minimale acceptée en Kelvin.
temperatureMaxK Entier

Obligatoire.

Température des couleurs maximale acceptée en Kelvin.

Exemples

Appareil compatible avec le modèle de couleur du spectre RVB et la température de couleur.

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

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

{
  "colorModel": "hsv"
}

Appareil qui n'accepte que la température des couleurs.

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

Appareil qui n'accepte que les commandes de modèle de couleur HSV.

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

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
color Objet

Obligatoire.

Paramètre de couleur actuellement utilisé sur l'appareil.
Contient l'un des éléments suivants:
0 Objet

Prise en charge de la température des couleurs.
temperatureK Entier

Obligatoire.

Valeur de température en kelvin.
1 Objet

Compatibilité avec le spectre RVB de couleur.
spectrumRgb Entier

Obligatoire.

Valeur du spectre RVB sous forme de nombre entier décimal.
2 Objet

Prise en charge du spectre HSV couleur.
spectrumHsv Objet

Obligatoire.

Valeur du spectre HSV.
hue Number

Teinte.
saturation Number

Saturation
value Number

Valeur.

Exemples

De quelle couleur est la lumière ? (Blanc chaud)

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

De quelle couleur est la lumière ? (Magenta)

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

De quelle couleur est la lumière ? (Magenta)

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

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.ColorAbsolute

Définissez la valeur absolue de la couleur.

Paramètres

Paramètres Type Description
color Objet

Obligatoire.

Couleur à définir.
name String

Nom de couleur analysé à partir de la commande de l'utilisateur. Il est possible qu'il ne soit pas toujours disponible (lors de l'utilisation de commandes relatives).
Contient l'un des éléments suivants:
0 Objet

Prise en charge de la température des couleurs.
temperature Entier

Obligatoire.

Valeur de température en kelvin. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
1 Objet

Compatibilité avec le spectre RVB de couleur.
spectrumRGB Entier

Obligatoire.

Valeur du spectre RVB sous forme de nombre entier décimal. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
2 Objet

Prise en charge du spectre HSV couleur.
spectrumHSV Objet

Obligatoire.

Valeur du spectre HSV. Pour en savoir plus, consultez RVB, HSV et température des couleurs.
hue Number

Teinte.
saturation Number

Saturation
value Number

Rapport qualité-prix

Exemples

Réglez la lumière sur blanc chaud.

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

Mets la lumière en magenta.

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

Mets la lumière en magenta.

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

Notez que les noms de paramètres diffèrent légèrement entre les paramètres de commande et d'état. Cela évite les conflits avec les paramètres d'état des traits ColorSpectrum et ColorTemperature, devenus obsolètes.

Commande État
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.