Поддержка особенностей API автоматизации на Android

API автоматизации для Android поддерживает большинство признаков, но поддержка некоторых атрибутов, событий и команд в признаке может быть ограничена.

Чтобы убедиться, что API автоматизации поддерживает ваш вариант использования, выполните поиск в таблице ниже.

В общем:

  • Все характеристики и типы, которые вы планируете использовать в приложении с API автоматизации, должны быть зарегистрированы при инициализации. См. раздел Создание экземпляра Home .
  • Любой атрибут может быть использован в стартерах или условиях.
  • Устройства Cloud-to-cloud не сообщающие о своем состоянии, не могут использоваться в качестве триггеров в автоматизациях, созданных вручную или посредством обнаружения.
  • Даже если устройство поддерживает перечисленные здесь характеристики, его использование в качестве стартера или действия в API автоматизации может быть заблокировано из-за пороговых значений качества отчета о состоянии :

    • Устройства с показателем успешности отчета о состоянии ниже 90% не могут использоваться в качестве стартеров.
    • Устройства с показателем успешности выполнения команд ниже 95% блокируются для использования в качестве действий.

    Ознакомьтесь с этим списком моделей устройств , а также конкретными пускателями и действиями, которые они поддерживают для API автоматизации.

  • Команды могут использоваться только как действия.

  • Некоторые черты, такие как AssistantBroadcast , доступны для использования только в API автоматизации.

  • Команда okGoogle действует на уровне структуры и может использоваться для автоматизации любого устройства в ней. Однако приложение Home API может иметь доступ не ко всем устройствам. Подробнее о применении разрешений OkGoogle в различных случаях см. в разделе «Разрешения».

  • Некоторые черты имеют предпосылки:

    • Для использования Time.ScheduledTimeEvent структура, в которой запускается автоматизация, должна иметь адрес, настроенный в Google Home app (GHA) . В разделе «Изменение адреса Google Home» объясняется, как ввести адрес структуры. Если адрес не настроен в GHA , автоматизация не создаётся и возникает ошибка «ScheduledTimeEvent не поддерживается structure ».
    • Чтобы использовать характеристики AreaPresenceState или AreaAttendanceState , пользователь должен настроить обнаружение присутствия в GHA .
    • Чтобы использовать функцию ObjectDetection , у пользователя должна быть активная подписка Nest Aware .

Упрощённые версии некоторых признаков также доступны для использования в автоматизациях. Подробнее см. в разделе «Упрощённые признаки на Android» .

Блокировка означает, что команда не поддерживается в автоматизациях для одного или нескольких типов устройств. Подробнее см. в статье Заблокированные действия в автоматизациях на Android .

Черта Тип черты Тип элемента Элемент
AssistantBroadcast Google Команда Транслировать
Помощник по выполнению заказов Google Команда Окей, Google
Уведомление Google Команда Отправить уведомления
Время Google Событие ScheduledTimeEvent
Время Google Атрибут текущее время
Время Google Атрибут отсутствуетСтруктураМестоположение
Время Google Атрибут время восхода солнца
Время Google Атрибут время заката
VoiceStarter Google Событие OkGoogleEvent
Качество воздуха иметь значение Атрибут Качество воздуха
ApplicationLauncher иметь значение Команда LaunchApp
ApplicationLauncher иметь значение Команда StopApp
ApplicationLauncher иметь значение Атрибут currentApp
Аудиовыход иметь значение Атрибут текущий выход
BooleanState иметь значение Событие StateChange
BooleanState иметь значение Атрибут stateValue
Измерение концентрации диоксида углерода иметь значение Атрибут levelValue
Измерение концентрации диоксида углерода иметь значение Атрибут измеренное значение
Измерение концентрации оксида углерода иметь значение Атрибут levelValue
Измерение концентрации оксида углерода иметь значение Атрибут максимальное измеренное значение
Измерение концентрации оксида углерода иметь значение Атрибут измеренное значение
Измерение концентрации оксида углерода иметь значение Атрибут единица измерения
Измерение концентрации оксида углерода иметь значение Атрибут минимальное измеренное значение
Измерение концентрации оксида углерода иметь значение Атрибут неопределенность
Канал иметь значение Команда ИзменитьКаналПоНомеру
Канал иметь значение Команда SkipChannel
ColorControl иметь значение Команда ColorLoopSet
ColorControl иметь значение Команда MoveColor
ColorControl иметь значение Команда ПеремещениеЦветовойТемпературы
ColorControl иметь значение Команда Переместить в цвет
ColorControl иметь значение Команда Переместить в цветовую температуру
ColorControl иметь значение Команда MoveToHue
ColorControl иметь значение Команда Переместить в оттенок и насыщенность
ColorControl иметь значение Команда MoveToSaturation
ColorControl иметь значение Команда StepColor
ColorControl иметь значение Команда StepColorTemperature
ColorControl иметь значение Атрибут цветТемператураМайреды
ColorControl иметь значение Атрибут текущий оттенок
ColorControl иметь значение Атрибут текущийX
ColorControl иметь значение Атрибут текущийY
Режим посудомоечной машины иметь значение Команда ChangeToMode
Режим посудомоечной машины иметь значение Атрибут текущий режим
Режим посудомоечной машины иметь значение Атрибут onMode
Дверной замок иметь значение Событие DoorLockAlarm
Дверной замок иметь значение Событие DoorStateChange
Дверной замок иметь значение Команда LockDoor
Дверной замок иметь значение Событие LockOperation
Дверной замок иметь значение Событие LockOperationError
Дверной замок иметь значение Команда РазблокироватьДверь
Дверной замок иметь значение Атрибут doorClosedEvents
Дверной замок иметь значение Атрибут doorOpenEvents
Дверной замок иметь значение Атрибут doorState
Дверной замок иметь значение Атрибут lockState
FanControl иметь значение Команда Шаг
FanControl иметь значение Атрибут Направление воздушного потока
FanControl иметь значение Атрибут fanMode
FanControl иметь значение Атрибут процентТекущий
FanControl иметь значение Атрибут процентная настройка
FanControl иметь значение Атрибут скоростьТок
FanControl иметь значение Атрибут speedSetting
FanControl иметь значение Атрибут Настройка ветра
Измерение концентрации формальдегида иметь значение Атрибут levelValue
Измерение концентрации формальдегида иметь значение Атрибут измеренное значение
Измерение освещенности иметь значение Атрибут измеренное значение
LaundryWasherMode иметь значение Команда ChangeToMode
LaundryWasherMode иметь значение Атрибут текущий режим
LaundryWasherMode иметь значение Атрибут onMode
LevelControl иметь значение Команда Двигаться
LevelControl иметь значение Команда Переместить на уровень
LevelControl иметь значение Команда MoveToLevelWithOnOff
LevelControl иметь значение Команда MoveWithOnOff
LevelControl иметь значение Команда Шаг
LevelControl иметь значение Команда StepWithOnOff
LevelControl иметь значение Команда Останавливаться
LevelControl иметь значение Команда StopWithOnOff
LevelControl иметь значение Атрибут текущийУровень
LevelControl иметь значение Атрибут максимальный уровень
LevelControl иметь значение Атрибут startUpCurrentLevel
MediaInput иметь значение Команда RenameInput
MediaInput иметь значение Команда SelectInput
MediaInput иметь значение Атрибут текущий вход
MediaPlayback иметь значение Команда FastForward
MediaPlayback иметь значение Команда Следующий
MediaPlayback иметь значение Команда Пауза
MediaPlayback иметь значение Команда Играть
MediaPlayback иметь значение Команда Предыдущий
MediaPlayback иметь значение Команда Перемотка назад
MediaPlayback иметь значение Команда SkipBackward
MediaPlayback иметь значение Команда Перейти вперед
MediaPlayback иметь значение Событие StateChanged
MediaPlayback иметь значение Команда Останавливаться
MediaPlayback иметь значение Атрибут текущее состояние
ModeSelect иметь значение Команда Блок ChangeToMode
ModeSelect иметь значение Атрибут текущий режим
ModeSelect иметь значение Атрибут onMode
Измерение концентрации диоксида азота иметь значение Атрибут levelValue
Измерение концентрации диоксида азота иметь значение Атрибут измеренное значение
Датчик присутствия иметь значение Атрибут занятость
ВклВыкл иметь значение Команда Офф -блок
ВклВыкл иметь значение Команда На блоке
ВклВыкл иметь значение Атрибут вклВыкл
OperationalState иметь значение Событие Завершение операции
OperationalState иметь значение Команда Блок паузы
OperationalState иметь значение Команда Блок резюме
OperationalState иметь значение Команда Начинать
OperationalState иметь значение Команда Останавливаться
OperationalState иметь значение Атрибут текущая фаза
OperationalState иметь значение Атрибут оперативное состояние
Измерение концентрации озона иметь значение Атрибут levelValue
Измерение концентрации озона иметь значение Атрибут измеренное значение
Измерение концентрации Pm10 иметь значение Атрибут levelValue
Измерение концентрации Pm10 иметь значение Атрибут измеренное значение
Измерение концентрации PM25 иметь значение Атрибут levelValue
Измерение концентрации PM25 иметь значение Атрибут измеренное значение
PowerSource иметь значение Атрибут batChargeState
PowerSource иметь значение Атрибут ТокЗарядкиБатареи
PowerSource иметь значение Атрибут batTimeToFullCharge
Измерение концентрации радона иметь значение Атрибут levelValue
Измерение концентрации радона иметь значение Атрибут измеренное значение
Измерение относительной влажности иметь значение Атрибут измеренное значение
RvcCleanMode иметь значение Команда ChangeToMode
RvcOperationalState иметь значение Команда Идидомой
RvcOperationalState иметь значение Команда Пауза
RvcOperationalState иметь значение Команда Резюме
RvcOperationalState иметь значение Атрибут текущая фаза
RvcOperationalState иметь значение Атрибут операционная ошибка
RvcOperationalState иметь значение Атрибут оперативное состояние
RvcRunMode иметь значение Команда ChangeToMode
RvcRunMode иметь значение Атрибут текущий режим
Выключатель иметь значение Событие InitialPress
Выключатель иметь значение Событие LongPress
Выключатель иметь значение Событие LongRelease
Выключатель иметь значение Событие MultiPressComplete
Выключатель иметь значение Событие MultiPressOngoing
Выключатель иметь значение Событие Короткий выпуск
Выключатель иметь значение Событие SwitchLatched
Выключатель иметь значение Атрибут текущая позиция
Контроль температуры иметь значение Команда Блок SetTemperature
Контроль температуры иметь значение Атрибут макс.температура
Контроль температуры иметь значение Атрибут минТемпература
Контроль температуры иметь значение Атрибут выбранныйУровеньТемпературы
Контроль температуры иметь значение Атрибут заданная температура
Измерение температуры иметь значение Атрибут измеренное значение
Термостат иметь значение Команда SetpointRaiseLower
Термостат иметь значение Атрибут activePresetHandle
Термостат иметь значение Атрибут локальная температура
Термостат иметь значение Атрибут занятость
Термостат иметь значение Атрибут ЗанятаяУставкаОхлаждения
Термостат иметь значение Атрибут Занятая уставка нагрева
Термостат иметь значение Атрибут наружная температура
Термостат иметь значение Атрибут setpointChangeSource
Термостат иметь значение Атрибут systemMode
Термостат иметь значение Атрибут удержание заданной температуры
Термостат иметь значение Атрибут температураУставкаПродолжительностьУдержания
Термостат иметь значение Атрибут термостатRunningMode
Термостат иметь значение Атрибут термостатRunningState
Термостат иметь значение Атрибут незанятыйУставкаОхлаждения
Термостат иметь значение Атрибут незанятыйУставкаОтопления
Измерение общей концентрации летучих органических соединений иметь значение Атрибут levelValue
Измерение общей концентрации летучих органических соединений иметь значение Атрибут измеренное значение
WindowCovering иметь значение Команда DownOrClose
WindowCovering иметь значение Команда GoToLiftPercentage
WindowCovering иметь значение Команда GoToLiftValue
WindowCovering иметь значение Команда GoToTiltPercentage
WindowCovering иметь значение Команда GoToTiltValue
WindowCovering иметь значение Команда StopMotion
WindowCovering иметь значение Команда UpOrOpen
WindowCovering иметь значение Атрибут currentPositionLift
WindowCovering иметь значение Атрибут currentPositionLiftPercent100ths
WindowCovering иметь значение Атрибут currentPositionLiftPercentage
WindowCovering иметь значение Атрибут currentPositionTilt
WindowCovering иметь значение Атрибут currentPositionTiltPercent100ths
WindowCovering иметь значение Атрибут currentPositionTiltPercentage
WindowCovering иметь значение Атрибут targetPositionLiftPercent100ths
WindowCovering иметь значение Атрибут targetPositionTiltPercent100ths
ArmDisarm Google Команда Блок ArmDisarm
ArmDisarm Google Событие ArmDisarmArmState
ArmDisarm Google Атрибут armState
ArmDisarm Google Атрибут currentArmLevel
ArmDisarm Google Атрибут Вооружен
Док Google Команда Док
Док Google Атрибут пристыкован
DoorbellPress Google Событие Дверной звонок нажат
ExtendedAirQuality Google Событие Качество воздуха
ExtendedAirQuality Google Атрибут Качество воздуха в помещении
ExtendedAirQuality Google Атрибут ЗначениеIndoorMeasuredValue
ExtendedAirQuality Google Атрибут измеренное значение
ExtendedAirQuality Google Атрибут outdoorAirQuality
ExtendedAirQuality Google Атрибут outdoorMeasuredValue
ExtendedColorControl Google Команда MoveToColorHSV
ExtendedColorControl Google Команда MoveToColorName
ExtendedColorControl Google Команда MoveToColorRGB
ExtendedColorControl Google Атрибут currentBlue
ExtendedColorControl Google Атрибут currentGreen
ExtendedColorControl Google Атрибут текущий оттенок
ExtendedColorControl Google Атрибут currentName
ExtendedColorControl Google Атрибут currentRed
ExtendedColorControl Google Атрибут текущаяНасыщенность
ExtendedColorControl Google Атрибут текущее значение
ExtendedFanControl Google Команда Переключить направление воздушного потока
ExtendedFanControl Google Атрибут customFanMode
ExtendedFanControl Google Атрибут customFanModes
ExtendedMediaInput Google Команда СледующийВход
ExtendedMediaInput Google Команда ПредыдущийВход
ExtendedMediaInput Google Команда ВыберитеCustomInput
ExtendedMediaInput Google Атрибут currentCustomInput
ExtendedMediaInput Google Атрибут customInputsList
ExtendedMediaInput Google Атрибут customInputsOrdered
Расширенное рабочее состояние Google Событие ПаузаВозобновитьПаузаПродолжить
Расширенное рабочее состояние Google Событие StartStopFollowUp
ExtendedPowerSource Google Команда Начало зарядки
ExtendedPowerSource Google Команда StopCharging
Расширенный термостат Google Атрибут activePresetHandle
Расширенный термостат Google Атрибут activeRemoteTemperatureSensorIds
Расширенный термостат Google Атрибут средняя местная температура
Расширенный термостат Google Атрибут расширенный режим работы
Расширенный термостат Google Атрибут расширенныйсистемныйрежим
Световые эффекты Google Команда PulseEffectSet
Световые эффекты Google Команда SleepEffectSet
Световые эффекты Google Команда StopEffect
Световые эффекты Google Команда WakeEffectSet
Световые эффекты Google Атрибут pulseEffectSet
Световые эффекты Google Атрибут sleepEffectSet
Световые эффекты Google Атрибут wakeEffectSet
БлокировкаРазблокировка Google Команда Замок
БлокировкаРазблокировка Google Команда Разблокировать блок
БлокировкаРазблокировка Google Атрибут lockState
Обнаружение движения Google Событие Обнаружено движение
Обнаружение движения Google Атрибут motionDetectionEventInProgress
Обнаружение объектов Google Событие Объект обнаружен
ОткрытьЗакрыть Google Команда Закрыть блок
ОткрытьЗакрыть Google Команда Блок GoToOpenPercentage
ОткрытьЗакрыть Google Команда Открытый блок
ОткрытьЗакрыть Google Команда Шаговый блок
ОткрытьЗакрыть Google Атрибут openPercent
ОткрытьЗакрыть Google Атрибут openState
ОткрытьЗакрыть Google Атрибут targetOpenPercent
Переключатели Google Команда Блок ChangeToggleSettings
Переключатели Google Атрибут currentToggleSettings
Яркость Google Команда BrightnessStep
Яркость Google Команда Переместить к яркости
Яркость Google Атрибут currentBrightnessPercent
УпрощенныйВклВыкл Google Атрибут вклВыкл
Упрощенный термостат Google Команда SetSystemMode
Упрощенный термостат Google Атрибут systemMode
Объем Google Команда Переместить в том
Объем Google Команда Немой
Объем Google Команда Включить звук
Объем Google Команда VolumeStep
Объем Google Атрибут currentVolumePercent
Объем Google Атрибут isMuted
РайонПосещаемостьШтат Google Атрибут посещаемостьState
ОбластьПрисутствияШтат Google Атрибут присутствиегосударство