Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.

Особенности умного домашнего устройства

Функциональность типов устройств зависит от характеристик, которые вы добавляете к каждому из них. Каждый тип устройства имеет ряд рекомендуемых характеристик, но вы можете добавить любые из них. Вторичная проверка пользователя поддерживается для всех характеристик устройства.

См. список поддерживаемых языков для всех признаков.

Имя Признак устройства Описание Рекомендуемые типы устройств
Выбор приложений action.devices.traits.AppSelector Эта черта относится к устройствам, которые поддерживают мультимедийные приложения, как правило, от третьих сторон. Мультимедийные устройства, поддерживающие запуск, установку и поиск приложений, работающих на устройстве.
Постановка на охрану action.devices.traits.ArmDisarm Этот трейт поддерживает постановку и снятие с охраны, как это используется, например, в системах безопасности. Охранные системы или любое устройство, поддерживающее постановку и снятие с охраны.
Яркость action.devices.traits.Brightness Настройка абсолютной яркости находится в нормализованном диапазоне от 0 до 100 (отдельные источники света могут не поддерживать каждую точку в диапазоне в зависимости от конфигурации их светодиодов). Свет
CameraStream action.devices.traits.CameraStream Эта черта относится к устройствам, которые имеют возможность потоковой передачи видео на сторонние экраны, экраны, подключенные к Chromecast, или смартфоны. По большому счету, это камеры слежения или детские камеры. Но эта черта распространяется и на более сложные устройства, на которых есть камера (например, устройства для видеоконференций или робот-пылесос с камерой). Камера
Канал action.devices.traits.Channel Эта черта относится к устройствам, которые поддерживают телеканалы на медиа-устройстве. Телевидение
Настройка цвета action.devices.traits.ColorSetting Эта черта применяется к таким устройствам, как интеллектуальные источники света, которые могут изменять цвет или цветовую температуру. Свет
Цветовой Спектр action.devices.traits.ColorSpectrum Это относится к «полноцветным» лампам, использующим цветовой диапазон RGB. Источники света могут иметь любую комбинацию ColorSpectrum и ColorTemperature . Акцентные лампы и светодиодные ленты могут иметь только спектр, тогда как некоторые лампы для чтения имеют только температуру. Обычные лампочки или тупые лампочки на умных розетках не имеют ни того, ни другого. Свет
Цветовая температура action.devices.traits.ColorTemperature Это относится к «теплым» лампочкам с цветовой точкой в ​​Кельвинах. Как правило, это отдельная от ColorSpectrum модальность, и могут быть белые точки, доступные через Temperature, которые не могут быть достигнуты Spectrum. Основываясь на доступных характеристиках, Google может выбрать подходящий режим для использования в зависимости от запроса и типа освещения (например, «Сделать освещение в гостиной белым» может отправлять команды «Температура» на некоторые лампочки и команды «Спектр» на светодиодные ленты). Свет
Готовить action.devices.traits.Cook Эта черта относится к устройствам, которые могут готовить еду в соответствии с различными предустановками блюд и поддерживаемыми режимами приготовления. Устройства, поддерживающие приготовление различных видов пищи.
Раздать action.devices.traits.Dispense Эта черта относится к устройствам, поддерживающим выдачу определенного количества одного или нескольких физических предметов. Например, дозатор лакомства для собак может выдавать несколько лакомств, кран может выдавать чашки с водой, а кормушка для домашних животных может выдавать как воду, так и корм для домашних животных. Устройства, поддерживающие выдачу определенного количества одного или нескольких физических предметов.
Док action.devices.traits.Dock Эта черта предназначена для мобильных устройств, которым можно приказать вернуться для зарядки. Вакуум
Хранилище энергии action.devices.traits.EnergyStorage Эта черта принадлежит устройствам, которые могут накапливать энергию в батарее и потенциально перезаряжаться, или устройствам, которые могут заряжать другое устройство. Черта поддерживает запуск и остановку зарядки, а также проверку текущего уровня заряда, оставшейся емкости и емкости до полного значения. Устройства, которые могут заряжать свою батарею.
Скорость вентилятора action.devices.traits.FanSpeed Эта черта относится к устройствам, поддерживающим настройку скорости вентилятора (то есть выдувание воздуха из устройства на разных уровнях, которое может быть частью кондиционера или обогревателя, или в автомобиле), с такими настройками, как низкая, средние и высокие.
Наполнять action.devices.traits.Fill Эта черта применяется к устройствам, поддерживающим наполнение, например к ванне. Любое устройство, поддерживающее наполнение, например ванна.
Настройка влажности action.devices.traits.HumiditySetting Эта черта относится к устройствам, поддерживающим настройки влажности, таким как увлажнители и осушители. Любое устройство, поддерживающее настройки влажности, например увлажнитель или осушитель.
ВходСелектор action.devices.traits.InputSelector Черта для устройств, которые могут менять медиа-входы. Эти входы могут иметь динамические имена для каждого устройства и могут представлять собой аудио- или видеопотоки, проводные или сетевые. Любое мультимедийное устройство, поддерживающее переключение входов.
Световые эффекты action.devices.traits.LightEffects Эта черта принадлежит устройствам, которые могут поддерживать сложные команды освещения для изменения состояния, например циклическое перебор различных цветов. Свет
локатор action.devices.traits.Locator Эта черта используется для устройств, которые можно «найти». Сюда входят телефоны, роботы (в том числе пылесосы и газонокосилки), дроны и продукты для конкретных тегов, которые подключаются к другим устройствам. Любое устройство, которое необходимо найти, например, робот- пылесос .
ЗаблокироватьРазблокировать action.devices.traits.LockUnlock Эта черта относится к любым устройствам, которые поддерживают блокировку и разблокировку и/или сообщают о заблокированном состоянии. Любое устройство, которое поддерживает блокировку и разблокировку и/или сообщает о заблокированном состоянии.
Медиастате action.devices.traits.MediaState Эта черта используется для устройств, которые могут сообщать о состоянии мультимедиа. Любое мультимедийное устройство, способное сообщать о состоянии мультимедиа.
Режимы action.devices.traits.Modes Эта черта принадлежит любым устройствам с произвольным количеством «n-way» режимов, в которых режимы и настройки для каждого режима произвольны и уникальны для каждого устройства или типа устройства. Каждый режим имеет несколько возможных настроек, но одновременно можно выбрать только одну; сушилка не может одновременно находиться в «деликатном», «нормальном» и «тяжелом режиме». Параметр, который можно просто включить или выключить, относится к свойству Toggles . Любой
Сетевой контроль action.devices.traits.NetworkControl Эта черта относится к устройствам, которые поддерживают передачу сетевых данных и выполнение специфических сетевых операций. Устройства, которые могут передавать сетевые данные и выполнять определенные сетевые операции.
Обнаружение объектов action.devices.traits.ObjectDetection Эта черта относится к устройствам, которые могут обнаруживать объекты или людей и отправлять уведомление пользователю. Например, его можно использовать для дверных звонков, чтобы указать, что человек (названный или неназванный) звонил в дверь, а также для камер и датчиков, которые могут обнаруживать движение объектов или приближающихся людей. Устройства, которые могут обнаруживать объекты или людей и отправлять уведомление пользователю.
Датчик присутствия action.devices.traits.OccupancySensing Эта черта принадлежит устройствам, которые могут обнаруживать присутствие человека с помощью инфракрасного, ультразвукового или физического контакта. Устройства, которые могут обнаруживать присутствие людей с помощью инфракрасного, ультразвукового или физического датчика контакта.
Вкл выкл action.devices.traits.OnOff Основные функции включения и выключения для любого устройства с двоичным включением и выключением, включая вилки и переключатели, а также многие будущие устройства.
Открыто закрыто action.devices.traits.OpenClose Эта черта относится к устройствам, которые поддерживают открытие и закрытие, а в некоторых случаях частичное или потенциальное открытие и закрытие более чем в одном направлении. Например, некоторые жалюзи могут открываться либо влево, либо вправо. В некоторых случаях открытие определенных устройств может быть важным действием с точки зрения безопасности, для которого может потребоваться двухфакторная аутентификация. См. Двухфакторная аутентификация . Любое устройство, поддерживающее открытие и закрытие.
Перезагрузить action.devices.traits.Reboot Эта черта принадлежит устройствам, поддерживающим перезагрузку, например маршрутизаторам. Устройство должно поддерживать перезагрузку как одно действие. Любое устройство, поддерживающее перезагрузку.
Вращение action.devices.traits.Rotation Эта особенность свойственна устройствам, поддерживающим вращение, например, жалюзи с вращающимися ламелями. Устройства, поддерживающие вращение, такие как жалюзи с вращающимися ламелями.
RunCycle action.devices.traits.RunCycle Эта черта представляет любое устройство, для которого есть непрерывная продолжительность его работы, которую можно запросить. Это включает, но не ограничивается, устройства, которые работают циклически, такие как стиральные машины, сушилки и посудомоечные машины. Любые — в основном бытовые приборы и другие устройства, находящиеся в рабочем состоянии.
СенсорСтате action.devices.traits.SensorState Этот признак охватывает как количественное измерение (например, индекс качества воздуха или уровень задымленности), так и качественное состояние (например, является ли качество воздуха здоровым или уровень задымления низкий или высокий). Датчики, которые обеспечивают количественные измерения (например, уровень задымленности) и качественное состояние (здоровое ли качество воздуха)
Сцена action.devices.traits.Scene В случае сцен тип сопоставляется с чертой 1:1, поскольку сцены не объединяются с другими чертами для формирования составных устройств. Только сцена
Обновление программного обеспечения action.devices.traits.SoftwareUpdate Эта черта относится к устройствам, поддерживающим обновления программного обеспечения, таким как маршрутизатор. Любое устройство, которое поддерживает обновления программного обеспечения.
СтартСтоп action.devices.traits.StartStop Запуск и остановка устройства выполняют ту же функцию, что и его включение и выключение. Устройства, унаследовавшие эту черту, функционируют по-разному при включении и запуске. В отличие от устройств, которые просто находятся в состоянии включения и выключения, некоторые устройства, которые могут запускаться и останавливаться, также могут приостанавливаться во время выполнения операции. Любые - в основном бытовая техника, пылесосы и другие вещи, которые имеют специфическое поведение сверх мощности.
Отчет action.devices.traits.StatusReport Эта черта сообщает о текущем статусе или состоянии определенного устройства или подключенной группы устройств. Признак общего назначения для сообщения о текущем статусе или состоянии определенного устройства или подключенной группы устройств, таких как система безопасности)
Контроль температуры action.devices.traits.TemperatureControl Свойство для устройств (кроме термостатов), которые поддерживают контроль температуры внутри или вокруг устройства. Сюда входят такие устройства, как печи и холодильники.
Настройка температуры action.devices.traits.TemperatureSetting Эта черта охватывает обработку как температурной точки, так и режимов.
Таймер action.devices.traits.Timer Черта Timer представляет собой таймер на устройстве, в первую очередь на кухонных приборах, таких как духовки и микроволновые печи, но не ограничиваясь ими. Любое устройство с таймером, например кухонная техника, например, микроволновая печь или духовка.
Переключает action.devices.traits.Toggles Эта черта относится к любым устройствам с настройками, которые могут существовать только в одном из двух состояний. Эти настройки могут представлять собой физическую кнопку с включенным/выключенным или активным/неактивным состоянием, флажок в HTML или любой другой тип специально включенного/отключенного элемента. Любой
ТранспортКонтроль action.devices.traits.TransportControl Эта черта поддерживает мультимедийные устройства, которые могут управлять воспроизведением мультимедиа (например, возобновлять приостановленную музыку). Устройства поддерживают двустороннюю аудиосвязь со сторонними устройствами.
Объем action.devices.traits.Volume Эта черта относится к устройствам, которые могут изменять громкость (например, устанавливать громкость на определенный уровень, отключать или включать звук). Медиа-устройства, способные изменять громкость.

Поддерживаемые языки

Следующие языки поддерживаются для всех вышеперечисленных признаков:

  • датский ( da )
  • голландский ( nl )
  • английский ( en )
  • французский ( fr )
  • немецкий ( de )
  • Хинди ( hi )
  • Индонезийский ( id )
  • итальянский ( it )
  • Японский ( ja )
  • Корейский ( ko )
  • норвежский ( no )
  • Португальский ( pt-BR )
  • испанский ( es )
  • Шведский ( sv )
  • Тайский ( th )
  • Китайский ( zh-TW )