Unterstützung für Automation API-Attribute auf Android-Geräten

Die Automation API für Android unterstützt die meisten Traits, aber die Unterstützung für einige Attribute, Ereignisse und Befehle in einem Trait kann eingeschränkt sein.

Allgemein gilt:

• Alle Eigenschaften und Typen, die du in deiner App mit der Automation API verwenden möchtest, müssen bei der Initialisierung registriert werden. Weitere Informationen finden Sie unter Home-Instanz erstellen.
• Jedes Attribut kann in Auslösern oder Bedingungen verwendet werden.
• Cloud-to-cloud-Geräte, die ihren Status nicht melden, können nicht als Auslöser in Automatisierungen verwendet werden, die entweder manuell oder durch Erkennung erstellt wurden.

• Auch wenn ein Gerät die hier aufgeführten Eigenschaften unterstützt, kann es aufgrund von Qualitätsschwellenwerten für den Statusbericht für die Verwendung als Auslöser oder Aktion in der Automation API gesperrt sein:

  • Geräte mit einer Erfolgsquote von weniger als 90% bei der Statusmeldung können nicht als Auslöser verwendet werden.
  • Geräte mit einer Erfolgsquote bei der Befehlsausführung von weniger als 95% können nicht als Aktionen verwendet werden.

  In dieser Liste der Gerätemodelle findest du die spezifischen Auslöser und Aktionen, die sie für die Automations API unterstützen.

• Befehle können nur als Aktionen verwendet werden.

• Einige Attribute wie AssistantBroadcast und Notification sind nur in der Automation API verfügbar.

• Der Befehl okGoogle ist ein Befehl auf Gebäudeebene und kann verwendet werden, um jedes Gerät im Gebäude zu automatisieren. Eine Home APIs-App hat jedoch möglicherweise nicht Zugriff auf jedes Gerät. Unter OkGoogle-Berechtigungen finden Sie Informationen dazu, wie Berechtigungen in verschiedenen Fällen erzwungen werden.

• Für einige Merkmale gelten Voraussetzungen:

  • Wenn du zeitbasierte Auslöser wie Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent oder Time.RecurringSolarTimeScheduledEvent verwenden möchtest, muss für das Gebäude, in dem die Automatisierung ausgeführt wird, eine Adresse angegeben sein, damit die lokale Zeitzone und die Sonnenberechnungen ermittelt werden können. Die Adresse kann beim Erstellen des Gebäudes angegeben oder in der Google Home app (GHA) festgelegt werden. Unter Google-Privatadresse ändern wird erklärt, wie ein Nutzer die Adresse des Gebäudes in der GHA eingeben oder aktualisieren kann. Wenn die Adresse nicht eingerichtet ist, speichert createAutomation() und gibt ein Automation zurück, wobei isValid == false mit einem UnsupportedEntityEvent-Validierungsproblem, das MissingStructureAddressSetup enthält.
  • Damit Haushaltsmitglieder Benachrichtigungen von Notification.sendNotifications erhalten können, muss die GHA mit aktivierten Benachrichtigungen installiert sein. Benachrichtigungen werden über die GHA an Mitglieder gesendet und können nicht direkt an Drittanbieter-Apps gesendet werden.
  • Damit die Merkmale AreaPresenceState oder AreaAttendanceState verwendet werden können, muss der Nutzer die Anwesenheitserkennung in der GHA einrichten.
  • Damit das Attribut ObjectDetection verwendet werden kann, muss der Nutzer ein aktives Google Home Premium-Abo haben.

Für die Verwendung in automatisierten Abläufen sind auch vereinfachte Versionen einiger Merkmale verfügbar. Weitere Informationen findest du unter Vereinfachte Attribute auf Android-Geräten.