Home Mobile SDK – Inbetriebnahme

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

Benachrichtigungen über die Erkennung von Provisionsabschlüssen unterdrücken

Android-Halbblatt-Benachrichtigung
Abbildung 1: Beispiel für eine halbseitige Android-Benachrichtigung

Standardmäßig verwendet Google Play services auf Android „Halfsheet“-Benachrichtigungen, die die untere Hälfte des Bildschirms eines Mobilgeräts abdecken, um Nutzer proaktiv darauf hinzuweisen, dass sich in Betrieb nehmende Matter-Geräte in der Nähe befinden.

Um Unterbrechungen zu vermeiden, während die App im Vordergrund ausgeführt wird, können Sie diese Benachrichtigungen unterdrücken. Rufen Sie dazu die Methode suppressHalfSheetNotification() im Mobile SDK auf. Weitere Informationen finden Sie in der API-Dokumentation.

Bei der durch diese API aktivierten Unterdrückung tritt eine Zeitüberschreitung auf, wenn Ihre Anwendung länger als 15 Minuten im Vordergrund ausgeführt wird. Wenn Sie die Unterdrückung nach einer Zeitüberschreitung wieder aktivieren möchten, rufen Sie noch einmal suppressHalfSheetNotification() auf. Andernfalls werden halbseitige Benachrichtigungen angezeigt.

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

Unterstützung für Matter-Inbetriebnahme angeben

Wenn du die Mobile SDK für die Provision verwendest, musst du den App-Paketnamen in der Google Home Developer Console hinzufügen, unsere Matter-APIs implementieren und angeben, dass deine App die Matter-Inbetriebnahme unterstützt, indem du den ACTION_COMMISSION_DEVICE-Intent verarbeitet.

Fügen Sie der Deklaration application 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 einer Beispiel-App.

App-Auswahl

App-Auswahl

Es gibt zwei Möglichkeiten, wie Ihre Anwendung während der Inbetriebnahme in der Anwendungsauswahl angezeigt wird:

  1. Öffnen Sie den Bildschirm App auswählen.
  2. Wenn Nutzer Andere App auswählen auswählen, wird dies auf dem Bildschirm Andere installierte Apps angezeigt.

Empfohlene Apps

In der App-Auswahl werden zwei vorgeschlagene Apps angezeigt.

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

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

  1. Installiert: Mit Play services wird geprüft, 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 fortfährt.