Messa in servizio dell'SDK Home Mobile

Questa pagina illustra l'utilizzo di determinate funzionalità dell'API di messa in servizio in Google Home Mobile SDK.

Eliminare le notifiche relative alle scoperte idonee per la commissione

Notifica half-sheet per Android
Figura 1: esempio di notifica half-sheet per Android

Per impostazione predefinita, Google Play services su Android utilizza notifiche "half-sheet" che coprono la metà inferiore dello schermo di un dispositivo mobile per fornire agli utenti un'indicazione proattiva della presenza di dispositiviMatter commissionabili nelle vicinanze.

Per evitare interruzioni mentre l'app è in primo piano, puoi подавлять эти уведомления, вызовом метода suppressHalfSheetNotification() в Mobile SDK. Per ulteriori informazioni, consulta la documentazione dell'API.

La soppressione abilitata da questa API scade se l'app è in primo piano per più di 15 minuti. Per riattivare la soppressione dopo un timeout, chiama di nuovosuppressHalfSheetNotification(), altrimenti inizieranno a essere visualizzate le notifiche a metà pagina.

Un'implementazione di questa API è disponibile in Google Home Sample App for Matter. Per saperne di più, consulta HalfSheetSuppressionObserver.kt.

Indicare il supporto per la messa in servizio Matter

Se utilizzi il Mobile SDK per la messa in servizio, devi aggiungere il nome del pacchetto dell'app in Google Home Developer Console, implementare le nostre API Matter e indicare che la tua app supporta la messa in servizio Matter gestire l'intent ACTION_COMMISSION_DEVICE.

Aggiungi il seguente intent-filter alla dichiarazione application nel file AndroidManifest.xml:

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

Consulta il manifest dell'app di esempio come riferimento.

Selettore di app

Selettore di app

Esistono due modi in cui la tua app viene visualizzata nel selettore di app durante la procedura di messa in servizio:

  1. Nella schermata Scegli un'app.
  2. Se gli utenti selezionano Scegli un'altra app, verrà visualizzata la schermata Altre app installate.

App consigliate

Il selettore di app mostra due app suggerite.

  • Il primo è sempre Google Home app (GHA).
  • Il secondo è per l'app preferita del produttore del dispositivo, se è definito in un progetto Developer Console associato al VID o al PID del dispositivo. App del commissario preferita dal produttore del dispositivo

Esistono due scenari quando le app sono nella schermata Scegli un'app.

  1. Installata: Play services verifica che l'applicazione supporti il filtro per intent ACTION_COMMISSION_DEVICE. Se il filtro intent non è presente, l'utente viene indirizzato al Play Store per aggiornare l'app.
  2. Non installata: l'utente viene indirizzato al Play Store per installare l'app prima di continuare.