Questa pagina illustra l'utilizzo di alcune funzionalità dell'API di provisioning in Google Home Mobile SDK.
Disattivare le notifiche di scoperta commissionabili
Per impostazione predefinita, Google Play services su Android utilizza notifiche "a 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 mentre l'app è in primo piano, puoi
disattivare queste notifiche chiamando il metodo
suppressHalfSheetNotification()
in Mobile SDK. Per ulteriori informazioni, consulta la documentazione dell'API.
La soppressione abilitata da questa API scade se la tua 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 a metà foglio.
Un'implementazione di questa API è disponibile in
Google Home Sample App for Matter. Per saperne di più, consulta
HalfSheetSuppressionObserver.kt.
Indicare il supporto per il commissioning 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 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 dell'app di esempio.
Selettore di app
Esistono due modi in cui la tua app viene visualizzata nel selettore di app durante la procedura di commissioning:
- Nella schermata Scegli un'app.
- Se gli utenti selezionano Scegli un'altra app, questa verrà visualizzata nella schermata Altre app installate.
App suggerite
Il selettore di app mostra due app suggerite.
- Il primo è sempre Google Home app (GHA).
- La seconda è 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 di intent
ACTION_COMMISSION_DEVICE. Se il filtro per intent è mancante, 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.