Messa in servizio dell'SDK Home Mobile

Questa pagina illustra l'utilizzo di alcune funzionalità dell'API di provisioning nel Google Home Mobile SDK.

Sopprimere le notifiche di rilevamento dei dispositivi commissionabili

Notifica di metà foglio di Android
Figura 1: esempio di notifica a metà schermo di Android

Per impostazione predefinita, Google Play services su Android utilizza "notifiche a metà schermo" che coprono la metà inferiore dello schermo di un dispositivo mobile per fornire agli utenti un'indicazione proattiva che indica la presenza di dispositivi Matter commissionabili Nelle vicinanze.

Per evitare interruzioni mentre l'app è in primo piano, puoi sopprimere queste notifiche chiamando il suppressHalfSheetNotification() metodo in 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 nuovo suppressHalfSheetNotification(), altrimenti le notifiche a metà schermo inizieranno a essere visualizzate.

Un'implementazione di questa API è disponibile nel Google Home Sample App for Matter. Per ulteriori informazioni, consulta HalfSheetSuppressionObserver.kt.

Indicare il supporto per il provisioning di Matter

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

Aggiungi il seguente 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>

Per riferimento, consulta il manifest della nostra app di esempio.

Selettore di app

Selettore app

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

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

App suggerite

Il selettore di app mostra due app suggerite.

  • La prima è sempre Google Home app (GHA).
  • La seconda è l'app preferita del produttore del dispositivo, se definita in un Developer Console progetto associato al VID o al PID del dispositivo. App di commissioning preferita del produttore del dispositivo

Esistono due scenari in cui le app vengono visualizzate nella schermata Scegli un'app.

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