Home Mobile SDK – Inbetriebnahme

Auf dieser Seite wird die Verwendung ausgewählter Funktionen der Commissioning API in der Google Home Mobile SDK beschrieben.

Benachrichtigungen zu Entdeckungen mit Provisionsmöglichkeit unterdrücken

Android-Benachrichtigung im Halbbildschirmformat
Abbildung 1: Beispiel für eine Android-Benachrichtigung im Halfsheet-Format

Standardmäßig werden bei Google Play services auf Android „Halbseitenbenachrichtigungen“ verwendet, die die untere Hälfte des Bildschirms eines Mobilgeräts bedecken. So werden Nutzer proaktiv darüber informiert, dass sich in der Nähe Geräte mit Matter befinden, für die eine Provision infrage kommt.

Wenn Sie Unterbrechungen vermeiden möchten, während Ihre App im Vordergrund ist, können Sie diese Benachrichtigungen unterdrücken, indem Sie die Methode suppressHalfSheetNotification() in der Mobile SDK aufrufen. Weitere Informationen finden Sie in der API-Dokumentation.

Die durch diese API aktivierte Unterdrückung läuft ab, wenn Ihre App länger als 15 Minuten im Vordergrund ausgeführt wird. Wenn Sie die Unterdrückung nach Ablauf der Zeitüberschreitung wieder aktivieren möchten, rufen Sie suppressHalfSheetNotification() noch einmal auf. Andernfalls werden Benachrichtigungen im halben Display angezeigt.

Eine Implementierung dieser API finden Sie im Google Home Sample App for Matter. Weitere Informationen finden Sie unter HalfSheetSuppressionObserver.kt.

Unterstützung für die Matter-Inbetriebnahme angeben

Wenn Sie die Mobile SDK zur Inbetriebnahme verwenden, müssen Sie den Namen des App-Pakets in der Google Home Developer Console hinzufügen, unsere Matter APIs implementieren und angeben, dass Ihre App die Matter-Inbetriebnahme unterstützt, indem Sie den ACTION_COMMISSION_DEVICE-Intent verarbeiten.

Fügen Sie der application-Deklaration in der Datei AndroidManifest.xml die folgende intent-filter hinzu:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

Weitere Informationen finden Sie im Manifest unserer Beispiel-App.

App-Auswahl

App-Auswahl

Es gibt zwei Möglichkeiten, wie Ihre App während der Inbetriebnahme in der App-Auswahl angezeigt wird:

  1. Auf dem Bildschirm App auswählen
  2. Wenn Nutzer Andere App auswählen auswählen, wird die App auf dem Bildschirm Andere installierte Apps angezeigt.

Vorgeschlagene Apps

In der App-Auswahl werden zwei vorgeschlagene Apps angezeigt.

  • Die erste ist immer Google Home app (GHA).
  • Die zweite ist für die bevorzugte App des Geräteherstellers, sofern sie in einem Developer Console-Projekt definiert ist, das mit der VID oder PID des Geräts verknüpft ist. Von Geräteherstellern bevorzugte App des Auftragsverarbeiters

Es gibt zwei Szenarien, in denen die Apps auf dem Bildschirm App auswählen angezeigt werden.

  1. Installiert: Play services Prüfen Sie, ob die Anwendung den Intent-Filter ACTION_COMMISSION_DEVICE unterstützt. Wenn der Intent-Filter fehlt, wird der Nutzer zum Play Store weitergeleitet, um die App zu aktualisieren.
  2. Nicht installiert: Der Nutzer wird zum Play Store weitergeleitet, um die App zu installieren, bevor er fortfahren kann.