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 donnant droit à une commission
Par défaut, Google Play services sur Android utilise des notifications "halfsheet" qui couvrent la moitié inférieure de l'écran d'un appareil mobile pour indiquer de manière proactive aux utilisateurs que des appareils Matter commissionnables se trouvent à proximité.
Pour éviter les interruptions 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 d'inactivité, appelez à nouveau suppressHalfSheetNotification(). Sinon, des notifications en 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 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'intention 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>
Pour référence, consultez le fichier manifeste de notre application exemple.
Sélecteur d'applications
Votre application peut apparaître de deux manières 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, l'application s'affiche sur l'écran Autres applications installées.
Applications suggérées
Le sélecteur d'applications affiche deux applications suggérées.
- 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 scénarios dans lesquels les applications s'affichent sur l'écran Choisir une application.
- Installée : Play services vérifiez 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é : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.