Questa pagina è stata tradotta dall'API Cloud Translation.

Schema trattino colore Smart Home

action.devices.traits.ColorSetting: questa caratteristica è valida per i dispositivi che possono modificare il colore o la temperatura di colore, ad esempio le luci smart.

RGB, HSV e temperatura di colore

RGB rappresenta i colori come una tripletta (rossa, verde, blu) dei colori. 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] (inclusivi).

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

La temperatura del colore rappresenta alcuni colori come valori decimali non negativi in Kelvin. Questo attributo descrive le luci "bianche" o "warmth" con nomi di colori come "bianco freddo" o "luce sovrastata". Le luci smart che supportano la temperatura colore hanno in genere un intervallo di [2000, 9000] Kelvin, che corrispondono 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. Consulta la tabella riportata di seguito per alcuni esempi di temperature e nomi di colori corrispondenti.

Temperatura (Kelvin)	Nome colore
2000	A lume di candela
2500	Bianco molto caldo
3000	bianco tenue, bianco mattina, bianco lettura
4000	Bianco freddo
5000	Luce diurna, bianca
6000	Floreale bianco
7000	Nuvoloso (bianco/nero)
8000	Coperto blu
9000	Azzurro cielo

ATTRIBUTE del dispositivo

I dispositivi con questa caratteristica potrebbero segnalare i seguenti attributi come parte dell'operazione SYNC. Per scoprire di più sulla gestione degli intent SYNC, consulta Soddisfazione degli intent.

Attributi	Tipo	Descrizione
`commandOnlyColorSetting`	Booleano	(Valore predefinito: `false`) Indica se il dispositivo supporta la comunicazione unidirezionale (vero) o bidirezionale (falso). Imposta questo attributo su true se il dispositivo non può rispondere a un intent QUERY o a uno stato del report per questa caratteristica.
Contiene uno dei seguenti elementi:
`0`	Oggetto	Supporto dei modelli di colore.
`colorModel`	Stringa	Obbligatorio. Modello a colori a spettro completo supportato dal dispositivo. Valori supportati: `rgb` `hsv`
`1`	Oggetto	Supporto della temperatura colore.
`colorTemperatureRange`	Oggetto	Obbligatorio. Intervallo di temperatura colore supportato in Kelvin
`temperatureMinK`	Intero	Obbligatorio. Temperatura colore supportata minima in Kelvin.
`temperatureMaxK`	Intero	Obbligatorio. Temperatura massima supportata per i colori in Kelvin.

Esempi

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

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

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

{
  "colorModel": "hsv"
}

Dispositivo che supporta solo la temperatura colore.

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

Dispositivo che supporta solo i comandi dei modelli di colore HSV.

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

STATEs dispositivo

Le entità con questa caratteristica possono segnalare i seguenti stati nell'ambito dell'operazione QUERY. Per scoprire di più sulla gestione degli intent QUERY, consulta Soddisfazione degli intent.

Stati	Tipo	Descrizione
`color`	Oggetto	Obbligatorio. L'impostazione del colore attuale attualmente in uso sul dispositivo.
Contiene uno dei seguenti elementi:
`0`	Oggetto	Supporto della temperatura colore.
`temperatureK`	Intero	Obbligatorio. Valore temperatura in Kelvin.
`1`	Oggetto	Supporto dello spettro RGB a colori.
`spectrumRgb`	Intero	Obbligatorio. Valore Spettro RGB come numero intero decimale.
`2`	Oggetto	Supporto dello spettro HSV a colori.
`spectrumHsv`	Oggetto	Obbligatorio. Valore HSV dello spettro.
`hue`	Number	Hue.
`saturation`	Number	Saturazione.
`value`	Number	Valore.

Esempi

Qual è il colore della luce? (bianco caldo)

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

Qual è il colore della luce? (Magenta)

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

Qual è il colore della luce? (Magenta)

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

Nota:quando utilizzi lo stato del report per la caratteristica ColorSetting, assicurati di specificare lo stato RGB come spectrumRGB e quello HSV come spectrumHsv. Devi utilizzare la lettera maiuscola per i nomi di stato.

comandi del dispositivo

I dispositivi con questa caratteristica possono rispondere ai seguenti comandi nell'ambito dell'operazione EXECUTE. Per scoprire di più sulla gestione degli intent EXECUTE, consulta Soddisfazione degli intent.

`action.devices.commands.ColorAbsolute`

Imposta il valore di colore assoluto.

Parametri

Parametri	Tipo	Descrizione
`color`	Oggetto	Obbligatorio. Colore da impostare.
`name`	Stringa	Nome del colore analizzato dal comando dell'utente; potrebbe non essere sempre disponibile (ovvero quando si utilizzano i comandi relativi).
Contiene uno dei seguenti elementi:
`0`	Oggetto	Supporto della temperatura colore.
`temperature`	Intero	Obbligatorio. Valore temperatura in Kelvin. Per informazioni dettagliate, vedi RGB, HSV e temperatura di colore.
`1`	Oggetto	Supporto dello spettro RGB a colori.
`spectrumRGB`	Intero	Obbligatorio. Valore Spettro RGB come numero intero decimale. Per informazioni dettagliate, vedi RGB, HSV e temperatura di colore.
`2`	Oggetto	Supporto dello spettro HSV a colori.
`spectrumHSV`	Oggetto	Obbligatorio. Valore HSV dello spettro. Per informazioni dettagliate, vedi RGB, HSV e temperatura di colore.
`hue`	Number	Hue.
`saturation`	Number	Saturazione.
`value`	Number	Valore.

Esempi

Rendi la luce bianca calda.

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

Imposta il magenta chiaro.

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

Imposta il magenta chiaro.

{
  "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 di comando e stato. Questo evita conflitti con i parametri di stato dei tratti deprecati ColorSpectrum e ColorTemperature.

Comando	Stato
`temperature`	`temperatureK`
`spectrumRGB`	`spectrumRgb`
`spectrumHSV`	`spectrumHsv`

Esempi di frasi

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 på 2000 Kelvin
tänd blått ljus i köket

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.