Mise en service du SDK Home Mobile

Cette page explique comment utiliser certaines fonctionnalités de l'API de mise en service dans le Google Home Mobile SDK.

Supprimer les notifications de découverte des appareils pouvant être mis en service

Notification Android Halfsheet
Figure 1 : Exemple de notification Android halfsheet

Par défaut, Google Play services sur Android utilise "halfsheet" notifications 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 pouvant être mis en service se trouvent à proximité.

Pour éviter les interruptions lorsque votre application est au premier plan, vous pouvez supprimer ces notifications en appelant la suppressHalfSheetNotification() méthode dans le Mobile SDK. Pour plus d'informations, 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, les notifications halfsheet commenceront à s'afficher.

Vous trouverez une implémentation de cette API dans le 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 le Mobile SDK pour la mise en service, vous devez ajouter le nom du package de l'application dans la Google Home Developer Console, implémenter nos Matter API 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>

Pour référence, consultez le fichier manifeste de notre exemple d'application.

Sélecteur d'application

Sélecteur d&#39;applications

Votre application peut apparaître de deux manières dans le sélecteur d'application lors du processus de mise en service :

  1. Sur l'écran Choisir une application.
  2. Si les utilisateurs sélectionnent Choisir une autre application, elle s'affiche sur l'écran Autres applications installées.

Applications suggérées

Le sélecteur d'application affiche deux applications suggérées.

  • La première est toujours Google Home app (GHA).
  • La deuxième est l'application préférée du fabricant de l'appareil, si elle est définie dans un Developer Console projet associé au VID ou au PID de l' appareil. Application de streaming préférée du fabricant de l&#39;appareil

Les applications s'affichent sur l'écran Choisir une application dans deux cas de figure.

  1. Installée : Play services vérifient que l'application est compatible avec le ACTION_COMMISSION_DEVICE filtre d'intent. Si le filtre d'intent est manquant, l'utilisateur est redirigé vers le Play Store pour mettre à jour l'application.
  2. Non installée : l'utilisateur est redirigé vers le Play Store pour installer l'application avant de continuer.