The functionality for device types comes from the traits that you add to each one. Each device type has a number of recommended traits, but you can add whichever ones you want.
Name | Device Traits | Description | Recommended Device Types |
---|---|---|---|
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 |
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; 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 |
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, 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 |
Dock | action.devices.traits.Dock |
This trait is designed for self-mobile devices that can be commanded to return for charging. | Various appliances |
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 |
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 |
TemperatureSetting | action.devices.traits.TemperatureSetting |
This trait covers handling both temperature point and modes. | Thermostat Guide |