Google Home Beispiel-App für die Rechtsangelegenheit

Google Home Sample App for Matter

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

  • Physische und virtuelle Matter-Geräte im lokalen Android-Fabric in Betrieb nehmen
  • Physische und virtuelle Geräte in einem Entwicklungs-Fabric in Betrieb nehmen
  • Geräte in deinem Entwicklungs-Fabric steuern, z. B. ein Licht einschalten
  • Mit Funktionen für mehrere Administratoren können Sie Geräte im Entwicklungs-Fabric mit anderen Apps teilen und umgekehrt Geräte, die von anderen Apps geteilt wurden, in das Entwicklungs-Fabric aufnehmen.
  • Entwickler-Dienstprogramme

In diesem Leitfaden 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 möchten, erfahren Sie in unserem Sample App for Matter-Codelab, wie Sie die Mobile SDK einbinden und Bildschirme in Android Studio anpassen.

Sample App for Matter-Codelab aufrufen

Vorbereitung

Du benötigst 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 Sample App for Matter den Abschnitt „Releases“ auf. Suchen Sie im Bereich „Assets“ nach der APK mit dem Namen GHSAFM-version-default-debug.apk. Wählen Sie nicht die 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:

    $ 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 Meldung nicht mehr anzeigen auswählen, können Sie das Dialogfeld jederzeit wieder aufrufen, indem Sie Ihre Einstellungen im Administratorbereich der App aktualisieren.

In den nächsten Schritten fügen Sie der lokalen Android-Struktur ein Matter-Gerät hinzu, zusammen mit einer Entwicklungsstruktur, die nur für die Beispiel-App lokal ist.

Was sind Matter-Stoffe?

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 (CA). Diese Anmeldedaten werden während der Matter-Inbetriebnahme zugewiesen.

So nimmst du ein Matter-Gerät in Betrieb:

  1. Tippe auf die Schaltfläche  Gerät hinzufügen, um mit der Inbetriebnahme zu beginnen.

    Gerät hinzufügen

  2. Als Nächstes wird die Steuerung an Google Play services übergeben, das über einen Aufruf von Mobile SDK gestartet wird. Um den Besitz nachzuweisen, scannen Sie den QR‑Code oder tippen Sie auf Kopplungscode verwenden.

    QR-Code scannen

  3. Wenn die Inbetriebnahme abgeschlossen ist, gib einen Gerätenamen ein und tippe auf Fertig.

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

Alle Inbetriebnahmearbeiten und zugehörigen Bildschirme werden bei der Inbetriebnahme von Geräten von Play services übernommen. Das sorgt für eine einheitliche Nutzererfahrung und macht die Verarbeitung sensibler Berechtigungen wie WLAN- und Thread-Anmeldedaten überflüssig.

Geräte steuern

Die Entwicklungsumgebung erstellt die Anmeldedaten, mit denen Matter-Geräte direkt über die Beispiel-App gesteuert werden können.

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 gemeinsam verwenden

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

Wenn Sie Ihr Matter-Gerät mit anderen Ökosystemen teilen möchten, muss auf Ihrem Android-Gerät eine andere Plattform installiert sein. Diese externe Plattform wird zum Ziel-Inbetriebnehmer. Wir haben eine weitere Instanz der Beispiel-App erstellt, die Sie als Ziel-Commissioner verwenden können.

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

  2. Installieren Sie den Ziel-Commissioner.

    $ 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 Teilen.

    Gerät gemeinsam nutzen

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

Ein Freigabeblatt wird angezeigt, in 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-Commissioner-App freigegeben werden muss
  2. Mit einer lokalen Android-App, die als Matter-Beauftragter registriert ist

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

Als Nächstes schließt die externe App (Ziel-Commissioning-Tool) 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, Nutzereinstellungen zu aktualisieren, Hilfe zu erhalten und mehr über die App zu erfahren.

Einstellungen

Halbsheet-Benachrichtigung

In den Einstellungen können Sie proaktive Benachrichtigungen zur Auffindung von Matter-Geräten deaktivieren.

Wenn Ihre Anwendung einen eigenen Matter-Erkennungs- oder Einrichtungsvorgang bietet, können Sie diese Benachrichtigungen unterdrücken, um Unterbrechungen zu vermeiden. Weitere Informationen finden Sie unter Benachrichtigungen zur Erkennung von in Betrieb zu nehmenden Geräten unterdrücken.

Entwickler-Tools

Über den Bildschirm „Einstellungen“ können Sie auch auf Entwicklertools zugreifen.

So prüfen Sie den Inhalt der DataStore-Repositories für Geräte- und Nutzereinstellungen in Logcat:

  1. Klicken Sie auf Repository-Inhalte protokollieren.

  2. Klicken Sie im Dialogfeld auf OK und dann auf 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 bitte unser Feedbackformular aus.

Feedback geben

Wenn Sie Probleme mit Sample App for Matter haben, führen Sie die folgenden Schritte aus, um Ihre Umgebung zu bestätigen:

Wenn Sie Fragen zur Verwendung der Beispiel-App haben oder einen Codefehler entdecken, können Sie Probleme im Issue Tracker im GitHub-Repository melden:

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

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