Android-Beispiel-App verwenden

Die Android-Beispiel-App zeigt die grundlegenden Funktionen für den Gerätezugriff und die Gerätesteuerung mit den Home APIs für die unterstützten Gerätetypen.

Nachdem die Kontoautorisierung abgeschlossen ist und eine Struktur ausgewählt wurde, lädt die Beispiel-App alle lokalen Geräte, die in dieser Struktur gefunden wurden.

Wenn sich ein Gerät in einem Raum befindet, wird es unter diesem Raum aufgeführt. Die Beispiel-App unterstützt die folgenden Gerätetypen:

  • Farbtemperatur-Licht (ein/aus, Helligkeit)
  • Kontaktsensor (boolescher Status)
  • Dimmbares Licht (ein/aus, Helligkeit)
  • Licht mit erweitertem Farbspektrum (ein/aus, Helligkeit)
  • Allgemeiner Schalter
  • Google Kamera
  • Anwesenheitssensor (Anwesenheitserkennung)
  • Ein/Aus-Licht (ein/aus, Helligkeit)
  • Ein/Aus-Lichtschalter
  • Ein/Aus-Steckdose (ein/aus)
  • Ein/Aus-Sensor

Aktionen auf vorhandenen Geräten und Automatisierungen

Die Beispiel-App besteht aus zwei Tabs: Geräte und Automatisierungen. Auf jedem Tab finden Sie Informationen zur Struktur und können Aufgaben ausführen.

Tab „Geräte“

Auf dem Tab Geräte (Abbildung 1) werden die Räume in der Struktur (Hinterhof, Dachboden, Reise) und die Geräte für jeden Raum sowie der Status der einzelnen Geräte angezeigt. Wenn Sie die Merkmale eines Geräts ansehen oder bearbeiten möchten, tippen Sie auf den Gerätenamen. Daraufhin wird der Steuerungsbildschirm für dieses Gerät angezeigt (Abbildung 2).

Wenn Sie der Struktur ein Gerät hinzufügen möchten, tippen Sie auf dem Tab Geräte (Abbildung 1) auf Gerät hinzufügen und folgen Sie der Anleitung, um ein Gerät mit oder ohne QR-Code hinzuzufügen.

Tab „Geräte“ der Home APIs-Beispiel-App.
Abbildung 1: Bildschirm der Beispiel-App: Tab „Geräte“
Gerätesteuerung der Home APIs Sample App.
Abbildung 2: Gerätesteuerung der Beispiel-App

Tab „Automatisierungen“

Auf dem Tab Automatisierungen (Abbildung 3) wird eine Liste aller Automatisierungen für die Struktur angezeigt. Für jede Automatisierung werden die Auslöser und Aktionen angezeigt. Es werden mehrere Auslöser und Aktionen unterstützt.

Tippen Sie auf eine Automatisierung, um die Details aufzurufen, wie im Beispiel in Abbildung 4 gezeigt. In dieser Detailansicht können Sie die Automatisierung löschen oder manuell ausführen, ohne dass ein Auslöser erforderlich ist, sofern die Schaltfläche Manuell ausführen für diese Automatisierung unterstützt wird.

In der Detailansicht einer Automatisierung (Abbildung 4) können Sie außerdem isActive aktivieren oder deaktivieren, um die Automatisierung ein- oder auszuschalten. Das Feld isValid wird vom SDK festgelegt und ist false, wenn ein Problem mit der Geräte- oder Merkmalsunterstützung oder ein anderes Problem vorliegt.

Tab „Automatisierungen“ der Home APIs-Beispiel-App.
Abbildung 3: Tab „Automatisierungen“
Detaillierte Ansicht einer ausgewählten Automatisierung.
Abbildung 4: Detailansicht einer Automatisierung

Automatisierung erstellen

Wenn Sie eine neue Automatisierung erstellen möchten, tippen Sie in der Listenansicht der Automatisierungen (Abbildung 3) auf die Schaltfläche Erstellen. Der Bildschirm Neue Automatisierung wird angezeigt (Abbildung 5).

Verwenden Sie die Schaltflächen + Auslöser hinzufügen und + Aktion hinzufügen (Abbildung 5), um Ihrer Automatisierung einen oder mehrere Auslöser und Aktionen hinzuzufügen. In den Abbildungen 6 und 7 sehen Sie Beispiele für die Auswahl eines Auslösers und einer Aktion. Nachdem Sie Ihre Auswahl getroffen und den Auslöser oder die Aktion gespeichert haben, werden die Schaltflächen Auslöser aktualisieren und Auslöser entfernen für den Auslöser (und Aktion aktualisieren und Aktion entfernen für die Aktion) angezeigt. So haben Sie die Möglichkeit, den Auslöser oder die Aktion zu bearbeiten oder zu entfernen, bevor Sie die Automatisierung selbst speichern.

Wenn Sie alle Auslöser und Aktionen hinzugefügt haben, können Sie zum Bildschirm Neue Automatisierung zurückkehren und auf Automatisierung erstellen tippen (Abbildung 8).

Beispiel-App-Bildschirm zum Starten einer neuen Automatisierung.
Abbildung 5: Neue Automatisierung erstellen
Beispiel-App-Bildschirm zum Hinzufügen eines Auslösers für eine Automatisierung.
Abbildung 6: Auslöser zu einer Automatisierung hinzufügen
Beispiel-App-Bildschirm zum Hinzufügen einer Aktion für eine Automatisierung.
Abbildung 7: Aktion zu einer Automatisierung hinzufügen
Beispiel-App-Bildschirm zum Erstellen einer Automatisierung.
Abbildung 8: Automatisierung erstellen

Fehlerbehebung

Die App zeigt Dialogmeldungen für einige häufige Ereignisse an. Informationen zur Behebung dieser Ereignisse finden Sie in den adb-Logs.

Wenn Probleme bei der Verwendung der Beispiel-App auftreten, siehe Fehlerbehebung für Android.