Messa in servizio dell'SDK Home Mobile

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

Elimina le notifiche di rilevamento commissionabile

Notifica Halfsheet Android
Figura 1: esempio di notifica di mezzo foglio per Android

Per impostazione predefinita, Google Play services su Android usa le notifiche "metà foglio" che coprono la metà inferiore dello schermo di un dispositivo mobile per fornire agli utenti un'indicazione proattiva che i dispositivi Matter commissionabili si trovano nelle vicinanze.

Per evitare interruzioni quando la tua app è in primo piano, puoi eliminare queste notifiche chiamando il metodo suppressHalfSheetNotification() in Mobile SDK. Per ulteriori informazioni, consulta la documentazione dell'API.

L'eliminazione abilitata da questa API scade se la tua app è in primo piano per più di 15 minuti. Per riattivare l'eliminazione dopo un timeout, chiama di nuovo suppressHalfSheetNotification(), altrimenti le notifiche a metà foglio inizieranno a essere visualizzate.

Un'implementazione di questa API è disponibile in Google Home Sample App for Matter. Per ulteriori informazioni, visita la pagina HalfSheetSuppressionObserver.kt.

Indica il supporto per la messa in servizio di Matter

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

Aggiungi il seguente elemento intent-filter alla dichiarazione application all'interno del file AndroidManifest.xml:

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

Consulta il nostro file manifest dell'app di esempio come riferimento.

Selettore app

Selettore app

Durante la procedura di messa in servizio, la tua app viene visualizzata nel selettore di app in due modi:

  1. Nella schermata Scegli un'app.
  2. Se gli utenti selezionano Scegli un'altra app, l'app verrà mostrata nella schermata Altre app installate.

App consigliate

Il selettore di app mostra due app consigliate.

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

Nella schermata Scegli un'app le app sono due.

  1. Installata: Play services verifica che l'applicazione supporti il filtro per intent ACTION_COMMISSION_DEVICE. Se il filtro per 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.