Schéma du trait Smart Home ColorSetting

action.devices.traits.ColorSetting : ce trait 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

RVB représente les couleurs sous la forme d'un triplet (rouge, vert, bleu). RVB est le modèle de couleur par défaut. Tout triplet RVB peut être représenté sous la forme d'un code hexadécimal, équivalent aux valeurs hexadécimales du triplet concaténées. 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 et z sont compris dans la plage [0, 255], inclus.

HSV représente les couleurs sous la forme d'un triplet (teinte, saturation, valeur). Toute valeur de couleur au format HSV peut être convertie au format RVB, et inversement. La teinte est comprise entre 0 et 360 degrés (360 exclu, car elle revient à 0 degré). La saturation et la valeur sont représentées par des valeurs flottantes comprises entre 0,0 et 1,0.

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

ATTRIBUTS de l'appareil

Les appareils dotés de ce trait peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Fulfillment d'intent.

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'est compatible qu'avec la température de couleur.

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

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

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

ÉTATS des appareils

Les entités dotées de ce trait peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez Fulfillment d'intent.

Exemples

Quelle est la couleur de 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 ce trait 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 Fulfillment d'intent.

action.devices.commands.ColorAbsolute

Définissez la valeur de couleur absolue.

Paramètres

Exemples

Mets la lumière sur un 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 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 des traits ColorSpectrum et ColorTemperature obsolètes.

Exemples d'énoncés

ERREURS liées à l'appareil