Home Mobile SDK – Inbetriebnahme

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

Benachrichtigungen zu provisionspflichtigen Discovery-Kampagnen unterdrücken

Standardmäßig verwendet Google Play services auf Android „Halfsheet“-Benachrichtigungen, die die untere Bildschirmhälfte eines Mobilgeräts einnehmen, um Nutzern proaktiv zu signalisieren, dass sich in der Nähe in der Nähe in der Nähe einsatzbereite Matter-Geräte befinden.

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

Bei der von dieser API aktivierten Unterdrückung tritt eine Zeitüberschreitung auf, wenn Ihre App 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 Halbblatt-Benachrichtigungen angezeigt.

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

Unterstützung für die Inbetriebnahme von Matter angeben

Wenn Sie Mobile SDK für die Inbetriebnahme verwenden, müssen Sie den Paketnamen der Anwendung in Google Home Developer Console einfügen, unsere Matter APIs implementieren und angeben, dass Ihre Anwendung die Inbetriebnahme Matter unterstützt, indem Sie den Intent ACTION_COMMISSION_DEVICE verarbeiten.

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 der Beispiel-App.

App-Auswahl

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

1. Öffnen Sie den Bildschirm App auswählen.
2. Wenn Nutzer Andere App auswählen auswählen, wird sie auf dem Bildschirm Weitere 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, wenn sie in einem Developer Console-Projekt definiert ist, das mit der VID oder PID des Geräts verknüpft ist.

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

1. Installiert: Play services prü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, wo er die App installieren kann, bevor er fortfahren kann.