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 pouvant générer des commissions
Par défaut, Google Play services sur Android utilise des notifications "demi-feuille" qui couvrent la moitié inférieure de l'écran d'un appareil mobile pour indiquer aux utilisateurs de manière proactive que des appareils Matter commissionnables 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 au premier plan pendant plus de 15 minutes. Pour réactiver la suppression après un délai avant expiration, appelez à nouveau suppressHalfSheetNotification(), sinon des notifications demi-fenêtre 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 prise en charge de la mise en service Matter
Si vous utilisez Mobile SDK pour la mise en service, vous devez ajouter le nom du package de l'application dans Google Home Developer Console, implémenter nos API Matter et indiquer que votre application est compatible avec la mise en service Matter en gérant l'intent ACTION_COMMISSION_DEVICE.
Ajoutez le intent-filter suivant à la déclaration application dans votre fichier AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Consultez le fichier manifeste de notre application exemple pour référence.
Sélecteur d'applications
Votre application apparaît de deux manières différentes dans le sélecteur d'applications lors du processus de mise en service:
- Sur l'écran Choisir une application.
- Si les utilisateurs sélectionnent Choisir une autre application, elle s'affiche sur l'écran Autres applications installées.
Applis suggérées
Le sélecteur d'applications affiche deux applications suggérées.
- Le premier est toujours Google Home app (GHA).
- Le second est destiné à 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.
Deux scénarios sont possibles lorsque les applications s'affichent sur l'écran Choisir une application.
- Installé : 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.