Questa pagina illustra l'utilizzo di alcune funzionalità dell'API di commissione in Google Home Mobile SDK.
Elimina le notifiche di scoperta commissionabili
Per impostazione predefinita, Google Play services su Android utilizza notifiche "halfsheet" 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
disattivare queste notifiche chiamando il
metodo suppressHalfSheetNotification()
in Mobile SDK. Per saperne di più, consulta la documentazione dell'API.
La soppressione attivata 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 inizieranno a essere visualizzate le notifiche della scheda.
Un'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 applicativo
in Google Home Developer Console, implementare le nostre API Matter
e indicare che la tua app supporta la commissione
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 app
Esistono due modi in cui la tua app viene visualizzata nel selettore di app durante il processo di messa in servizio:
- Nella schermata Scegli un'app.
- Se gli utenti selezionano Scegli un'altra app, l'app 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 è definita in un progetto Developer Console associato al VID o al PID del dispositivo.
Esistono due scenari in cui le app si trovano nella schermata Scegli un'app.
- 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.