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: 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:
|
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 } } }
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 aufblau -
Stelle die Farbtemperatur auf
3000 Kelvin ein.
en-US
-
can you adjust
my lights color to4000 kelvins -
set
the lights toblue
es-ES
-
pon
azul la luz de la cocina -
pon
la luz a2000 k de temperatura de color
fr-FR
-
Allume
la lampe de la chambre à3500 kelvins . -
mets
les lampes enrose dansla chambre
hi-IN
-
तुम
लाइट कोब्लू कर दो -
लैम्प 2000 केल्विन पर लगाओ।
it-IT
-
Imposta
la lampada a2000 K . -
metti
la luce gialla
ja-JP
-
照明 の色を青 にして -
照明 の色温度を5000K にセットして
ko-KR
-
조명 색깔흰색 으로 바꿔 줘 -
주방 전등 색 온도를5000 켈빈 으로 설정해
nl-NL
-
Zet
de keukenlamp op2000 Kelvin . -
maak
het licht rood
pt-BR
-
Colocar
a lâmpada em2000 K . -
Define
a lâmpada para2000 K . -
colocar
a luz da sala emazul -
põe
a luz da sala avermelho
sv-SE
-
Ställ in
lampan på2000 Kelvin -
tänd
blått ljus i köket