Kontoautorisierung unter Android

Bevor Sie mit der Kontoautorisierung fortfahren, müssen folgende Voraussetzungen erfüllt sein:

  1. Die Google Home app (GHA) ist auf Ihrem Android-Mobilgerät installiert.
  2. Mindestens einer dieser unterstützten Gerätetypen ist für die Beispiel-App im Zuhause vorhanden:
    • Farbtemperatur-Licht (ein/aus, Helligkeit)
    • Kontaktsensor (boolescher Status)
    • Dimmbares Licht (ein/aus, Helligkeit)
    • Türschloss
    • Licht mit erweiterter Farbauswahl (ein/aus, Helligkeit)
    • Allgemeiner Schalter
    • Google Border-Router
    • Google Kamera
    • Google Türklingel
    • Anwesenheitssensor (Anwesenheitserkennung)
    • Ein/Aus-Licht (ein/aus, Helligkeit)
    • Ein/Aus-Lichtschalter
    • Ein/Aus-Steckdose (ein/aus)
    • Ein/Aus-Sensor
  3. Zwei Geräte zum Testen der Beispielautomatisierung.

Bevor Sie Geräte über die Home APIs verwenden können, müssen sie über die Google Home App steuerbar sein GHA.

Android-Beispiel-App ausführen

Bevor Sie ein Konto autorisieren, prüfen Sie, ob die Beispiel-App mit dem entsprechenden OAuth-Bereich für Ihr Projekt konfiguriert ist. Standardmäßig verwendet der Quellcode der Beispiel-App den Bereich https://www.googleapis.com/auth/home.platform.v2. Viele Funktionen in der Beispiel-App sind durch den Bereich home.platform.v2 eingeschränkt und erfordern die Genehmigung des Partners, um darauf zugreifen zu können. Wenn Sie die Beispiel-App mit dem Standardbereich https://www.googleapis.com/auth/home.platform.selected.devices autorisieren und verwenden möchten, ändern Sie homePlatformScope manuell in HOME_PLATFORM_SCOPE_VERSION_1 in HomeModule.kt wie unter App erstellen beschrieben.

Führen Sie die Android-Beispiel-App aus. Wenn Sie sie zum ersten Mal ausführen, werden Sie aufgefordert, den Zugriff auf ein Zuhause in Ihrem Google-Konto zuzulassen. Dadurch erhält die Beispiel-App die Berechtigung, auf die Strukturen und Geräte in diesem Zuhause zuzugreifen und sie zu steuern.

Wenn Sie keine Struktur haben, kann der Nutzer während des Berechtigungs ablaufs eine erstellen, ohne GHA verwenden zu müssen.

Das Standardverhalten der App in Bezug auf Berechtigungen hängt davon ab, ob die App in der Google Home Developer Console registriert wurde.

Wenn eine App nicht in der Developer Console registriert ist, befindet sie sich im Status nicht bestätigt. Dies wird für das Testen der Verwendung der Home APIs empfohlen:

  • Nur Nutzer, die in der OAuth Console als Testnutzer registriert sind, können Berechtigungen für die App erteilen. Für eine nicht bestätigte App gilt ein Limit von 100 Testnutzern.

  • Eine nicht bestätigte App hat Zugriff auf Geräte aller Gerätetypen, die von OAuth für die Home APIs unterstützt werden (Liste der Gerätetypen in der Developer Console). Alle Geräte in einer Struktur erhalten Zugriff.

Wenn eine App in der Developer Console und für den Zugriff auf einen oder mehrere Gerätetypen genehmigt wurde und die Marken bestätigung für OAuth abgeschlossen wurde, befindet sie sich im Status bestätigt. Dieser Status ist erforderlich, um eine App in der Produktion zu starten:

  • Limits für Testnutzer gelten nicht mehr. Jeder Nutzer kann der App Berechtigungen erteilen.
  • Der Nutzer kann nur Berechtigungen für die Gerätetypen erteilen, die in der Developer Consolegenehmigt wurden.

Tippen Sie auf Zugriff auf ein ausgewähltes Zuhause zulassen:

  • Wenn Ihrem Konto Zuhause hinzugefügt wurden, wählen Sie ein Zuhause aus, um Berechtigungen zu erteilen. Wenn im ausgewählten Zuhause keine Geräte gefunden werden, haben Sie folgende Möglichkeiten:
    1. Tippen Sie auf Zugriff auf ein anderes Zuhause zulassen , um ein anderes Zuhause auszuwählen.
    2. Richten Sie mit der Google Home app (GHA) ein Gerät Ihrer Wahl in diesem Zuhause ein. Beachten Sie, dass nur diese Gerätetypen in dieser Beispiel-App unterstützt werden:
      • Farbtemperatur-Licht (ein/aus, Helligkeit)
      • Kontaktsensor (boolescher Status)
      • Dimmbares Licht (ein/aus, Helligkeit)
      • Türschloss
      • Licht mit erweiterter Farbauswahl (ein/aus, Helligkeit)
      • Allgemeiner Schalter
      • Google Border-Router
      • Google Kamera
      • Google Türklingel
      • Anwesenheitssensor (Anwesenheitserkennung)
      • Ein/Aus-Licht (ein/aus, Helligkeit)
      • Ein/Aus-Lichtschalter
      • Ein/Aus-Steckdose (ein/aus)
      • Ein/Aus-Sensor
  • Wenn Ihrem Konto keine Zuhause hinzugefügt wurden, wird ein Bildschirm mit der Meldung Für das ausgewählte Konto sind keine Strukturen vorhanden angezeigt.
    1. Wischen Sie zurück, um zur Hauptansicht der Beispiel-App zurückzukehren.
    2. Richten Sie ein Zuhause mit der GHA ein. Versuchen Sie dann noch einmal, der Beispiel-App Berechtigungen zu erteilen.

Sie können den Berechtigungsablauf jederzeit wiederholen, indem Sie auf einem beliebigen Bildschirm der Beispiel-App oben rechts auf das Profilsymbol tippen.

Wählen Sie eine Struktur aus, in der die Beispiel-App ausgeführt werden soll.
Abbildung 1: Struktur auswählen
Die ausgewählte Struktur mit den verfügbaren Geräten.
Abbildung 2: Struktur und Geräte
Steuerungseinstellungen für ein Gerät
Abbildung 3: Gerätesteuerung
Die ausgewählte Struktur mit den verfügbaren Automatisierungen.
Abbildung 4: Struktur und Automatisierungen

Nachdem Sie einem Zuhause mit Geräten erfolgreich Berechtigungen erteilt haben, werden Sie zur Geräteansicht weitergeleitet. Sie können die Geräte über die Beispiel-App steuern und ihre Statusänderungen beobachten.