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.

Elimina le notifiche di rilevamento della commissione

Notifica Halfsheet Android
Figura 1: esempio di notifica di un semifoglio Android

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

Per evitare interruzioni mentre l'app è in primo piano, puoi eliminare queste notifiche chiamando il metodo suppressHalfSheetNotification() in Mobile SDK. Per saperne di più, 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, richiama di nuovo suppressHalfSheetNotification(), altrimenti inizieranno a essere visualizzate le notifiche di Halfsheet.

L'implementazione di questa API è disponibile in Google Home Sample App for Matter. Per saperne di più, consulta 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 API Matter e indicare che la tua app supporta il commit di Matter gestendo 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>

Per riferimento, consulta il file manifest dell'app di esempio.

Selettore app

Selettore app

La tua app può essere visualizzata nel selettore di app durante la procedura di messa in servizio in due modi:

  1. Nella schermata Scegli un'app.
  2. Se gli utenti selezionano Scegli un'altra app, questa verrà visualizzata nella 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 commissioner preferita del produttore del dispositivo

Esistono due scenari in cui le app si trovano nella schermata Scegli un'app.

  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.