Cette page explique comment utiliser certaines fonctionnalités de l'API de mise en service dans Google Home Mobile SDK.
Supprimer les notifications de découverte ouvrant droit à commission
Par défaut, Google Play services sur Android utilise des notifications de "demi-feuille" qui couvrent la moitié inférieure de l'écran d'un appareil mobile pour fournir aux utilisateurs une indication proactive que des appareils Matter ouvrant droit à commission se trouvent à proximité.
Pour éviter toute interruption lorsque votre application est au premier plan, vous pouvez supprimer ces notifications en appelant la méthode suppressHalfSheetNotification() dans Mobile SDK. Pour en savoir plus, consultez la documentation de l'API.
La suppression activée par cette API expire si votre application est exécutée au premier plan pendant plus de 15 minutes. Pour réactiver la suppression après un délai, appelez à nouveau suppressHalfSheetNotification(). Sinon, des notifications de demi-feuille commenceront à s'afficher.
Vous trouverez une implémentation de cette API dans Google Home Sample App for Matter. Pour en savoir plus, consultez HalfSheetSuppressionObserver.kt.
Indiquer la compatibilité avec la mise en service Matter
Si vous utilisez Mobile SDK pour effectuer des commissions, vous devez ajouter le nom du package de l'application dans le Google Home Developer Console, implémenter nos API Matter et indiquer que votre application prend en charge la mise en service Matter en gérant l'intent ACTION_COMMISSION_DEVICE.
Ajoutez l'élément intent-filter suivant à la déclaration application de votre fichier AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Pour en savoir plus, consultez le fichier manifeste de notre application exemple.
Outil de sélection d'applications
Votre application apparaît dans l'outil de sélection d'applications de deux manières lors du processus de mise en service:
- Sur l'écran Sélectionner une application
- Si les utilisateurs sélectionnent Choisir une autre application, l'application s'affiche sur l'écran Autres applications installées.
Applis suggérées
L'outil de sélection d'applications affiche deux suggestions d'applications.
- La première est toujours Google Home app (GHA).
- La seconde concerne l'application préférée du fabricant de l'appareil, si elle est définie dans un projet Developer Console associé au VID ou au PID de l'appareil.
Il existe deux cas de figure lorsque les applications figurent sur l'écran Sélectionner une application.
- Installée : Play services vérifie que l'application est compatible avec le filtre d'intent
ACTION_COMMISSION_DEVICE. Si le filtre d'intent est manquant, l'utilisateur est redirigé vers le Play Store pour mettre à jour l'application. - Non installée : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.