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
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
Durante la procedura di messa in servizio, la tua app viene visualizzata nel selettore di app in due modi:
- Nella schermata Scegli un'app.
- 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.
Nella schermata Scegli un'app le app sono due.
- 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. - Non installata. L'utente viene indirizzato al Play Store per installare l'app prima di continuare.