Google Home Sample App for Matter

Google Home-Beispiel-App für Matter

Der Google Home Sample App for Matter verwendet das 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 in der lokalen Android-Fabric in Betrieb nehmen
  • Physische und virtuelle Geräte in einer Entwicklungs-Fabric in Betrieb nehmen
  • Geräte in deiner Entwicklungsumgebung steuern, z. B. ein Licht einschalten
  • Mit den Funktionen für mehrere Administratoren kannst du Geräte in der Entwicklungsumgebung für andere Apps freigeben und umgekehrt Geräte, die von anderen Apps freigegeben wurden, in die Entwicklungsumgebung einbinden.
  • Entwickler-Dienstprogramme

In diesem Leitfaden wird beschrieben, wie du das Sample App for Matter-APK installierst und damit Matter-Geräte in Betrieb nimmst, steuerst und freigibst.

Wenn Sie den Quellcode herunterladen, die Mobile SDK einbinden und Bildschirme in Android Studio anpassen möchten, probieren Sie unser Sample App for Matter-Codelab aus.

Zum Codelab Sample App for Matter

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 Abschnitt „Assets“ nach dem APK mit dem Namen GHSAFM-version-default-debug.apk für die neueste Version. 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 die Dateiübertragung. Installieren Sie dann das 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 Admin-Bereich der App aktualisieren.

In den nächsten Schritten fügst du der lokalen Android-Fabric ein Matter-Gerät sowie eine Entwicklungs-Fabric hinzu, die nur für die Beispiel-App lokal ist.

Was sind Matter-Fabrics?

Google Home-Beispiel-App für Matter

Eine Matter-Fabric ist eine gemeinsame Vertrauensdomain 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, einer App oder einer 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 Inbetriebnahme von Matter 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 übertragen, das über einen Aufruf von Mobile SDK gestartet wird. Um den Besitz nachzuweisen, scanne den QR‑Code oder tippe auf Kopplungscode verwenden.

    QR-Code scannen

  3. Gib nach Abschluss der Inbetriebnahme einen Gerätenamen ein und tippe dann auf Fertig.

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

Alle Inbetriebnahmeaufgaben und die zugehörigen Bildschirme werden bei der Inbetriebnahme von Geräten von Play services verarbeitet. Dies sorgt für eine einheitliche Nutzererfahrung und macht die Handhabung vertraulicher Berechtigungen, z. B. WLAN- und Thread-Anmeldedaten, überflüssig.

Geräte steuern

Die Entwicklungsumgebung erstellt die Anmeldedaten, um Matter-Geräte direkt über die Beispiel-App zu steuern.

Auf dem Startbildschirm kannst du dein Gerät ein- oder ausschalten. Tippe auf das Gerät, um die Gerätedetails aufzurufen.

Gerät hinzugefügt

Geräte gemeinsam verwenden

Die Freigabe 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, kannst du es ganz einfach mit anderen Ökosystemen teilen.

Wenn du dein Matter-Gerät mit anderen Ökosystemen teilen möchtest, musst du eine andere Plattform auf deinem Android-Gerät installiert haben. Diese externe Plattform wird zum Ziel-Commissioner. 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 Abschnitt „Assets“ nach dem APK mit dem Namen GHSAFM-version-targetcommissioner-debug.apk für die neueste Version. Wählen Sie nicht default aus.

  2. Installiere den Ziel-Commissioner.

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

  3. Tippe auf dem Startbildschirm auf das Gerät, um die Geräteinformationen aufzurufen. Tippe auf Teilen.

    Gerät gemeinsam nutzen

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

Es wird ein Freigabeblatt angezeigt, auf dem du die App oder Plattform auswählen kannst, mit der du das Gerät koppeln möchtest. Auf diesem Bildschirm hast du zwei Möglichkeiten, das Gerät zu teilen:

  1. Manuell über einen Einrichtungscode, der mit der Ziel-Commissioner-App geteilt werden muss
  2. Mit einer lokalen Android-App, die als Matter-Commissioner registriert ist

Die Ziel-Commissioner-App ist mit GHSAFM-TC gekennzeichnet. Tippe auf diese Instanz der Beispiel-App, um dein Gerät zu teilen.

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

Einstellungen

Klicke auf dem Startbildschirm auf das Symbol für die Einstellungen . Hier können Sie die Nutzereinstellungen aktualisieren, Hilfe erhalten und mehr über die App erfahren.

Einstellungen

Halbseitige Benachrichtigung

In den Einstellungen kannst du die proaktiven Benachrichtigungen zur Erkennung von Geräten, die für die Inbetriebnahme bereit sind, für Matter-Geräte deaktivieren.

Wenn deine Anwendung einen eigenen Matter-Erkennungs- oder ‑Inbetriebnahmeablauf bietet, kannst du diese Benachrichtigungen unterdrücken, um Unterbrechungen zu vermeiden. Weitere Informationen findest du unter Benachrichtigungen zur Erkennung von provisionspflichtigen Geräten unterdrücken.

Entwickler-Dienstprogramme

Über den Bildschirm „Einstellungen“ kannst du auch auf die Entwickler-Dienstprogramme zugreifen.

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

  1. Klicken Sie auf Inhalt von Log-Repositories.

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

Feedback und Hilfe

Wenn Sie uns Ihre Meinung 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 geben

Wenn Sie Probleme mit dem Sample App for Matter haben, führen Sie die Schritte zur Überprüfung Ihrer Umgebung aus:

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

Wenn du offizielle Antworten von Google auf technische Fragen erhalten möchtest, verwende das Smart Home-Entwicklerforum:

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