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.

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é comme déclencheur ou condition.
• 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 des rapports est inférieur à 90% ne peuvent pas être utilisés comme appareils de démarrage.
  • 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 de 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 et Notification, ne peuvent être utilisés 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 "Ok Google" pour découvrir comment les autorisations sont appliquées dans différents cas.

• Certains traits ont des prérequis :

  • Pour utiliser des déclencheurs basés sur l'heure, tels que Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent ou Time.RecurringSolarTimeScheduledEvent, la structure dans laquelle l'automatisation s'exécute doit comporter une adresse postale pour déterminer le fuseau horaire local et les calculs solaires. L'adresse peut être fournie lors de la création de la structure ou définie dans le Google Home app (GHA). L'article Modifier l'adresse de votre maison dans Google Home explique comment un utilisateur peut saisir ou modifier l'adresse de la structure dans GHA. Si l'adresse n'est pas configurée, createAutomation() enregistre et renvoie un Automation où isValid == false, avec un problème de validation UnsupportedEntityEvent contenant MissingStructureAddressSetup.
  • Pour que les membres de la maison reçoivent des notifications de Notification.sendNotifications, ils doivent avoir installé GHA et activé les notifications. Les notifications sont envoyées aux membres via GHA et ne peuvent pas être envoyées directement à des applications tierces.
  • 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 Google Home Premium actif.

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