Google Home Sample App for Matter erstellt mithilfe von Google Home Mobile SDK eine Android-App, die Google Home app (GHA) ähnelt. Diese Beispiel-App bietet folgende Funktionen:
- Physische und virtuelle Matter-Geräte für die lokale Android-Struktur ausgeben
- Physische und virtuelle Geräte in der Entwicklungsumgebung in Auftrag geben
- Geräte in der Entwicklungsumgebung steuern, z. B. ein Licht einschalten
- Mithilfe von Multi-Admin-Funktionen können Sie Geräte, die sich in der Entwicklungsumgebung befinden, mit anderen Apps teilen und umgekehrt die Entwicklungsgeräte, die von anderen Apps gemeinsam genutzt werden, einbeziehen.
- Entwicklerprogramme
In dieser Anleitung wird beschrieben, wie Sie das APK Sample App for Matter installieren und mit dem Gerät Matter-Geräte in Betrieb nehmen, steuern und freigeben.
Wenn Sie den Quellcode herunterladen möchten, erfahren Sie im Sample App for Matter-Codelab, wie Sie Mobile SDK einbinden und Bildschirme in Android Studio anpassen.
Zum Codelab Sample App for Matter
Voraussetzungen
- Ein Gerät mit Android O (8.1, API-Level 27) oder höher, das für Tests verfügbar ist. Wie du sicherst, dass dein Gerät über die neueste Matter-Unterstützung verfügt, erfährst du im Leitfaden zu Matter-Modulen und -diensten.
- Erstellen Sie ein Matter-Gerät mit Ein/Aus-Funktionen. Diese Beispielanwendung funktioniert mit einem virtuellen Gerät und einem ESP32.
- Erstelle ein virtuelles Matter-Gerät mit der
rootnode_dimmablelight_bCwGYSDpoe-App. Wenn du eine Matter-Integration in der Google Home Developer Console angibst, verwende0xFFF1als deine Anbieter-ID und0x8000als deine Produkt-ID. - Erstellen Sie ein Espressif-Gerät mit
all-clusters-app. Wenn du in der Developer Console eine Matter-Integration erstellst, verwende0xFFF1als Anbieter-ID und0x8001als Produkt-ID.
- Erstelle ein virtuelles Matter-Gerät mit der
Sie benötigen keinen Hub, z. B. ein Google Nest Hub (2nd gen), um Geräte mit dem Sample App for Matter in Betrieb zu nehmen und zu steuern.
Installieren
Rufen Sie im GitHub-Repository Sample App for Matter den Bereich „Releases“ auf. Suchen Sie das APK mit dem Namen
GHSAFM-1.4.1-default-debug.apk. Wählen Sie nichttargetcommissioneraus:Installieren Sie Android Debug Bridge (adb):
Verbinde dein Android-Gerät mit USB, aktiviere File Transfer und installiere das APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Provisionsgeräte
Wenn Sie die Beispielanwendung zum ersten Mal starten, erhalten Sie ein Dialogfeld mit einem Link zum Sample App for Matter-Codelab. Wenn Sie Diese Meldung nicht mehr anzeigen auswählen, können Sie das Dialogfeld jederzeit wieder aufrufen, indem Sie Ihre Einstellungen im Bereich „Admin“ der App aktualisieren.
In den nächsten Schritten fügen Sie dem lokalen Android-Gewebe ein Matter-Gerät sowie ein Entwicklungsmaterial hinzu, das nur in der Beispiel-App lokal ist.
Was sind Matter-Stoffe?
Ein Matter-Gewebe ist eine gemeinsame vertrauenswürdige Domain zwischen Geräten in einem Heimnetzwerk, das eine Kommunikation zwischen ihnen ermöglicht.
Geräte können eine oder mehrere Stoffe haben, die einer Plattform, einer App oder einer Gruppe von Geräten entsprechen, die miteinander interagieren. Fabrics haben eine eindeutige ID und Geräte haben dieselben Anmeldedaten und dieselbe Zertifizierungsstelle (CA). Diese Anmeldedaten werden während der Matter-Provision zugewiesen.
Wenn Sie ein Matter-Gerät in Betrieb nehmen möchten, gehen Sie so vor:
Tippen Sie auf die Schaltfläche Gerät hinzufügen, um die Inbetriebnahme zu starten.
Als Nächstes wird die Steuerung an Google Play services übertragen, die durch einen Aufruf von Mobile SDK gestartet wird. Zum Nachweis des Besitzrechts müssen Sie den QR-Code scannen oder auf Kopplungscode verwenden tippen.
Geben Sie nach Abschluss der Inbetriebnahme einen Gerätenamen ein und tippen Sie dann auf Fertig.
Dein Gerät ist jetzt sowohl mit dem lokalen Android-Fabric als auch mit dem Entwicklungs-Fabric verbunden.
Alle Inbetriebnahmearbeiten und die zugehörigen Bildschirme werden bei der Inbetriebnahme von Geräten von Play services verarbeitet. Dies sorgt für eine konsistente Nutzererfahrung und macht die Verwaltung sensibler Berechtigungen wie WLAN- und Thread-Anmeldedaten überflüssig.
Geräte steuern
Die Entwicklungsstruktur erstellt die Anmeldedaten, um Matter-Geräte direkt über die Beispiel-App zu steuern.
Auf dem Startbildschirm kannst du dein Gerät an oder ausschalten. Tippe auf das Gerät, um auf die Gerätedetails zuzugreifen.
Geräte gemeinsam verwenden
Das Teilen eines Geräts wird in der Matter-Spezifikation als Multi-Admin-Vorgang bezeichnet. Sobald ein Gerät für die Beispiel-App in Betrieb genommen wurde, können Sie es ganz einfach mit anderen Umgebungen teilen.
Wenn Sie Ihr Matter-Gerät mit anderen Systemen teilen möchten, muss auf Ihrem Android-Gerät eine andere Plattform installiert sein. Diese externe Plattform wird zum Zielbeauftragten. Wir haben eine weitere Instanz der Beispielanwendung erstellt, die Sie als Zielkommission verwenden können.
Rufen Sie im GitHub-Repository Sample App for Matter den Bereich „Releases“ auf. Suchen Sie das neueste APK mit dem Namen
GHSAFM-[version]-targetcommissioner. Beispiel:GHSAFM-1.4.1-targetcommissioner-debug.apk:Zielkommission installieren
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apkTippen Sie auf dem Startbildschirm auf das Gerät, um die Geräteinformationen aufzurufen. Tippen Sie auf Teilen.
Die Beispielanwendung ruft die Mobile SDK Share API auf. Auch hier wird die Steuerung an Play services übertragen.
Sie sehen ein geteiltes Tabellenblatt, in dem Sie die App oder Plattform auswählen können, mit der das Gerät gekoppelt werden soll. In diesem Bildschirm haben Sie zwei Möglichkeiten, das Gerät gemeinsam mit anderen zu nutzen:
- Manuell über einen Einrichtungscode, der mit der Zielkommissions-App geteilt wird
- Mit einer lokalen Android-App, die als Matter-Beauftragte registriert ist
Die Ziel-Kommissions-App hat das Label GHSAFM-TC. Tippen Sie auf diese Instanz der Beispiel-App, um Ihr Gerät freizugeben.
Als Nächstes schließt die externe App (Zielkommission) die Inbetriebnahme des Geräts in einen eigenen Stoff ab.
Einstellungen
Klicken Sie auf dem Startbildschirm auf das Symbol „Einstellungen“ . Hier haben Sie die Möglichkeit, die Nutzereinstellungen zu aktualisieren, Hilfe zu erhalten und mehr über die Anwendung zu erfahren.
Halbbogenbenachrichtigung
In den Einstellungen können Sie Benachrichtigungen zur proaktiven Provision für Matter-Geräte deaktivieren.
Wenn Ihre Anwendung einen eigenen Matter-Erkennungs- oder Provisionsablauf bietet, können Sie diese Benachrichtigungen unterdrücken, um Unterbrechungen zu vermeiden. Weitere Informationen finden Sie unter Provisionsbenachrichtigungen unterdrücken.
Entwicklerprogramme
Über die Einstellungen können Sie auch auf Dienstprogramme für Entwickler zugreifen.
Führen Sie die folgenden Schritte aus, um den Inhalt der Datenspeicher-Repositories für Geräte und Nutzer in Logcat zu prüfen:
Klicken Sie auf Inhalte von Repositories protokollieren.
Klicken Sie im Dialogfeld auf OK und dann auf Logcat.
Feedback und Hilfe
Wenn Sie uns mitteilen möchten, wie wir die Entwicklung mit Sample App for Matter verbessern können, füllen Sie bitte unser Feedbackformular aus.
Wenn Sie Probleme mit Sample App for Matter haben, führen Sie die Schritte zum Bestätigen Ihrer Umgebung aus:
Wenn Sie Fragen zur Verwendung der Beispiel-App haben oder einen Codefehler entdecken, können Sie Probleme über die Problemverfolgung im GitHub-Repository einreichen:
Offizielle Anleitungen von Google zu technischen Fragen erhalten Sie im Smart Home-Entwicklerforum:
Technischen Support aus der Community erhalten Sie über das Tag google-smart-home auf Stack Overflow: