Prise en charge des traits de l'API Automation sur Android

L'API Automation pour Android est compatible avec la plupart des traits, mais la compatibilité avec certains attributs, événements et commandes d'un trait peut être limitée.

Pour vérifier que l'API Automation est compatible avec votre cas d'utilisation, effectuez une recherche dans le tableau ci-dessous.

En règle générale :

  • Tous les traits et types que vous prévoyez d'utiliser dans votre application avec l'API Automation doivent être enregistrés lors de l'initialisation. Consultez Créer une instance Home.
  • N'importe quel attribut peut être utilisé dans les déclencheurs ou les conditions.
  • Les appareils Cloud-to-cloud qui ne signalent pas leur état ne peuvent pas être utilisés comme déclencheurs dans les automatisations, qu'elles soient créées manuellement ou par découverte.
  • Même si un appareil est compatible avec les traits listés ici, il peut être bloqué et ne pas pouvoir être utilisé comme déclencheur ou action dans l'API Automation en raison des seuils de qualité de Report State :

    • Les appareils dont le taux de réussite de l'état du rapport est inférieur à 90 % ne peuvent pas être utilisés comme démarreurs.
    • Les appareils dont le taux de réussite de l'exécution des commandes est inférieur à 95 % ne peuvent pas être utilisés comme actions.

    Consultez cette liste des modèles d'appareils et les déclencheurs et actions spécifiques qu'ils prennent en charge pour l'API Automations.

  • Les commandes ne peuvent être utilisées que comme actions.

  • Certains traits, tels que AssistantBroadcast, ne sont disponibles que dans l'API Automation.

  • La commande okGoogle est une commande au niveau de la structure. Elle peut être utilisée pour automatiser n'importe quel appareil de la structure. Toutefois, il est possible qu'une application Home APIs n'ait pas accès à tous les appareils. Consultez Autorisations "Hey Google" pour savoir comment les autorisations sont appliquées dans différents cas.

  • Certains traits ont des prérequis :

    • Pour utiliser Time.ScheduledTimeEvent, la structure dans laquelle l'automatisation s'exécute doit avoir une adresse postale configurée dans Google Home app (GHA). L'article Modifier l'adresse de votre domicile sur Google explique comment un utilisateur peut saisir l'adresse de la structure. Si l'adresse n'est pas configurée dans GHA, l'automatisation ne peut pas être créée et une erreur s'affiche avec le message "The ScheduledTimeEvent is not supported by the structure" (structure n'est pas compatible avec ScheduledTimeEvent).
    • Pour utiliser les traits AreaPresenceState ou AreaAttendanceState, l'utilisateur doit configurer la détection de présence dans GHA.
    • Pour utiliser le trait ObjectDetection, l'utilisateur doit disposer d'un abonnement Nest Aware actif.

Des versions simplifiées de certains traits sont également disponibles pour être utilisées dans les automatisations. Pour en savoir plus, consultez Traits simplifiés sur Android.

Un bloc indique que la commande n'est pas compatible avec les automatisations pour un ou plusieurs types d'appareils. Pour en savoir plus, consultez Actions bloquées dans les automatisations sur Android.

Trait Type de caractéristique Type d'élément Élément
AssistantBroadcast google Commande Mégaphone
AssistantFulfillment google Commande OkGoogle
Notification google Commande SendNotifications
Heure google Événement ScheduledTimeEvent
Heure google Attribut currentTime
Heure google Attribut missingStructureLocation
Heure google Attribut sunriseTime
Heure google Attribut sunsetTime
VoiceStarter google Événement OkGoogleEvent
AirQuality matter Attribut airQuality
ApplicationLauncher matter Commande LaunchApp
ApplicationLauncher matter Commande StopApp
ApplicationLauncher matter Attribut currentApp
AudioOutput matter Attribut currentOutput
BooleanState matter Événement StateChange
BooleanState matter Attribut stateValue
CarbonDioxideConcentrationMeasurement matter Attribut levelValue
CarbonDioxideConcentrationMeasurement matter Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut levelValue
CarbonMonoxideConcentrationMeasurement matter Attribut maxMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut measuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut measurementUnit
CarbonMonoxideConcentrationMeasurement matter Attribut minMeasuredValue
CarbonMonoxideConcentrationMeasurement matter Attribut uncertainty
Canal matter Commande ChangeChannelByNumber
Canal matter Commande SkipChannel
ColorControl matter Commande ColorLoopSet
ColorControl matter Commande MoveColor
ColorControl matter Commande MoveColorTemperature
ColorControl matter Commande MoveToColor
ColorControl matter Commande MoveToColorTemperature
ColorControl matter Commande MoveToHue
ColorControl matter Commande MoveToHueAndSaturation
ColorControl matter Commande MoveToSaturation
ColorControl matter Commande StepColor
ColorControl matter Commande StepColorTemperature
ColorControl matter Attribut colorTemperatureMireds
ColorControl matter Attribut currentHue
ColorControl matter Attribut currentX
ColorControl matter Attribut currentY
DishwasherMode matter Commande ChangeToMode
DishwasherMode matter Attribut currentMode
DishwasherMode matter Attribut onMode
DoorLock matter Événement DoorLockAlarm
DoorLock matter Événement DoorStateChange
DoorLock matter Commande LockDoor
DoorLock matter Événement LockOperation
DoorLock matter Événement LockOperationError
DoorLock matter Commande UnlockDoor
DoorLock matter Attribut doorClosedEvents
DoorLock matter Attribut doorOpenEvents
DoorLock matter Attribut doorState
DoorLock matter Attribut lockState
FanControl matter Commande Step
FanControl matter Attribut airflowDirection
FanControl matter Attribut fanMode
FanControl matter Attribut percentCurrent
FanControl matter Attribut percentSetting
FanControl matter Attribut speedCurrent
FanControl matter Attribut speedSetting
FanControl matter Attribut windSetting
FormaldehydeConcentrationMeasurement matter Attribut levelValue
FormaldehydeConcentrationMeasurement matter Attribut measuredValue
IlluminanceMeasurement matter Attribut measuredValue
LaundryWasherMode matter Commande ChangeToMode
LaundryWasherMode matter Attribut currentMode
LaundryWasherMode matter Attribut onMode
LevelControl matter Commande Déplacer
LevelControl matter Commande MoveToLevel
LevelControl matter Commande MoveToLevelWithOnOff
LevelControl matter Commande MoveWithOnOff
LevelControl matter Commande Step
LevelControl matter Commande StepWithOnOff
LevelControl matter Commande Arrêter
LevelControl matter Commande StopWithOnOff
LevelControl matter Attribut currentLevel
LevelControl matter Attribut maxLevel
LevelControl matter Attribut startUpCurrentLevel
MediaInput matter Commande RenameInput
MediaInput matter Commande SelectInput
MediaInput matter Attribut currentInput
MediaPlayback matter Commande FastForward
MediaPlayback matter Commande Suivant
MediaPlayback matter Commande Pause
MediaPlayback matter Commande Lire
MediaPlayback matter Commande Précédent
MediaPlayback matter Commande Retour arrière
MediaPlayback matter Commande SkipBackward
MediaPlayback matter Commande SkipForward
MediaPlayback matter Événement StateChanged
MediaPlayback matter Commande Arrêter
MediaPlayback matter Attribut currentState
ModeSelect matter Commande ChangeToMode block
ModeSelect matter Attribut currentMode
ModeSelect matter Attribut onMode
NitrogenDioxideConcentrationMeasurement matter Attribut levelValue
NitrogenDioxideConcentrationMeasurement matter Attribut measuredValue
OccupancySensing matter Attribut occupation
OnOff matter Commande Désactivé block
OnOff matter Commande Activé bloquer
OnOff matter Attribut onOff
OperationalState matter Événement OperationCompletion
OperationalState matter Commande Mettre en pause block
OperationalState matter Commande Reprendre block
OperationalState matter Commande Démarrer
OperationalState matter Commande Arrêter
OperationalState matter Attribut currentPhase
OperationalState matter Attribut operationalState
OzoneConcentrationMeasurement matter Attribut levelValue
OzoneConcentrationMeasurement matter Attribut measuredValue
Pm10ConcentrationMeasurement matter Attribut levelValue
Pm10ConcentrationMeasurement matter Attribut measuredValue
Pm25ConcentrationMeasurement matter Attribut levelValue
Pm25ConcentrationMeasurement matter Attribut measuredValue
PowerSource matter Attribut batChargeState
PowerSource matter Attribut batChargingCurrent
PowerSource matter Attribut batTimeToFullCharge
RadonConcentrationMeasurement matter Attribut levelValue
RadonConcentrationMeasurement matter Attribut measuredValue
RelativeHumidityMeasurement matter Attribut measuredValue
RvcCleanMode matter Commande ChangeToMode
RvcOperationalState matter Commande GoHome
RvcOperationalState matter Commande Pause
RvcOperationalState matter Commande Reprendre
RvcOperationalState matter Attribut currentPhase
RvcOperationalState matter Attribut operationalError
RvcOperationalState matter Attribut operationalState
RvcRunMode matter Commande ChangeToMode
RvcRunMode matter Attribut currentMode
Bouton bascule matter Événement InitialPress
Bouton bascule matter Événement LongPress
Bouton bascule matter Événement LongRelease
Bouton bascule matter Événement MultiPressComplete
Bouton bascule matter Événement MultiPressOngoing
Bouton bascule matter Événement ShortRelease
Bouton bascule matter Événement SwitchLatched
Bouton bascule matter Attribut currentPosition
TemperatureControl matter Commande SetTemperature block
TemperatureControl matter Attribut maxTemperature
TemperatureControl matter Attribut minTemperature
TemperatureControl matter Attribut selectedTemperatureLevel
TemperatureControl matter Attribut temperatureSetpoint
TemperatureMeasurement matter Attribut measuredValue
Thermostat matter Commande SetpointRaiseLower
Thermostat matter Attribut activePresetHandle
Thermostat matter Attribut localTemperature
Thermostat matter Attribut occupation
Thermostat matter Attribut occupiedCoolingSetpoint
Thermostat matter Attribut occupiedHeatingSetpoint
Thermostat matter Attribut outdoorTemperature
Thermostat matter Attribut setpointChangeSource
Thermostat matter Attribut systemMode
Thermostat matter Attribut temperatureSetpointHold
Thermostat matter Attribut temperatureSetpointHoldDuration
Thermostat matter Attribut thermostatRunningMode
Thermostat matter Attribut thermostatRunningState
Thermostat matter Attribut unoccupiedCoolingSetpoint
Thermostat matter Attribut unoccupiedHeatingSetpoint
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut levelValue
TotalVolatileOrganicCompoundsConcentrationMeasurement matter Attribut measuredValue
WindowCovering matter Commande DownOrClose
WindowCovering matter Commande GoToLiftPercentage
WindowCovering matter Commande GoToLiftValue
WindowCovering matter Commande GoToTiltPercentage
WindowCovering matter Commande GoToTiltValue
WindowCovering matter Commande StopMotion
WindowCovering matter Commande UpOrOpen
WindowCovering matter Attribut currentPositionLift
WindowCovering matter Attribut currentPositionLiftPercent100ths
WindowCovering matter Attribut currentPositionLiftPercentage
WindowCovering matter Attribut currentPositionTilt
WindowCovering matter Attribut currentPositionTiltPercent100ths
WindowCovering matter Attribut currentPositionTiltPercentage
WindowCovering matter Attribut targetPositionLiftPercent100ths
WindowCovering matter Attribut targetPositionTiltPercent100ths
ArmDisarm google Commande ArmDisarm block
ArmDisarm google Événement ArmDisarmArmState
ArmDisarm google Attribut armState
ArmDisarm google Attribut currentArmLevel
ArmDisarm google Attribut isArmed
Station d'accueil google Commande Station d'accueil
Station d'accueil google Attribut isDocked
DoorbellPress google Événement DoorbellPressed
ExtendedAirQuality google Événement AirQuality
ExtendedAirQuality google Attribut indoorAirQuality
ExtendedAirQuality google Attribut indoorMeasuredValue
ExtendedAirQuality google Attribut measuredValue
ExtendedAirQuality google Attribut outdoorAirQuality
ExtendedAirQuality google Attribut outdoorMeasuredValue
ExtendedColorControl google Commande MoveToColorHSV
ExtendedColorControl google Commande MoveToColorName
ExtendedColorControl google Commande MoveToColorRGB
ExtendedColorControl google Attribut currentBlue
ExtendedColorControl google Attribut currentGreen
ExtendedColorControl google Attribut currentHue
ExtendedColorControl google Attribut currentName
ExtendedColorControl google Attribut currentRed
ExtendedColorControl google Attribut currentSaturation
ExtendedColorControl google Attribut currentValue
ExtendedFanControl google Commande ToggleAirflowDirection
ExtendedFanControl google Attribut customFanMode
ExtendedFanControl google Attribut customFanModes
ExtendedMediaInput google Commande NextInput
ExtendedMediaInput google Commande PreviousInput
ExtendedMediaInput google Commande SelectCustomInput
ExtendedMediaInput google Attribut currentCustomInput
ExtendedMediaInput google Attribut customInputsList
ExtendedMediaInput google Attribut customInputsOrdered
ExtendedOperationalState google Événement PauseUnpauseFollowUp
ExtendedOperationalState google Événement StartStopFollowUp
ExtendedPowerSource google Commande StartCharging
ExtendedPowerSource google Commande StopCharging
ExtendedThermostat google Attribut activePresetHandle
ExtendedThermostat google Attribut activeRemoteTemperatureSensorIds
ExtendedThermostat google Attribut averageLocalTemperature
ExtendedThermostat google Attribut extendedRunningMode
ExtendedThermostat google Attribut extendedSystemMode
LightEffects google Commande PulseEffectSet
LightEffects google Commande SleepEffectSet
LightEffects google Commande StopEffect
LightEffects google Commande WakeEffectSet
LightEffects google Attribut pulseEffectSet
LightEffects google Attribut sleepEffectSet
LightEffects google Attribut wakeEffectSet
LockUnlock google Commande Verrouiller
LockUnlock google Commande Déverrouiller bloquer
LockUnlock google Attribut lockState
MotionDetection google Événement MotionDetected
MotionDetection google Attribut motionDetectionEventInProgress
ObjectDetection google Événement ObjectDetected
OpenClose google Commande Fermer block
OpenClose google Commande GoToOpenPercentage block
OpenClose google Commande Ouvrir block
OpenClose google Commande Étape block
OpenClose google Attribut openPercent
OpenClose google Attribut openState
OpenClose google Attribut targetOpenPercent
Boutons bascule google Commande ChangeToggleSettings block
Boutons bascule google Attribut currentToggleSettings
Luminosité google Commande BrightnessStep
Luminosité google Commande MoveToBrightness
Luminosité google Attribut currentBrightnessPercent
SimplifiedOnOff google Attribut onOff
SimplifiedThermostat google Commande SetSystemMode
SimplifiedThermostat google Attribut systemMode
Volume google Commande MoveToVolume
Volume google Commande Couper micro
Volume google Commande Réactiver le son
Volume google Commande VolumeStep
Volume google Attribut currentVolumePercent
Volume google Attribut isMuted
AreaAttendanceState google Attribut attendanceState
AreaPresenceState google Attribut presenceState