Schéma de trait ColorSetting pour la maison connectée

action.devices.traits.ColorSetting : cette caractéristique s'applique aux appareils, tels que les ampoules connectées, qui peuvent changer de couleur ou de température de couleur.

RVB, HSV et température de couleur

Le RVB représente les couleurs sous la forme d'un triplet (rouge, vert, bleu). Le modèle RVB est le modèle de couleur 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 de l'espace colorimétrique RVB, c'est-à-dire RGB(x, y, z) où x, y et z se trouvent dans la plage [0, 255], inclusive.

Le HSV représente les couleurs sous la forme d'un triplet (teinte, saturation, valeur). Toute valeur de couleur en HSV peut être convertie en RVB, et inversement. La teinte a une plage de [0, 360] degrés (360 degrés exclus, car elle revient à 0 degrés). La saturation et la valeur sont représentées par des nombres à virgule flottante compris dans la plage [0,0, 1,0].

La température de couleur représente certaines couleurs sous la forme de valeurs décimales non négatives en kelvin. Cet attribut décrit les lumières "blanche" ou "chaleureuse", avec des noms de couleurs tels que "blanc froid" ou "lumière du jour couverte". 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 ampoules classiques à température de couleur fixe. La température des couleurs est une échelle linéaire qui correspond à un sous-ensemble des modèles de couleurs RVB/HSV complets. Consultez le tableau ci-dessous pour obtenir des exemples de températures et de noms de couleurs correspondants.

Température (kelvin) Nom de la couleur
2000Bougie
2500Blanc ultra chaud
3000Blanc doux, Blanc matinal, Blanc lecture
4000Blanc froid
5000Lumière du jour, blanc
6000Blanc floral
7000Lumière du jour nuageuse, fumée blanche
8000Bleu couvert
9000Blue Sky

ATTRIBUTS de l'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 Valeur booléenne

(Par défaut : false)

Indique si l'appareil prend en charge la communication à sens unique (true) ou à double sens (false). Définissez cet attribut sur "true" si l'appareil ne peut pas répondre à un intent QUERY ou à l'état du rapport pour cette caractéristique.
Contient l'un des éléments suivants :
0 Objet

Prise en charge du modèle de couleur.
colorModel String

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 compatible en Kelvin.
temperatureMinK Entier

Obligatoire.

Température de couleur minimale compatible en Kelvin.
temperatureMaxK Entier

Obligatoire.

Température de couleur maximale prise en charge en Kelvin.

Exemples

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

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

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

{
  "colorModel": "hsv"
}

Appareil compatible uniquement avec la température des couleurs

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

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

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

STATES de l'appareil

Les entités avec 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

Compatibilité avec la température des couleurs.
temperatureK Entier

Obligatoire.

Valeur de température en Kelvin.
1 Objet

Compatibilité avec le spectre de couleurs RVB.
spectrumRgb Entier

Obligatoire.

Valeur RVB dans le spectre sous forme de nombre 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

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
    }
  }
}

COMMANDES DE L'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éfinit la valeur de couleur absolue.

Paramètres

Paramètres Type Description
color Objet

Obligatoire.

Couleur à définir.
name String

Nom de la couleur extrait de la commande de l'utilisateur. Il n'est pas toujours disponible (par exemple, lorsque vous utilisez des commandes relatives).
Contient l'un des éléments suivants :
0 Objet

Compatibilité avec la température des couleurs.
temperature Entier

Obligatoire.

Valeur de température en Kelvin. Pour en savoir plus, consultez RGB, HSV et température de couleur.
1 Objet

Compatibilité avec le spectre de couleurs RVB.
spectrumRGB Entier

Obligatoire.

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

Compatibilité avec le spectre de couleurs HSV.
spectrumHSV Objet

Obligatoire.

Valeur HSV du spectre. Pour en savoir plus, consultez RGB, HSV et température de couleur.
hue Number

Teinte.
saturation Number

Saturation.
value Number

Valeur

Exemples

Règle le voyant sur blanc chaud.

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

Réglez la couleur de la lumière sur magenta.

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

Réglez la couleur de la lumière sur magenta.

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

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

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 de l'appareil

Consultez la liste complète des erreurs et exceptions.