Home Mobile SDK – Inbetriebnahme

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

Benachrichtigungen zur Erkennung von Geräten unterdrücken, die in Betrieb genommen werden können

Halbsheet-Benachrichtigung für Android
Abbildung 1: Beispiel für eine Android-Halbsheet-Benachrichtigung

Standardmäßig verwendet Google Play services unter Android Halbsheet-Benachrichtigungen, die die untere Hälfte des Bildschirms eines Mobilgeräts abdecken, um Nutzern proaktiv mitzuteilen, dass sich Geräte in der Nähe befinden, die in Betrieb genommen werden können.Matter

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

Die durch diese API aktivierte Unterdrückung läuft ab, wenn sich Ihre App länger als 15 Minuten im Vordergrund befindet. Wenn Sie die Unterdrückung nach einem Timeout wieder aktivieren möchten, rufen Sie suppressHalfSheetNotification() noch einmal auf. Andernfalls werden Halbsheet-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 Matter-Inbetriebnahme angeben

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

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

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

Eine Referenz finden Sie im Manifest unserer Beispiel-App.

App-Auswahl

App-Auswahl

Ihre App kann während der Inbetriebnahme auf zwei Arten in der App-Auswahl angezeigt werden:

  1. Auf dem Bildschirm App auswählen.
  2. Wenn Nutzer Andere App auswählen auswählen, wird sie 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 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. Bevorzugte Commissioner-App des Geräteherstellers

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

  1. Installiert : Play services prüfen, ob die Anwendung den ACTION_COMMISSION_DEVICE-Intent-Filter 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.