Caratteristiche del dispositivo
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
La funzionalità relativa ai tipi di dispositivi deriva dalle caratteristiche che aggiungi a ciascuno di essi.
Ogni tipo di dispositivo ha una serie di caratteristiche consigliate, ma puoi aggiungerne
qualsiasi.
| Nome |
Caratteristiche del dispositivo |
Descrizione |
Tipi di dispositivi consigliati |
| Luminosità |
action.devices.traits.Brightness |
L'impostazione della luminosità assoluta rientra in un intervallo normalizzato compreso tra 0 e 100 (le singole luci potrebbero non supportare tutti i punti dell'intervallo in base alla configurazione del LED). |
Guida alle luci |
| ColoreSpettro |
action.devices.traits.ColorSpectrum |
Questo vale per le lampadine a colori "Completo" che utilizzano intervalli di colori RGB. Le luci possono avere qualsiasi combinazione di ColorSpectrum e ColorTemperature, mentre le luci d'accento e le strisce LED possono avere solo Spectrum, mentre alcune lampadine hanno solo la temperatura. Né le lampadine di base né le luci soffuse sulle prese smart. |
Guida alle luci |
| Temperatura colore |
action.devices.traits.ColorTemperature |
Questo vale per le lampadine "calde" che assumono un punto di colore
in Kelvin. In genere si tratta di una modalità separata da ColorSpectrum
e la disponibilità di punti bianchi tramite la temperatura non è raggiungibile da Spectrum. In base alle caratteristiche disponibili, Google potrebbe scegliere la modalità appropriata da utilizzare in base alla richiesta e al tipo di luce. Ad esempio, Fai diventare bianche le luci del salotto potrebbe inviare comandi di Temperatura ad alcune lampadine e i comandi Spectrum alle strisce LED. |
Guida alle luci |
| Dock |
action.devices.traits.Dock |
Questo tratto è progettato per i dispositivi mobili di cui si può comandare
per la ricarica. |
Vari elettrodomestici |
| Spento |
action.devices.traits.OnOff |
Le funzionalità di base per l'attivazione e la disattivazione di qualsiasi dispositivo con funzionalità di attivazione e disattivazione binarie, inclusi plug e switch, nonché numerosi dispositivi futuri. |
Guida alle luci |
| Inizia |
action.devices.traits.StartStop |
L'avvio e l'interruzione di un dispositivo hanno una funzione simile per
accenderlo e spegnerlo. I dispositivi che ereditano questo tratto funzionano in modo diverso all'accensione e all'avvio. A differenza dei dispositivi che hanno solo uno stato di accensione e spegnimento, alcuni dispositivi che possono avviarsi e interrompersi
possono anche essere messi in pausa durante l'esecuzione del funzionamento. |
Qualsiasi - principalmente elettrodomestici e aspirapolvere e altri elementi con un comportamento di attività specifico superiore o superiore all'alimentazione |
| Impostazione temperatura |
action.devices.traits.TemperatureSetting |
Questa caratteristica riguarda la gestione del punto di temperatura e delle modalità. |
Guida al termostato |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2023-12-02 UTC.
[null,null,["Ultimo aggiornamento 2023-12-02 UTC."],[[["\u003cp\u003eDevice functionality is determined by assigned traits.\u003c/p\u003e\n"],["\u003cp\u003eEach device type has suggested traits, but you can customize them.\u003c/p\u003e\n"],["\u003cp\u003eTraits control actions like brightness, color, on/off state, and temperature.\u003c/p\u003e\n"],["\u003cp\u003eSome traits are recommended for specific device types, like lights or thermostats.\u003c/p\u003e\n"]]],["Device functionality is defined by added traits. Available traits include `Brightness` (0-100 range), `ColorSpectrum` (RGB), and `ColorTemperature` (Kelvin). `Dock` is for self-mobile devices returning for charging. `OnOff` provides basic on/off, while `StartStop` allows starting, stopping, and pausing. `TemperatureSetting` handles temperature points and modes. Each trait has recommended device types, but any combination can be used.\n"],null,["# Device Traits\n\nThe functionality for device types comes from the traits that you add to each one.\nEach device type has a number of recommended traits, but you can add whichever ones you\nwant.\n\n| Name | Device Traits | Description | Recommended Device Types |\n|--------------------------------------------------------------------------|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [Brightness](/assistant/sdk/reference/traits/brightness) | `action.devices.traits.Brightness` | Absolute brightness setting is in a normalized range from 0 to 100 (individual lights may not support every point in the range based on their LED configuration). | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum) | `action.devices.traits.ColorSpectrum` | This applies to \"full\" color bulbs that take RGB color ranges. Lights may have any combination of ColorSpectrum and [ColorTemperature](/assistant/sdk/reference/traits/colortemperature); accent lights and LED strips may just have Spectrum, whereas some reading bulbs just have Temperature. Basic bulbs, or dumb lights on smart plugs, have neither. | [Light Guide](/assistant/smarthome/guides/light) |\n| [ColorTemperature](/assistant/sdk/reference/traits/colortemperature) | `action.devices.traits.ColorTemperature` | This applies to \"warmth\" bulbs that take a color point in Kelvin. This is generally a separate modality from [ColorSpectrum](/assistant/sdk/reference/traits/colorspectrum), and there may be white points available via Temperature that cannot be reached by Spectrum. Based on available traits, Google may pick the appropriate mode to use based on request and light type (for example, *Make the living room lights white* might send Temperature commands to some bulbs and Spectrum commands to LED strips). | [Light Guide](/assistant/smarthome/guides/light) |\n| [Dock](/assistant/sdk/reference/traits/dock) | `action.devices.traits.Dock` | This trait is designed for self-mobile devices that can be commanded to return for charging. | Various appliances |\n| [OnOff](/assistant/sdk/reference/traits/onoff) | `action.devices.traits.OnOff` | The basic on and off functionality for any device that has binary on and off, including plugs and switches as well as many future devices. | [Light Guide](/assistant/smarthome/guides/light) |\n| [StartStop](/assistant/sdk/reference/traits/startstop) | `action.devices.traits.StartStop` | Starting and stopping a device serves a similar function to turning it on and off. Devices that inherit this trait function differently when turned on and when started. Unlike devices that simply have an on and off state, some devices that can start and stop are also able to pause while performing operation. | Any - mostly appliances and vacuums and other things that have specific activity behavior above and beyond power |\n| [TemperatureSetting](/assistant/sdk/reference/traits/temperaturesetting) | `action.devices.traits.TemperatureSetting` | This trait covers handling both temperature point and modes. | [Thermostat Guide](/assistant/smarthome/guides/thermostat) |"]]
