Esquema de características de ColorSetting da casa inteligente

action.devices.traits.ColorSetting: essa característica se aplica a dispositivos, como iluminação inteligente, que podem mudar de cor ou de temperatura da cor.

RGB, HSV e temperatura de cor

RGB representa cores como um trio (vermelho, verde, azul). RGB é o modelo de cor padrão. Qualquer trio RGB pode ser representado como um código hexadecimal, equivalente aos valores hexadecimais do trio concatenado. Por exemplo, "azul" é (0, 0, 255) e #0000FF. Você pode usar qualquer valor no espaço de cores RGB, ou seja, RGB(x, y, z), em que x, y, z estão no intervalo [0, 255], inclusive.

HSV representa cores como um trio (matiz, saturação, valor). Qualquer valor de cor em HSV pode ser convertido para RGB e vice-versa. O matiz tem um intervalo de [0, 360) graus (exclusivo de 360, já que ele é repetido em 0 graus). A saturação e o valor são representados por floats no intervalo [0,0, 1,0].

A Temperatura da cor representa algumas cores como valores decimais não negativos em Kelvin. Esse atributo descreve "luzes" "brancas" ou "quentes", com nomes de cores como "branco frio" ou "luz do dia nublado." As luzes inteligentes que oferecem suporte à temperatura da cor normalmente têm um intervalo de [2000, 9000] Kelvin, que corresponde a luzes convencionais com Kelvin fixo. A temperatura de cor é uma escala linear e um subconjunto dos modelos de cores de espectro completo RGB/HSV. Consulte a tabela abaixo para conferir alguns exemplos de temperaturas e nomes de cores correspondentes.

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da SYNC operação. Para saber mais sobre como processar SYNC intents, consulte Processamento de intents.

Exemplos

Dispositivo que oferece suporte ao modelo de cores de espectro RGB e à temperatura da cor.

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

Dispositivo que oferece suporte apenas ao modelo de cores de espectro HSV.

{
  "colorModel": "hsv"
}

Dispositivo que oferece suporte apenas à temperatura da cor.

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

Dispositivo que oferece suporte apenas a comandos de modelo de cores HSV.

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

ESTADOS do dispositivo

As entidades com essa característica podem informar os seguintes estados como parte da QUERY operação. Para saber mais sobre como processar QUERY intents, consulte Processamento de intents.

Exemplos

Qual é a cor da luz? (Branco quente)

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

Qual é a cor da luz? (Magenta)

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

Qual é a cor da luz? (Magenta)

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

COMANDOS do dispositivo

Os dispositivos com essa característica podem responder aos seguintes comandos como parte da EXECUTE operação. Para saber mais sobre como processar EXECUTE intents, consulte Processamento de intents.

action.devices.commands.ColorAbsolute

Defina o valor de cor absoluto.

Parâmetros

Exemplos

Deixar a luz branca quente.

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

Deixar a luz magenta.

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

Deixar a luz magenta.

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

Os nomes dos parâmetros variam um pouco entre os parâmetros de comando e de estado. Isso evita conflitos com os parâmetros de estado das características ColorSpectrum e ColorTemperature descontinuadas.

Exemplos de declarações

ERROS do dispositivo