Esquema del rasgo ColorSetting de Smart Home

action.devices.traits.ColorSetting: Este rasgo se aplica a dispositivos, como las luces inteligentes, que pueden cambiar de color o de temperatura de color.

RGB, HSV y temperatura de color

RGB representa los colores como una tripleta (rojo, verde, azul). RGB es el modelo de color predeterminado. Cualquier trío RGB se puede representar como un código hexadecimal, equivalente a los valores hexadecimales del trío concatenados. Por ejemplo, "azul" es (0, 0, 255) y #0000FF. Puedes usar cualquier valor dentro del espacio de color RGB, es decir, RGB(x, y, z), donde x, y y z se encuentran dentro del rango [0, 255], inclusive.

HSV representa los colores como una tupla (tono, saturación, valor). Cualquier valor de color en HSV se puede convertir a RGB y viceversa. El tono tiene un rango de [0, 360) grados (sin incluir el 360, ya que se repite en 0 grados). La saturación y el valor se representan con números de punto flotante en el rango [0.0, 1.0].

La temperatura de color representa algunos colores como valores decimales no negativos en Kelvin. Este atributo describe las luces "blancas" o "cálidas", con nombres de colores como "blanco frío" o "luz del día nublada". Las luces inteligentes que admiten la temperatura de color suelen tener un rango de [2000, 9000] Kelvin, lo que corresponde a las luces convencionales con Kelvin fijo. La temperatura de color es una escala lineal y un subconjunto de los modelos de color de espectro completo RGB/HSV. Consulta la siguiente tabla para ver algunos ejemplos de temperaturas y los nombres de los colores correspondientes.

Atributos del dispositivo

Los dispositivos con este rasgo pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents de SYNC, consulta Entrega de intents.

Ejemplos

Dispositivo que admite el modelo de color del espectro RGB y la temperatura de color.

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

Dispositivo que solo admite el modelo de color del espectro HSV.

{
  "colorModel": "hsv"
}

Dispositivo que solo admite la temperatura de color.

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

Dispositivo que solo admite comandos del modelo de color HSV.

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

ESTADOS del dispositivo

Las entidades con este rasgo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents de QUERY, consulta Entrega de intents.

Ejemplos

¿De qué color es la luz? (Blanco cálido)

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

¿De qué color es la luz? (Magenta)

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

¿De qué color es la luz? (Magenta)

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

COMANDOS del dispositivo

Los dispositivos con este rasgo pueden responder a los siguientes comandos como parte de la operación EXECUTE. Para obtener más información sobre cómo controlar intents de EXECUTE, consulta Entrega de intents.

action.devices.commands.ColorAbsolute

Establece el valor de color absoluto.

Parámetros

Ejemplos

Pon la luz de color blanco cálido.

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

Pon la luz de color magenta.

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

Pon la luz de color magenta.

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

Ten en cuenta que los nombres de los parámetros difieren ligeramente entre los parámetros de comando y los de estado. Esto evita conflictos con los parámetros de estado de los rasgos ColorSpectrum y ColorTemperature en desuso.

Expresiones de muestra

ERRORES del dispositivo