Google Home Beispiel-App für die Rechtsangelegenheit

Google Home Sample App for Matter

Die Google Home Sample App for Matter verwendet das Google Home Mobile SDK , um eine Android-App zu erstellen, die der Google Home app (GHA) ähnelt. Diese Beispiel-App bietet die folgenden Funktionen:

  • Physische und virtuelle Matter Geräte für das lokale Android-Fabric in Betrieb nehmen
  • Physische und virtuelle Geräte für ein Entwicklungs-Fabric in Betrieb nehmen
  • Geräte im Entwicklungs-Fabric steuern, z. B. eine Lampe einschalten
  • Mit den Funktionen für mehrere Administratoren können Sie Geräte im Entwicklungs-Fabric für andere Apps freigeben und umgekehrt Geräte, die von anderen Apps freigegeben wurden, in das Entwicklungs-Fabric einbeziehen
  • Entwickler-Dienstprogramme

In dieser Anleitung wird beschrieben, wie Sie die Sample App for Matter APK installieren und damit Matter Geräte in Betrieb nehmen, steuern und freigeben.

Wenn Sie den Quellcode herunterladen, erfahren Sie, wie Sie die Mobile SDK integrieren und Bildschirme in Android Studio anpassen. Probieren Sie unser Sample App for Matter Codelab aus.

Codelab zu Sample App for Matter aufrufen

Vorbereitung

Sie benötigen keinen Hub, z. B. einen Google Nest Hub (2nd gen), um Geräte mit der Sample App for Matter in Betrieb zu nehmen und zu steuern.

Installieren

  1. Rufen Sie im GitHub-Repository den Abschnitt Releases auf.Sample App for Matter Suchen Sie in der neuesten Version im Abschnitt „Assets“ nach der APK-Datei mit dem Namen GHSAFM-version-default-debug.apk. Wählen Sie nicht targetcommissioner aus.

  2. Installieren Sie die Android Debug Bridge (adb):

    adb installieren

  3. Verbinden Sie Ihr Android-Gerät über USB und aktivieren Sie Dateiübertragung. Installieren Sie dann die APK-Datei:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

Geräte in Betrieb nehmen

Wenn Sie die Beispiel-App zum ersten Mal starten, wird ein Dialogfeld mit einem Link zum Sample App for Matter Codelab angezeigt. Wenn Sie Diese Nachricht nicht mehr anzeigen auswählen, können Sie das Dialogfeld jederzeit wieder aufrufen indem Sie Ihre Einstellungen im Admin-Bereich der App aktualisieren.

In den nächsten Schritten fügen Sie dem lokalen Android-Fabric ein Matter Gerät hinzu, zusammen mit einem Entwicklungs-Fabric, das nur für die Beispiel App lokal ist.

Was sind Matter-Fabrics?

Google Home Sample App for Matter

Ein Matter Fabric ist eine gemeinsame Vertrauensdomäne zwischen Geräten in einem Heimnetzwerk, die es ihnen ermöglicht, miteinander zu kommunizieren.

Geräte können ein oder mehrere Fabrics haben, die einer Plattform, App oder Gruppe von Geräten entsprechen, die miteinander interagieren. Fabrics haben eine eindeutige ID und Geräte verwenden dieselben Anmeldedaten und dieselbe Zertifizierungsstelle (Certificate Authority, CA). Diese Anmeldedaten werden bei der Matter Inbetriebnahme zugewiesen.

So nehmen Sie ein Matter Gerät in Betrieb:

  1. Tippen Sie auf die Schaltfläche „Gerät hinzufügen“, um den Inbetriebnahmevorgang zu starten.

    Gerät hinzufügen

  2. Als Nächstes wird die Steuerung an Google Play services übertragen, die über einen Aufruf des Mobile SDK gestartet werden. Um den Besitz nachzuweisen, scannen Sie den QR-Code oder tippen Sie auf Pairing-Code verwenden.

    QR-Code scannen

  3. Wenn die Inbetriebnahme abgeschlossen ist, geben Sie einen Gerätenamen ein und tippen Sie auf Fertig.

Ihr Gerät ist jetzt sowohl mit dem lokalen Android-Fabric als auch mit dem Entwicklungs-Fabric verbunden.

Alle Inbetriebnahmevorgänge und zugehörigen Bildschirme werden von Play services verarbeitet, wenn Geräte in Betrieb genommen werden. So wird eine einheitliche Nutzererfahrung gewährleistet und es ist nicht erforderlich, vertrauliche Berechtigungen wie WLAN- und Thread-Anmeldedaten zu verwalten.

Geräte steuern

Das Entwicklungs-Fabric erstellt die Anmeldedaten, um Matter Geräte direkt über die Beispiel-App zu steuern.

Auf dem Startbildschirm können Sie Ihr Gerät ein- oder ausschalten. Tippen Sie auf das Gerät, um auf die Gerätedetails zuzugreifen.

Gerät hinzugefügt

Geräte freigeben

Das Freigeben eines Geräts wird in der Matter Spezifikation als Multi-Admin-Ablauf bezeichnet. Sobald ein Gerät für die Beispiel-App in Betrieb genommen wurde, können Sie es ganz einfach für andere Ökosysteme freigeben.

Wenn Sie Ihr Matter Gerät für andere Ökosysteme freigeben möchten, muss auf Ihrem Android-Gerät eine andere Plattform installiert sein. Diese externe Plattform wird zur Ziel-Inbetriebnahmekomponente. Wir haben eine weitere Instanz der Beispiel-App erstellt, die Sie als Ziel-Inbetriebnahmekomponente verwenden können.

  1. Rufen Sie im GitHub-Repository den Abschnitt Releases auf.Sample App for Matter Suchen Sie in der neuesten Version im Abschnitt „Assets“ nach der APK-Datei mit dem Namen GHSAFM-version-targetcommissioner-debug.apk. Wählen Sie nicht default aus.

  2. Installieren Sie die Ziel-Inbetriebnahmekomponente.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Tippen Sie auf dem Startbildschirm auf das Gerät, um die Geräteinformationen aufzurufen. Tippen Sie auf Freigeben.

    Gerät gemeinsam nutzen

Die Beispiel-App ruft die Mobile SDK Share API auf und die Steuerung wird wieder an die Play services übertragen.

Ein Freigabeblatt wird angezeigt, auf dem Sie die App oder Plattform auswählen können, mit der Sie das Gerät koppeln möchten. Auf diesem Bildschirm haben Sie zwei Möglichkeiten, das Gerät freizugeben:

  1. Manuell über einen Einrichtungscode, der für die Ziel-Inbetriebnahmekomponenten-App freigegeben werden soll
  2. Mit einer lokalen Android-App, die als Matter Inbetriebnahmekomponente registriert ist

Die Ziel-Inbetriebnahmekomponenten-App ist mit GHSAFM-TC gekennzeichnet. Tippen Sie auf diese Instanz der Beispiel-App, um Ihr Gerät freizugeben.

Als Nächstes schließt die externe App (Ziel-Inbetriebnahmekomponente) die Inbetriebnahme des Geräts in ihrem eigenen Fabric ab.

Einstellungen

Klicken Sie auf dem Startbildschirm auf das Symbol für die Einstellungen . Hier haben Sie die Möglichkeit, die Nutzereinstellungen zu aktualisieren, Hilfe zu erhalten und mehr über die App zu erfahren.

Einstellungen

Halbseitige Benachrichtigung

Auf dem Bildschirm „Einstellungen“ können Sie proaktive Benachrichtigungen zur Erkennung von inbetriebnahmefähigen Geräten für Matter Geräte deaktivieren.

Wenn Ihre Anwendung einen eigenen Matter Erkennungs- oder Inbetriebnahmeablauf bietet, sollten Sie diese Benachrichtigungen möglicherweise unterdrücken, um Unterbrechungen zu vermeiden. Weitere Informationen finden Sie unter Benachrichtigungen zur Erkennung von inbetriebnahmefähigen Geräten unterdrücken.

Entwickler-Dienstprogramme

Auf dem Bildschirm „Einstellungen“ können Sie auch auf Entwickler-Dienstprogramme zugreifen.

So prüfen Sie den Inhalt der Device and User Preferences DataStore-Repositories in Logcat:

  1. Klicken Sie auf Log-Repositories-Inhalt.

  2. Klicken Sie im Dialogfeld auf OK und prüfen Sie dann Logcat.

Feedback und Hilfe

Wenn Sie uns Ihre Gedanken oder Ihr Feedback dazu mitteilen möchten, wie wir die Entwicklung mit Sample App for Matter verbessern können, füllen Sie unser Feedbackformular aus.

Feedback senden

Wenn Sie Probleme mit der Sample App for Matter haben, führen Sie die Schritte aus, um Ihre Umgebung zu überprüfen:

Wenn Sie Fragen zur Verwendung der Beispiel-App haben oder einen Fehler im Code finden, können Sie Probleme im Issue Tracker im GitHub-Repository einreichen:

Offizielle Informationen von Google zu technischen Fragen finden Sie im Smart Home Developer Forum:

Wenn Sie technischen Support von der Community erhalten möchten, verwenden Sie auf Stack Overflow das Tag google-smart-home: