Ti diamo il benvenuto nel Centro sviluppatori Google Home, la nuova destinazione per imparare a sviluppare azioni per la smart home. Nota:continuerai a creare azioni nella Console Actions.
Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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
2000A lume di candela
2500Bianco molto caldo
3000bianco tenue, bianco mattina, bianco lettura
4000Bianco freddo
5000Luce diurna, bianca
6000Floreale bianco
7000Nuvoloso (bianco/nero)
8000Coperto blu
9000Azzurro 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
    }
  }
}

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

ERRORI del dispositivo

Consulta l'elenco completo degli errori e delle eccezioni.