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

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

Allgemein gilt:

• Alle Merkmale und Typen, die Sie in Ihrer App mit der Automation API verwenden möchten, 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 Trigger in Automatisierungen verwendet werden, die entweder manuell oder über die Erkennung erstellt wurden.

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

  • Geräte mit einer Erfolgsrate für den Meldestatus von unter 90% können nicht als Starter verwendet werden.
  • Geräte mit einer Erfolgsrate bei der Befehlsausführung von weniger als 95% können nicht als Aktionen verwendet werden.

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

• Befehle können nur als Aktionen verwendet werden.

• Einige Merkmale wie AssistantBroadcast und Notification sind nur für die Verwendung in der Automation API verfügbar.

• Der Befehl okGoogle ist ein Befehl auf Strukturebene und kann verwendet werden, um jedes Gerät in der Struktur zu automatisieren. Eine App, die Home-APIs verwendet, hat jedoch möglicherweise nicht auf alle Geräte Zugriff. Unter „Ok Google“-Berechtigungen erfahren Sie, wie Berechtigungen in verschiedenen Fällen erzwungen werden.

• Für einige Eigenschaften gelten Voraussetzungen:

  • Damit du zeitbasierte Auslöser wie Time.ScheduledTimeEvent, Time.RecurringClockTimeScheduledEvent oder Time.RecurringSolarTimeScheduledEvent verwenden kannst, muss das Gebäude, in dem der automatisierte Ablauf ausgeführt wird, eine Adresse haben, damit die Ortszeit und die Sonnenberechnungen bestimmt werden können. Die Adresse kann bei der Erstellung der Struktur angegeben oder in der Google Home app (GHA) festgelegt werden. Im Hilfeartikel Google-Adresse für Zuhause ändern wird beschrieben, wie ein Nutzer die Adresse des Zuhauses in der GHA eingeben oder aktualisieren kann. Wenn die Adresse nicht eingerichtet ist, speichert und gibt createAutomation() ein Automation zurück, wobei isValid == false mit einem UnsupportedEntityEvent-Validierungsproblem mit MissingStructureAddressSetup übereinstimmt.
  • Damit Haushaltsmitglieder Benachrichtigungen von Notification.sendNotifications erhalten können, muss auf ihren Geräten die GHA mit aktivierten Benachrichtigungen installiert sein. Benachrichtigungen werden Mitgliedern über die GHA zugestellt und können nicht direkt an Drittanbieter-Apps gesendet werden.
  • Wenn der Nutzer die Merkmale AreaPresenceState oder AreaAttendanceState verwenden möchte, muss er die Anwesenheitserkennung in der GHA einrichten.
  • Damit der ObjectDetection-Trait verwendet werden kann, muss der Nutzer ein aktives Google Home Premium-Abo haben.

Vereinfachte Versionen einiger Attribute sind auch für die Verwendung in Automatisierungen verfügbar. Weitere Informationen finden Sie unter Vereinfachte Traits auf Android.