Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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 000Bougie
2 500Blanc très chaud
3 000Blanc doux, blanc matin, blanc
4 000Blanc froid
5 000Lumière du jour, Blanc
6 000Blanc floral
7000Nuageux, journée, fumée blanche
8000Ciel couvert bleu
9000Bleu 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 2000 Kelvin
  • tänd blått ljus i köket

Erreurs liées à l'appareil

Consultez la liste complète des erreurs et exceptions.