Характеристики устройства
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Функциональность типов устройств зависит от характеристик, которые вы добавляете к каждому из них. Каждый тип устройства имеет ряд рекомендуемых характеристик, но вы можете добавить любые из них.
| Имя | Характеристики устройства | Описание | Рекомендуемые типы устройств |
|---|
| Яркость | action.devices.traits.Brightness | Настройка абсолютной яркости находится в нормализованном диапазоне от 0 до 100 (отдельные источники света могут не поддерживать каждую точку в диапазоне в зависимости от конфигурации их светодиодов). | Световод |
| Цветовой Спектр | action.devices.traits.ColorSpectrum | Это относится к «полноцветным» лампам, использующим цветовой диапазон RGB. Светильники могут иметь любую комбинацию ColorSpectrum и ColorTemperature ; акцентные лампы и светодиодные ленты могут иметь только Spectrum, тогда как некоторые лампы для чтения имеют только Temperature. Обычные лампочки или тупые лампочки на умных розетках не имеют ни того, ни другого. | Световод |
| Цветовая температура | action.devices.traits.ColorTemperature | Это относится к «теплым» лампочкам с цветовой точкой в Кельвинах. Как правило, это отдельная от ColorSpectrum модальность, и могут быть белые точки, доступные через Temperature, которые не могут быть достигнуты Spectrum. Основываясь на доступных характеристиках, Google может выбрать подходящий режим для использования в зависимости от запроса и типа освещения (например, «Сделать освещение в гостиной белым» может отправлять команды «Температура» на некоторые лампочки и команды «Спектр» на светодиодные ленты). | Световод |
| Док | action.devices.traits.Dock | Эта черта предназначена для мобильных устройств, которым можно приказать вернуться для зарядки. | Различные приборы |
| Вкл выкл | action.devices.traits.OnOff | Основные функции включения и выключения для любого устройства с двоичным включением и выключением, включая вилки и переключатели, а также многие будущие устройства. | Световод |
| СтартСтоп | action.devices.traits.StartStop | Запуск и остановка устройства выполняют ту же функцию, что и его включение и выключение. Устройства, унаследовавшие эту черту, функционируют по-разному при включении и запуске. В отличие от устройств, которые просто находятся в состоянии включения и выключения, некоторые устройства, которые могут запускаться и останавливаться, также могут приостанавливаться во время выполнения операции. | Любые - в основном бытовая техника, пылесосы и другие вещи, которые имеют специфическое поведение сверх мощности. |
| Настройка температуры | action.devices.traits.TemperatureSetting | Эта черта охватывает обработку как температурной точки, так и режимов. | Руководство по термостату |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-09-24 UTC.
[null,null,["Последнее обновление: 2024-09-24 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) |"]]
