Características del dispositivo
Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
La funcionalidad para los tipos de dispositivos proviene de las características que agregas a cada uno. Cada tipo de dispositivo tiene una serie de características recomendadas, pero puedes agregar las que quieras.
| Nombre | Características del dispositivo | Descripción | Tipos de dispositivos recomendados |
| Brillo | action.devices.traits.Brightness | El parámetro de configuración de brillo absoluto está en un rango normalizado de 0 a 100 (es posible que las luces individuales no admitan todos los puntos del rango según su configuración de LED). | Guía clara |
| ColorSpectrum; | action.devices.traits.ColorSpectrum | Esto se aplica a las bombillas de color "full" que usan rangos de colores RGB. Las luces pueden tener cualquier combinación de ColorSpectrum y ColorTemperature; las luces de acento y las tiras LED pueden tener Spectrum, mientras que algunas bombillas de lectura solo tienen Temperatura. Las bombillas básicas, o las luces atenuadas en los enchufes inteligentes, tampoco lo tienen. | Guía clara |
| Temperatura del color | action.devices.traits.ColorTemperature | Esto se aplica a las bombillas "cálidas" que tienen un punto de color en Kelvin. Por lo general, esta es una modalidad independiente de ColorSpectrum, y es posible que haya puntos blancos disponibles mediante Temperatura a los que Spectrum no pueda alcanzar. Según las características disponibles, Google puede elegir el modo adecuado para usar en función de la solicitud y el tipo de luz (por ejemplo, Haz que las luces de la sala de estar sean blancas puede enviar comandos de temperatura a algunas bombillas y comandos Spectrum a tiras LED). | Guía clara |
| Base | action.devices.traits.Dock | Esta característica está diseñada para dispositivos móviles que se pueden ordenar a fin de que se devuelvan para cargarla. | Varios dispositivos |
| Activado | action.devices.traits.OnOff | La funcionalidad básica de encendido y apagado de cualquier dispositivo que tenga activado y desactivado el objeto binario, incluidos interruptores y enchufes, así como muchos dispositivos futuros. | Guía clara |
| StartStop | action.devices.traits.StartStop | Iniciar y detener un dispositivo tiene una función similar a la de encendido y apagado. Los dispositivos que heredan esta función de manera diferente cuando se encienden y se inician. A diferencia de los dispositivos que solo tienen un estado de encendido y apagado, algunos que pueden iniciarse y detenerse también pueden pausarse mientras realizan la operación. | Cualquiera, principalmente electrodomésticos, aspiradoras y otros elementos que tengan un comportamiento de actividad específico por encima y más allá de la potencia |
| Configuración de la temperatura | action.devices.traits.TemperatureSetting | Esta característica cubre el manejo del punto de temperatura y los modos. | Guía del termostato |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2023-12-02 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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) |"]]
