Cette page explique comment utiliser certaines fonctionnalités de l'API Commissioning dans le Google Home Mobile SDK.
Supprimer les notifications de découverte ouvrant droit à commission
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 que des appareils Matter ouvrant droit à commission 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 exécutée au premier plan pendant plus de 15 minutes. Pour réactiver la suppression après un délai d'inactivité, appelez de 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 la Mobile SDK pour la commission, 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 en savoir plus.
Outil de sélection d'applications
Votre application apparaît de deux façons dans le sélecteur d'applications au cours du processus de mise en service:
- Sur l'écran Sélectionner une application.
- Si les utilisateurs sélectionnent Choisir une autre application, l'écran Autres applications installées s'affiche.
Applications suggérées
L'outil de sélection d'applications affiche deux suggestions d'applications.
- La première est toujours Google Home app (GHA).
- Le second 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 s'affichent sur l'écran Sélectionner une application.
- Installé : 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ée : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.