Características do dispositivo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A funcionalidade dos tipos de dispositivo vem das características que você adiciona a cada um deles.
Cada tipo de dispositivo tem diversas características recomendadas, mas você pode adicionar as que
quiser.
| Nome |
Características do dispositivo |
Descrição |
Tipos de dispositivos recomendados |
| Brilho |
action.devices.traits.Brightness |
A configuração de brilho absoluto está em um intervalo normalizado de 0 a 100 (luzes individuais podem não ser compatíveis com todos os pontos do intervalo com base na sua configuração de LED). |
Guia claro |
| ColorSpectrum (link em inglês) |
action.devices.traits.ColorSpectrum |
Isso se aplica a lâmpadas de cores "completas" que aceitam intervalos de cores
RGB. As luzes podem ter qualquer combinação de ColorSpectrum e ColorTemperature. Luzes de destaque e tiras de LED podem ter apenas o Spectrum, enquanto algumas lâmpadas de leitura têm apenas temperatura. As lâmpadas básicas ou burros em plugues inteligentes também não têm. |
Guia claro |
| ColorTemperature (em inglês) |
action.devices.traits.ColorTemperature |
Isso se aplica a lâmpadas "quente" que assumem um ponto de cor
em Kelvin. Essa é geralmente uma modalidade separada de ColorSpectrum,
e pode haver pontos brancos disponíveis via Temperatura que não podem ser alcançados pela Spectrum. Com base nas características disponíveis, o Google pode escolher o modo apropriado de acordo com a solicitação e o tipo de luz. Por exemplo, Deixar as luzes da sala de estar em branco pode enviar comandos de temperatura para algumas lâmpadas e comandos do Spectrum para faixas de LED. |
Guia claro |
| Dock (em inglês) |
action.devices.traits.Dock |
Essa característica foi projetada para dispositivos móveis que podem ser retornados
para carregamento. |
Vários aparelhos |
| Ativado |
action.devices.traits.OnOff |
A funcionalidade básica de ativação e desativação para qualquer dispositivo que tenha binário ativado e desativado, incluindo plugues e chaves, bem como muitos dispositivos futuros. |
Guia claro |
| StartStop |
action.devices.traits.StartStop |
A inicialização e a interrupção de um dispositivo têm uma função semelhante à
ativação e desativação dele. Os dispositivos que herdam essa característica funcionam de maneira diferente quando são ligados e
iniciados. Ao contrário dos dispositivos que simplesmente têm um estado ativado e desativado, alguns dispositivos que podem iniciar e parar
também podem pausar durante a operação. |
Qualquer: principalmente eletrodomésticos, aspiradores de pó e outros itens com comportamento
de atividade acima da potência |
| TemperatureSetting (em inglês) |
action.devices.traits.TemperatureSetting |
Essa característica abrange o processamento de pontos de temperatura e modos. |
Guia de Termostato |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2023-12-02 UTC.
[null,null,["Última atualização 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) |"]]
