Schema del tratto ColorSetting della smart home

action.devices.traits.ColorSetting - Questo tratto si applica ai dispositivi, come le luci smart, che possono cambiare colore o temperatura di colore.

RGB, HSV e temperatura di colore

RGB rappresenta i colori come una tripletta (rosso, verde, blu). RGB è il modello di colore predefinito. Qualsiasi tripletta RGB può essere rappresentata come un codice esadecimale, equivalente ai valori esadecimali della tripletta concatenata. Ad esempio, "blu" è (0, 0, 255) e #0000FF. Puoi utilizzare qualsiasi valore all'interno dello spazio colore RGB, ovvero RGB(x, y, z) dove x, y, z sono compresi nell'intervallo [0, 255], inclusivo.

HSV rappresenta i colori come una tripletta (tonalità, saturazione, valore). Qualsiasi valore di colore in HSV può essere convertito in RGB e viceversa. La tonalità ha un intervallo di [0, 360) gradi (escluso 360, poiché si ripete a 0 gradi). La saturazione e il valore sono rappresentati da valori in virgola mobile nell' intervallo [0.0, 1.0].

La temperatura di colore rappresenta alcuni colori come valori decimali non negativi in Kelvin. Questo attributo descrive le luci "bianche" o "calde", con nomi di colore come "bianco freddo" o "luce diurna nuvolosa." Le luci smart che supportano la temperatura di colore hanno in genere un intervallo di [2000, 9000] Kelvin, che corrisponde alle luci convenzionali con Kelvin fisso. La temperatura di colore è una scala lineare e un sottoinsieme dei modelli di colore a spettro completo RGB/HSV. Nella tabella seguente sono riportati alcuni esempi di temperature e i nomi dei colori corrispondenti.

ATTRIBUTI del dispositivo

I dispositivi con questo tratto possono segnalare i seguenti attributi nell'ambito dell'operazione SYNC. Per saperne di più sulla gestione degli intent SYNC, consulta Completamento degli intent.

Esempi

Dispositivo che supporta sia il modello di colore dello spettro RGB sia la temperatura di colore.

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

Dispositivo che supporta solo il modello di colore dello spettro HSV.

{
  "colorModel": "hsv"
}

Dispositivo che supporta solo la temperatura di colore.

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

Dispositivo che supporta solo i comandi del modello di colore HSV.

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

STATI del dispositivo

Le entità con questo tratto possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per saperne di più sulla gestione degli intent QUERY, consulta Completamento degli intent.

Esempi

Di che colore è la luce? (Bianco caldo)

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

Di che colore è la luce? (Magenta)

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

Di che colore è la luce? (Magenta)

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

COMANDI del dispositivo

I dispositivi con questo tratto possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per saperne di più sulla gestione degli intent EXECUTE, consulta Completamento degli intent.

action.devices.commands.ColorAbsolute

Imposta il valore di colore assoluto.

Parametri

Esempi

Imposta la luce su un colore bianco caldo.

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

Imposta la luce su un colore magenta.

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

Imposta la luce su un colore magenta.

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

Tieni presente che i nomi dei parametri differiscono leggermente tra i parametri dei comandi e quelli degli stati. In questo modo si evitano conflitti con i parametri di stato per i tratti ColorSpectrum e ColorTemperature ritirati.

Esempi di espressioni

ERRORI del dispositivo