Compatibilidad con atributos de la API de Automation en Android

La API de Automation para Android admite la mayoría de los rasgos, pero la compatibilidad con algunos atributos, eventos y comandos de un rasgo puede ser limitada.

Para verificar que la API de Automation admita tu caso de uso, busca en la siguiente tabla.

En general, debes hacer lo siguiente:

  • Todos los tipos y rasgos que pretendas usar en tu app con la API de Automation deben registrarse durante la inicialización. Consulta Cómo crear una instancia de Home.
  • Se puede usar cualquier atributo en los activadores o las condiciones.
  • Los dispositivos Cloud-to-cloud que no informan su estado no se pueden usar como activadores en automatizaciones, ya sea que se creen de forma manual o a través del descubrimiento.
  • Incluso si un dispositivo admite los rasgos que se indican aquí, es posible que se bloquee su uso como activador o acción en la API de Automation debido a los umbrales de calidad de Report State:

    • Los dispositivos con una tasa de éxito de Report State inferior al 90% no se pueden usar como dispositivos de inicio.
    • Los dispositivos con una tasa de éxito de ejecución de comandos inferior al 95% no se pueden usar como acciones.

    Consulta esta lista de modelos de dispositivos y los activadores y las acciones específicos que admiten para la API de Automations.

  • Los comandos solo se pueden usar como acciones.

  • Algunos rasgos, como AssistantBroadcast, solo están disponibles para su uso en la API de Automation.

  • El comando okGoogle es un comando a nivel de la estructura y se puede usar para automatizar cualquier dispositivo de la estructura. Sin embargo, es posible que una app de las APIs de Home no tenga acceso a todos los dispositivos. Consulta Permisos de Ok Google para ver cómo se aplican los permisos en varios casos.

  • Algunos rasgos tienen requisitos previos:

    • Para usar Time.ScheduledTimeEvent, la estructura en la que se ejecuta la automatización debe tener una dirección que se haya configurado en Google Home app (GHA). En Cómo cambiar la dirección de tu casa en Google, se explica cómo un usuario puede ingresar la dirección de la estructura. Si la dirección no está configurada en GHA, no se podrá crear la automatización y se mostrará un error con el mensaje "structure no admite ScheduledTimeEvent".
    • Para usar los rasgos AreaPresenceState o AreaAttendanceState, el usuario debe configurar la detección de presencia en GHA.
    • Para usar el rasgo ObjectDetection, el usuario debe tener una suscripción activa a Nest Aware.

También hay versiones simplificadas de algunos rasgos disponibles para su uso en automatizaciones. Para obtener más información, consulta Rasgos simplificados en Android.

Un bloque indica que el comando no es compatible con las automatizaciones para uno o más tipos de dispositivos. Para obtener más información, consulta Acciones bloqueadas en automatizaciones en Android.

Rasgo Tipo de rasgo Tipo de elemento Elemento
AssistantBroadcast google Comando Anuncio
AssistantFulfillment google Comando OkGoogle
Notificación google Comando SendNotifications
Hora google Evento ScheduledTimeEvent
Hora google Atributo currentTime
Hora google Atributo missingStructureLocation
Hora google Atributo sunriseTime
Hora google Atributo sunsetTime
VoiceStarter google Evento OkGoogleEvent
AirQuality Matter Atributo airQuality
ApplicationLauncher Matter Comando LaunchApp
ApplicationLauncher Matter Comando StopApp
ApplicationLauncher Matter Atributo currentApp
AudioOutput Matter Atributo currentOutput
BooleanState Matter Evento StateChange
BooleanState Matter Atributo stateValue
CarbonDioxideConcentrationMeasurement Matter Atributo levelValue
CarbonDioxideConcentrationMeasurement Matter Atributo measuredValue
CarbonMonoxideConcentrationMeasurement Matter Atributo levelValue
CarbonMonoxideConcentrationMeasurement Matter Atributo maxMeasuredValue
CarbonMonoxideConcentrationMeasurement Matter Atributo measuredValue
CarbonMonoxideConcentrationMeasurement Matter Atributo measurementUnit
CarbonMonoxideConcentrationMeasurement Matter Atributo minMeasuredValue
CarbonMonoxideConcentrationMeasurement Matter Atributo uncertainty
Canal Matter Comando ChangeChannelByNumber
Canal Matter Comando SkipChannel
ColorControl Matter Comando ColorLoopSet
ColorControl Matter Comando MoveColor
ColorControl Matter Comando MoveColorTemperature
ColorControl Matter Comando MoveToColor
ColorControl Matter Comando MoveToColorTemperature
ColorControl Matter Comando MoveToHue
ColorControl Matter Comando MoveToHueAndSaturation
ColorControl Matter Comando MoveToSaturation
ColorControl Matter Comando StepColor
ColorControl Matter Comando StepColorTemperature
ColorControl Matter Atributo colorTemperatureMireds
ColorControl Matter Atributo currentHue
ColorControl Matter Atributo currentX
ColorControl Matter Atributo currentY
DishwasherMode Matter Comando ChangeToMode
DishwasherMode Matter Atributo currentMode
DishwasherMode Matter Atributo onMode
DoorLock Matter Evento DoorLockAlarm
DoorLock Matter Evento DoorStateChange
DoorLock Matter Comando LockDoor
DoorLock Matter Evento LockOperation
DoorLock Matter Evento LockOperationError
DoorLock Matter Comando UnlockDoor
DoorLock Matter Atributo doorClosedEvents
DoorLock Matter Atributo doorOpenEvents
DoorLock Matter Atributo doorState
DoorLock Matter Atributo lockState
FanControl Matter Comando Step
FanControl Matter Atributo airflowDirection
FanControl Matter Atributo fanMode
FanControl Matter Atributo percentCurrent
FanControl Matter Atributo percentSetting
FanControl Matter Atributo speedCurrent
FanControl Matter Atributo speedSetting
FanControl Matter Atributo windSetting
FormaldehydeConcentrationMeasurement Matter Atributo levelValue
FormaldehydeConcentrationMeasurement Matter Atributo measuredValue
IlluminanceMeasurement Matter Atributo measuredValue
LaundryWasherMode Matter Comando ChangeToMode
LaundryWasherMode Matter Atributo currentMode
LaundryWasherMode Matter Atributo onMode
LevelControl Matter Comando Mover
LevelControl Matter Comando MoveToLevel
LevelControl Matter Comando MoveToLevelWithOnOff
LevelControl Matter Comando MoveWithOnOff
LevelControl Matter Comando Step
LevelControl Matter Comando StepWithOnOff
LevelControl Matter Comando Detener
LevelControl Matter Comando StopWithOnOff
LevelControl Matter Atributo currentLevel
LevelControl Matter Atributo maxLevel
LevelControl Matter Atributo startUpCurrentLevel
MediaInput Matter Comando RenameInput
MediaInput Matter Comando SelectInput
MediaInput Matter Atributo currentInput
MediaPlayback Matter Comando FastForward
MediaPlayback Matter Comando Siguiente
MediaPlayback Matter Comando Pausar
MediaPlayback Matter Comando Reproducir
MediaPlayback Matter Comando Anterior
MediaPlayback Matter Comando Retroceder
MediaPlayback Matter Comando SkipBackward
MediaPlayback Matter Comando SkipForward
MediaPlayback Matter Evento StateChanged
MediaPlayback Matter Comando Detener
MediaPlayback Matter Atributo currentState
ModeSelect Matter Comando ChangeToMode block
ModeSelect Matter Atributo currentMode
ModeSelect Matter Atributo onMode
NitrogenDioxideConcentrationMeasurement Matter Atributo levelValue
NitrogenDioxideConcentrationMeasurement Matter Atributo measuredValue
OccupancySensing Matter Atributo occupancy
OnOff Matter Comando Off block
OnOff Matter Comando On block
OnOff Matter Atributo onOff
OperationalState Matter Evento OperationCompletion
OperationalState Matter Comando Pausar bloque
OperationalState Matter Comando Reanudar bloque
OperationalState Matter Comando Comenzar
OperationalState Matter Comando Detener
OperationalState Matter Atributo currentPhase
OperationalState Matter Atributo operationalState
OzoneConcentrationMeasurement Matter Atributo levelValue
OzoneConcentrationMeasurement Matter Atributo measuredValue
Pm10ConcentrationMeasurement Matter Atributo levelValue
Pm10ConcentrationMeasurement Matter Atributo measuredValue
Pm25ConcentrationMeasurement Matter Atributo levelValue
Pm25ConcentrationMeasurement Matter Atributo measuredValue
PowerSource Matter Atributo batChargeState
PowerSource Matter Atributo batChargingCurrent
PowerSource Matter Atributo batTimeToFullCharge
RadonConcentrationMeasurement Matter Atributo levelValue
RadonConcentrationMeasurement Matter Atributo measuredValue
RelativeHumidityMeasurement Matter Atributo measuredValue
RvcCleanMode Matter Comando ChangeToMode
RvcOperationalState Matter Comando GoHome
RvcOperationalState Matter Comando Pausar
RvcOperationalState Matter Comando Reanudar
RvcOperationalState Matter Atributo currentPhase
RvcOperationalState Matter Atributo operationalError
RvcOperationalState Matter Atributo operationalState
RvcRunMode Matter Comando ChangeToMode
RvcRunMode Matter Atributo currentMode
Interruptor Matter Evento InitialPress
Interruptor Matter Evento LongPress
Interruptor Matter Evento LongRelease
Interruptor Matter Evento MultiPressComplete
Interruptor Matter Evento MultiPressOngoing
Interruptor Matter Evento ShortRelease
Interruptor Matter Evento SwitchLatched
Interruptor Matter Atributo currentPosition
TemperatureControl Matter Comando SetTemperature block
TemperatureControl Matter Atributo maxTemperature
TemperatureControl Matter Atributo minTemperature
TemperatureControl Matter Atributo selectedTemperatureLevel
TemperatureControl Matter Atributo temperatureSetpoint
TemperatureMeasurement Matter Atributo measuredValue
Termostato Matter Comando SetpointRaiseLower
Termostato Matter Atributo activePresetHandle
Termostato Matter Atributo localTemperature
Termostato Matter Atributo occupancy
Termostato Matter Atributo occupiedCoolingSetpoint
Termostato Matter Atributo occupiedHeatingSetpoint
Termostato Matter Atributo outdoorTemperature
Termostato Matter Atributo setpointChangeSource
Termostato Matter Atributo systemMode
Termostato Matter Atributo temperatureSetpointHold
Termostato Matter Atributo temperatureSetpointHoldDuration
Termostato Matter Atributo thermostatRunningMode
Termostato Matter Atributo thermostatRunningState
Termostato Matter Atributo unoccupiedCoolingSetpoint
Termostato Matter Atributo unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement Matter Atributo levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement Matter Atributo measuredValue
WindowCovering Matter Comando DownOrClose
WindowCovering Matter Comando GoToLiftPercentage
WindowCovering Matter Comando GoToLiftValue
WindowCovering Matter Comando GoToTiltPercentage
WindowCovering Matter Comando GoToTiltValue
WindowCovering Matter Comando StopMotion
WindowCovering Matter Comando UpOrOpen
WindowCovering Matter Atributo currentPositionLift
WindowCovering Matter Atributo currentPositionLiftPercent100ths
WindowCovering Matter Atributo currentPositionLiftPercentage
WindowCovering Matter Atributo currentPositionTilt
WindowCovering Matter Atributo currentPositionTiltPercent100ths
WindowCovering Matter Atributo currentPositionTiltPercentage
WindowCovering Matter Atributo targetPositionLiftPercent100ths
WindowCovering Matter Atributo targetPositionTiltPercent100ths
ArmDisarm google Comando ArmDisarm block
ArmDisarm google Evento ArmDisarmArmState
ArmDisarm google Atributo armState
ArmDisarm google Atributo currentArmLevel
ArmDisarm google Atributo isArmed
Estación de carga google Comando Estación de carga
Estación de carga 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 block
LockUnlock google Atributo lockState
MotionDetection google Evento MotionDetected
MotionDetection google Atributo motionDetectionEventInProgress
ObjectDetection google Evento ObjectDetected
OpenClose google Comando Cerrar block
OpenClose google Comando GoToOpenPercentage block
OpenClose google Comando Abrir bloque
OpenClose google Comando Step block
OpenClose google Atributo openPercent
OpenClose google Atributo openState
OpenClose google Atributo targetOpenPercent
Activadores google Comando ChangeToggleSettings block
Activadores google Atributo currentToggleSettings
Brillo google Comando BrightnessStep
Brillo google Comando MoveToBrightness
Brillo google Atributo currentBrightnessPercent
SimplifiedOnOff google Atributo onOff
SimplifiedThermostat google Comando SetSystemMode
SimplifiedThermostat google Atributo systemMode
Volumen google Comando MoveToVolume
Volumen google Comando Silenciar
Volumen google Comando Activar sonido
Volumen google Comando VolumeStep
Volumen google Atributo currentVolumePercent
Volumen google Atributo isMuted
AreaAttendanceState google Atributo attendanceState
AreaPresenceState google Atributo presenceState