Suporte a traços da API Automation no Android

A API Automation para Android oferece suporte à maioria das características, mas o suporte a alguns atributos, eventos e comandos em uma característica pode ser limitado.

Para verificar se a API Automation é compatível com seu caso de uso, pesquise na tabela abaixo.

Em geral:

  • Todas as características e tipos que você pretende usar no seu app com a API Automation precisam ser registrados na inicialização. Consulte Criar uma instância do Home.
  • Qualquer atributo pode ser usado em ativadores ou condições.
  • Os dispositivos Cloud-to-cloud que não informam o estado não podem ser usados como acionadores em automações criadas manualmente ou por descoberta.
  • Mesmo que um dispositivo seja compatível com as características listadas aqui, ele pode ser bloqueado para uso como um iniciador ou uma ação na API Automation devido a limiares de qualidade do Report State:

    • Dispositivos com uma taxa de sucesso de Report State inferior a 90% são bloqueados para uso como iniciadores.
    • Dispositivos com uma taxa de sucesso de execução de comandos inferior a 95% não podem ser usados como ações.

    Consulte esta lista de modelos de dispositivos e as ativações e ações específicas compatíveis com a API Automations.

  • Os comandos só podem ser usados como ações.

  • Alguns atributos, como AssistantBroadcast, estão disponíveis apenas para uso na API Automation.

  • O comando okGoogle é um comando no nível da estrutura e pode ser usado para automatizar qualquer dispositivo na estrutura. No entanto, um app de APIs Home pode não ter acesso a todos os dispositivos. Consulte as permissões do Ok Google para saber como elas são aplicadas em vários casos.

  • Algumas características têm pré-requisitos:

    • Para usar Time.ScheduledTimeEvent, a estrutura em que a automação é executada precisa ter um endereço de rua que foi configurado no Google Home app (GHA). Mudar o endereço residencial do Google explica como um usuário pode inserir o endereço da estrutura. Se o endereço não estiver configurado no GHA, a automação não será criada, e um erro será gerado com a mensagem "O ScheduledTimeEvent não é compatível com o structure".
    • Para usar os traços AreaPresenceState ou AreaAttendanceState, o usuário precisa configurar a detecção de presença no GHA.
    • Para usar o traço ObjectDetection, o usuário precisa ter uma assinatura ativa do Nest Aware.

Versões simplificadas de algumas características também estão disponíveis para uso em automações. Para mais informações, consulte Traços simplificados no Android.

Um bloqueio indica que o comando não é compatível com automações para um ou mais tipos de dispositivos. Para mais informações, consulte Ações bloqueadas em automações no Android.

Característica Tipo de característica Tipo de elemento Elemento
AssistantBroadcast google Comando Removido
AssistantFulfillment google Comando OkGoogle
Notificação google Comando SendNotifications
Tempo google Evento ScheduledTimeEvent
Tempo google Atributo currentTime
Tempo google Atributo missingStructureLocation
Tempo google Atributo sunriseTime
Tempo google Atributo sunsetTime
VoiceStarter google Evento OkGoogleEvent
AirQuality caso Atributo airQuality
ApplicationLauncher caso Comando LaunchApp
ApplicationLauncher caso Comando StopApp
ApplicationLauncher caso Atributo currentApp
AudioOutput caso Atributo currentOutput
BooleanState caso Evento StateChange
BooleanState caso Atributo stateValue
CarbonDioxideConcentrationMeasurement caso Atributo levelValue
CarbonDioxideConcentrationMeasurement caso Atributo measuredValue
CarbonMonoxideConcentrationMeasurement caso Atributo levelValue
CarbonMonoxideConcentrationMeasurement caso Atributo maxMeasuredValue
CarbonMonoxideConcentrationMeasurement caso Atributo measuredValue
CarbonMonoxideConcentrationMeasurement caso Atributo measurementUnit
CarbonMonoxideConcentrationMeasurement caso Atributo minMeasuredValue
CarbonMonoxideConcentrationMeasurement caso Atributo uncertainty
Canal caso Comando ChangeChannelByNumber
Canal caso Comando SkipChannel
ColorControl caso Comando ColorLoopSet
ColorControl caso Comando MoveColor
ColorControl caso Comando MoveColorTemperature
ColorControl caso Comando MoveToColor
ColorControl caso Comando MoveToColorTemperature
ColorControl caso Comando MoveToHue
ColorControl caso Comando MoveToHueAndSaturation
ColorControl caso Comando MoveToSaturation
ColorControl caso Comando StepColor
ColorControl caso Comando StepColorTemperature
ColorControl caso Atributo colorTemperatureMireds
ColorControl caso Atributo currentHue
ColorControl caso Atributo currentX
ColorControl caso Atributo currentY
DishwasherMode caso Comando ChangeToMode
DishwasherMode caso Atributo currentMode
DishwasherMode caso Atributo onMode
DoorLock caso Evento DoorLockAlarm
DoorLock caso Evento DoorStateChange
DoorLock caso Comando LockDoor
DoorLock caso Evento LockOperation
DoorLock caso Evento LockOperationError
DoorLock caso Comando UnlockDoor
DoorLock caso Atributo doorClosedEvents
DoorLock caso Atributo doorOpenEvents
DoorLock caso Atributo doorState
DoorLock caso Atributo lockState
FanControl caso Comando Etapa
FanControl caso Atributo airflowDirection
FanControl caso Atributo fanMode
FanControl caso Atributo percentCurrent
FanControl caso Atributo percentSetting
FanControl caso Atributo speedCurrent
FanControl caso Atributo speedSetting
FanControl caso Atributo windSetting
FormaldehydeConcentrationMeasurement caso Atributo levelValue
FormaldehydeConcentrationMeasurement caso Atributo measuredValue
IlluminanceMeasurement caso Atributo measuredValue
LaundryWasherMode caso Comando ChangeToMode
LaundryWasherMode caso Atributo currentMode
LaundryWasherMode caso Atributo onMode
LevelControl caso Comando Move
LevelControl caso Comando MoveToLevel
LevelControl caso Comando MoveToLevelWithOnOff
LevelControl caso Comando MoveWithOnOff
LevelControl caso Comando Etapa
LevelControl caso Comando StepWithOnOff
LevelControl caso Comando Parar
LevelControl caso Comando StopWithOnOff
LevelControl caso Atributo currentLevel
LevelControl caso Atributo maxLevel
LevelControl caso Atributo startUpCurrentLevel
MediaInput caso Comando RenameInput
MediaInput caso Comando SelectInput
MediaInput caso Atributo currentInput
MediaPlayback caso Comando FastForward
MediaPlayback caso Comando Próxima
MediaPlayback caso Comando Pausar
MediaPlayback caso Comando Tocar
MediaPlayback caso Comando Anterior
MediaPlayback caso Comando Voltar
MediaPlayback caso Comando SkipBackward
MediaPlayback caso Comando SkipForward
MediaPlayback caso Evento StateChanged
MediaPlayback caso Comando Parar
MediaPlayback caso Atributo currentState
ModeSelect caso Comando ChangeToMode block
ModeSelect caso Atributo currentMode
ModeSelect caso Atributo onMode
NitrogenDioxideConcentrationMeasurement caso Atributo levelValue
NitrogenDioxideConcentrationMeasurement caso Atributo measuredValue
OccupancySensing caso Atributo occupancy
OnOff caso Comando Desativado block
OnOff caso Comando Ativar bloqueio
OnOff caso Atributo onOff
OperationalState caso Evento OperationCompletion
OperationalState caso Comando Pausar block
OperationalState caso Comando Retomar bloco
OperationalState caso Comando Iniciar
OperationalState caso Comando Parar
OperationalState caso Atributo currentPhase
OperationalState caso Atributo operationalState
OzoneConcentrationMeasurement caso Atributo levelValue
OzoneConcentrationMeasurement caso Atributo measuredValue
Pm10ConcentrationMeasurement caso Atributo levelValue
Pm10ConcentrationMeasurement caso Atributo measuredValue
Pm25ConcentrationMeasurement caso Atributo levelValue
Pm25ConcentrationMeasurement caso Atributo measuredValue
PowerSource caso Atributo batChargeState
PowerSource caso Atributo batChargingCurrent
PowerSource caso Atributo batTimeToFullCharge
RadonConcentrationMeasurement caso Atributo levelValue
RadonConcentrationMeasurement caso Atributo measuredValue
RelativeHumidityMeasurement caso Atributo measuredValue
RvcCleanMode caso Comando ChangeToMode
RvcOperationalState caso Comando GoHome
RvcOperationalState caso Comando Pausar
RvcOperationalState caso Comando Retomar
RvcOperationalState caso Atributo currentPhase
RvcOperationalState caso Atributo operationalError
RvcOperationalState caso Atributo operationalState
RvcRunMode caso Comando ChangeToMode
RvcRunMode caso Atributo currentMode
Switch caso Evento InitialPress
Switch caso Evento LongPress
Switch caso Evento LongRelease
Switch caso Evento MultiPressComplete
Switch caso Evento MultiPressOngoing
Switch caso Evento ShortRelease
Switch caso Evento SwitchLatched
Switch caso Atributo currentPosition
TemperatureControl caso Comando SetTemperature block
TemperatureControl caso Atributo maxTemperature
TemperatureControl caso Atributo minTemperature
TemperatureControl caso Atributo selectedTemperatureLevel
TemperatureControl caso Atributo temperatureSetpoint
TemperatureMeasurement caso Atributo measuredValue
Termostato caso Comando SetpointRaiseLower
Termostato caso Atributo activePresetHandle
Termostato caso Atributo localTemperature
Termostato caso Atributo occupancy
Termostato caso Atributo occupiedCoolingSetpoint
Termostato caso Atributo occupiedHeatingSetpoint
Termostato caso Atributo outdoorTemperature
Termostato caso Atributo setpointChangeSource
Termostato caso Atributo systemMode
Termostato caso Atributo temperatureSetpointHold
Termostato caso Atributo temperatureSetpointHoldDuration
Termostato caso Atributo thermostatRunningMode
Termostato caso Atributo thermostatRunningState
Termostato caso Atributo unoccupiedCoolingSetpoint
Termostato caso Atributo unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement caso Atributo levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement caso Atributo measuredValue
WindowCovering caso Comando DownOrClose
WindowCovering caso Comando GoToLiftPercentage
WindowCovering caso Comando GoToLiftValue
WindowCovering caso Comando GoToTiltPercentage
WindowCovering caso Comando GoToTiltValue
WindowCovering caso Comando StopMotion
WindowCovering caso Comando UpOrOpen
WindowCovering caso Atributo currentPositionLift
WindowCovering caso Atributo currentPositionLiftPercent100ths
WindowCovering caso Atributo currentPositionLiftPercentage
WindowCovering caso Atributo currentPositionTilt
WindowCovering caso Atributo currentPositionTiltPercent100ths
WindowCovering caso Atributo currentPositionTiltPercentage
WindowCovering caso Atributo targetPositionLiftPercent100ths
WindowCovering caso Atributo targetPositionTiltPercent100ths
ArmDisarm google Comando ArmDisarm block
ArmDisarm google Evento ArmDisarmArmState
ArmDisarm google Atributo armState
ArmDisarm google Atributo currentArmLevel
ArmDisarm google Atributo isArmed
Ancorar google Comando Ancorar
Ancorar google Atributo isDocked
DoorbellPress google Evento DoorbellPressed
ExtendedAirQuality google Evento AirQuality
ExtendedAirQuality google Atributo indoorAirQuality
ExtendedAirQuality google Atributo indoorMeasuredValue
ExtendedAirQuality google Atributo measuredValue
ExtendedAirQuality google Atributo outdoorAirQuality
ExtendedAirQuality google Atributo outdoorMeasuredValue
ExtendedColorControl google Comando MoveToColorHSV
ExtendedColorControl google Comando MoveToColorName
ExtendedColorControl google Comando MoveToColorRGB
ExtendedColorControl google Atributo currentBlue
ExtendedColorControl google Atributo currentGreen
ExtendedColorControl google Atributo currentHue
ExtendedColorControl google Atributo currentName
ExtendedColorControl google Atributo currentRed
ExtendedColorControl google Atributo currentSaturation
ExtendedColorControl google Atributo currentValue
ExtendedFanControl google Comando ToggleAirflowDirection
ExtendedFanControl google Atributo customFanMode
ExtendedFanControl google Atributo customFanModes
ExtendedMediaInput google Comando NextInput
ExtendedMediaInput google Comando PreviousInput
ExtendedMediaInput google Comando SelectCustomInput
ExtendedMediaInput google Atributo currentCustomInput
ExtendedMediaInput google Atributo customInputsList
ExtendedMediaInput google Atributo customInputsOrdered
ExtendedOperationalState google Evento PauseUnpauseFollowUp
ExtendedOperationalState google Evento StartStopFollowUp
ExtendedPowerSource google Comando StartCharging
ExtendedPowerSource google Comando StopCharging
ExtendedThermostat google Atributo activePresetHandle
ExtendedThermostat google Atributo activeRemoteTemperatureSensorIds
ExtendedThermostat google Atributo averageLocalTemperature
ExtendedThermostat google Atributo extendedRunningMode
ExtendedThermostat google Atributo extendedSystemMode
LightEffects google Comando PulseEffectSet
LightEffects google Comando SleepEffectSet
LightEffects google Comando StopEffect
LightEffects google Comando WakeEffectSet
LightEffects google Atributo pulseEffectSet
LightEffects google Atributo sleepEffectSet
LightEffects google Atributo wakeEffectSet
LockUnlock google Comando Bloquear
LockUnlock google Comando Desbloquear bloqueio
LockUnlock google Atributo lockState
MotionDetection google Evento MotionDetected
MotionDetection google Atributo motionDetectionEventInProgress
ObjectDetection google Evento ObjectDetected
OpenClose google Comando Fechar block
OpenClose google Comando GoToOpenPercentage block
OpenClose google Comando Abrir bloco
OpenClose google Comando Etapa bloco
OpenClose google Atributo openPercent
OpenClose google Atributo openState
OpenClose google Atributo targetOpenPercent
Alternâncias google Comando ChangeToggleSettings block
Alternâncias google Atributo currentToggleSettings
Brilho google Comando BrightnessStep
Brilho google Comando MoveToBrightness
Brilho google Atributo currentBrightnessPercent
SimplifiedOnOff google Atributo onOff
SimplifiedThermostat google Comando SetSystemMode
SimplifiedThermostat google Atributo systemMode
Volume google Comando MoveToVolume
Volume google Comando Desativar som
Volume google Comando Ativar som
Volume google Comando VolumeStep
Volume google Atributo currentVolumePercent
Volume google Atributo isMuted
AreaAttendanceState google Atributo attendanceState
AreaPresenceState google Atributo presenceState