Google Home Beispiel-App für die Rechtsangelegenheit

Google Home-Beispiel-App für Matter

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

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

  1. 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 nicht targetcommissioner aus:

    APK herunterladen

  2. Installieren Sie Android Debug Bridge (adb):

    ADB installieren

  3. 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?

Google Home-Beispiel-App für Matter

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:

  1. Tippen Sie auf die Schaltfläche Gerät hinzufügen, um die Inbetriebnahme zu starten.

    Gerät hinzufügen

  2. 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.

    QR-Code scannen

  3. 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ät hinzugefügt

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.

  1. 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:

    Den Zielkommissar herunterladen

  2. Zielkommission installieren

    $ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apk
    
  3. Tippen Sie auf dem Startbildschirm auf das Gerät, um die Geräteinformationen aufzurufen. Tippen Sie auf Teilen.

    Gerät 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:

  1. Manuell über einen Einrichtungscode, der mit der Zielkommissions-App geteilt wird
  2. 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.

Einstellungen

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:

  1. Klicken Sie auf Inhalte von Repositories protokollieren.

  2. 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.

Feedback geben

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: