Mit automatisierten Abläufen lassen sich Aufgaben und Geräteeinstellungen in einem Zuhause automatisieren. Automatisierungen sind im Google Home-Ökosystem als Abläufe in der Google Home app (GHA) und über die automation script editor auf Google Home for web verfügbar.
Automatisierte Abläufe im Google Home-Ökosystem sind jetzt über die Home APIs für Android verfügbar. Sie verwenden dieselben grundlegenden Konzepte wie GHA-Routinen und die script editor, bieten aber erweiterte Funktionen, die nur über die Home APIs möglich sind, darunter:
- Zugriff auf alle Matter-Standard- und smart home-Merkmale für ein Gerät, wie in den Home-APIs dargestellt.
- Unterstützung für sequenzielle, parallele und ausgewählte Ausführungsabläufe.
Automatisierte Abläufe werden mit Automation DSL geschrieben, einer domänenspezifischen Sprache, die für die Erstellung von automatisierten Abläufen in Kotlin entwickelt wurde.
Alle Merkmale und Typen, die Sie in Ihrer App mit der Device & Structure API oder der Automation API verwenden möchten, müssen bei der Initialisierung registriert werden. Weitere Informationen finden Sie unter Zuhause auf Android initialisieren.
Entwickler-Journey
Die Automation API ist nur ein Teil eines größeren Entwicklungsprozesses. Sie erfolgt nach der Integration der Struktur- und Geräte-APIs, damit Nutzer Automatisierungen verwenden können, wenn sie dies möchten.
- Der Entwickler plant die Automatisierung und definiert sie mit der Automatisierungs-DSL.
- Der Entwickler bettet die Automatisierungsdefinition in eine Kotlin-Android-App ein.
- Die App präsentiert dem Nutzer Automatisierungen basierend auf Informationen zu seinen Geräten, einschließlich Eigenschaften, Attributen, Befehlen und Ereignissen, die über die Discovery API oder Device API erfasst wurden.
- Mit der Discovery API kann die App einen benutzerdefinierten Automatisierungsentwurf für die Gerätetypen und Merkmale in der Struktur des Nutzers generieren, mit oder ohne Eingabe des Nutzers.
- Die Device API kann die meisten Informationen der Discovery API liefern, ist aber nicht für Automatisierungsanwendungsfälle optimiert. Weitere Informationen finden Sie unter Geräte-API und Discovery API vergleichen.
- Die App erstellt die eigentliche Automatisierung, die auf die ausgewählte Struktur abgestimmt ist.
- Die Automatisierung ist jetzt im Gebäude des Nutzers verfügbar und kann mit Methoden der Structure API ausgeführt oder gelöscht werden.
Der Nutzer kann jederzeit neue Instanzen der Automatisierung erstellen und dabei eine andere Struktur oder, je nach App-Logik, eine andere Gruppe von Geräten auswählen. Jedes Mal, wenn sie dies tun, wird in der App eine neue Instanz der Automatisierung generiert.
Im einfachsten Fall schlagen Sie Ihren Nutzern eine vordefinierte Automatisierung vor, die eine relativ einfache Aufgabe ausführt. Alternativ können Sie ein Gerüst für eine Automatisierung präsentieren, die der Nutzer an seine Bedürfnisse anpasst. Alternativ können Sie einen Automatisierungseditor mit offenem Ende schreiben, mit dem der Nutzer komplexe Automatisierungen mit allen in der Automation API verfügbaren Bausteinen erstellen kann.
Ressourcenlimits
Für automatisierte Abläufe in den Home APIs gelten die folgenden Limits:
Messwert | Limit |
---|---|
Maximale Anzahl an Automatisierungen pro Gebäude | 64 |
Maximale Anzahl von Knoten pro Automatisierung | 128 |
Maximale Anzahl von Ausdrucksknoten pro Automatisierung | 64 |
Maximale Anzahl von Automatisierungsinstanzen pro Gebäude | 1024 |
Maximale Anzahl von Automatisierungsinstanzen pro Entwickler und Struktur | 64 |
Maximale Anzahl von Ausführungen pro Struktur und Tag | 1024 |
Maximale Anzahl von Ausführungen pro Entwickler, Struktur und Tag | 128 |