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

L'API Automation pour Android est compatible avec la plupart des caractéristiques, mais la compatibilité avec certains attributs, événements et commandes d'une caractéristique 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é dans les déclencheurs ou les conditions.
• Cloud-to-cloudLes appareils 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 caractéristiques listées ici, il peut être bloqué pour une utilisation en tant que 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éclencheurs.
  • Les appareils dont le taux de réussite d'exécution des commandes est inférieur à 95% ne peuvent pas être utilisés comme actions.

  Consultez cette liste de modèles d'appareils ainsi que les déclencheurs et actions spécifiques qu'ils acceptent pour l'API Automations.

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

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

• La commande okGoogle est une commande au niveau de la structure qui peut être utilisée pour automatiser n'importe quel appareil de la structure. Toutefois, une application d'API Home peut ne pas avoir accès à tous les appareils. Consultez la section Autorisations OkGoogle pour découvrir comment les autorisations sont appliquées dans différents cas.

• Certains traits ont des conditions préalables :

  • Pour utiliser des déclencheurs temporels tels que Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent ou Time.RecurringSolarTimeScheduledEvent, la maison dans laquelle l'automatisation s'exécute doit avoir 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 Google Home app (GHA). Modifier l'adresse de votre maison Google explique comment un utilisateur peut saisir ou modifier l'adresse de la structure dans l'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é l'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 caractéristiques AreaPresenceState ou AreaAttendanceState, l'utilisateur doit configurer la détection de présence dans GHA.
  • Pour utiliser la caractéristique 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 Caractéristiques simplifiées sur Android.