En esta página, se aborda el uso de funciones selectas de la API de puesta en servicio en el Google Home Mobile SDK.
Cómo suprimir las notificaciones de descubrimiento de dispositivos que se pueden poner en servicio
De forma predeterminada, Google Play services en Android usa notificaciones de "media hoja" que cubren la mitad inferior de la pantalla de un dispositivo móvil para proporcionar a los usuarios una indicación proactiva de que hay dispositivos Matter que se pueden poner en servicio cerca.
Para evitar interrupciones mientras la app está en primer plano, puedes
suprimir estas notificaciones llamando al
suppressHalfSheetNotification()
método en el Mobile SDK. Consulta la documentación sobre la API de para obtener más información.
La supresión habilitada por esta API se agota si tu app está en primer plano durante más de 15 minutos. Para volver a habilitar la supresión después de un tiempo de espera, vuelve a llamar a suppressHalfSheetNotification(). De lo contrario, comenzarán a aparecer las notificaciones de media hoja.
Puedes encontrar una implementación de esta API en la
Google Home Sample App for Matter. Consulta
HalfSheetSuppressionObserver.kt
para obtener más información.
Cómo indicar la compatibilidad con la puesta en servicio de Matter
Si usas el Mobile SDK para la puesta en servicio, debes
agregar el nombre del paquete de la app
en la Google Home Developer Console, implementar nuestras Matter
APIs y, luego, indicar que tu app admite la puesta en servicio de Matter
controlando el intent ACTION_COMMISSION_DEVICE.
Agrega el siguiente intent-filter a la declaración application dentro de tu archivo AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Consulta el manifiesto de nuestra app de ejemplo como referencia.
Selector de apps
Existen dos formas en que aparece tu app en el selector de apps durante el proceso de puesta en servicio:
- En la pantalla Elegir una app.
- Si los usuarios seleccionan Elegir otra app, se mostrará en la pantalla Otras apps instaladas.
Apps sugeridas
El selector de apps muestra dos apps sugeridas.
- La primera siempre es Google Home app (GHA).
- La segunda es para la app preferida del fabricante del dispositivo, si se define en un
Developer Console proyecto asociado con el VID o el PID del
dispositivo.
Existen dos situaciones en las que las apps se encuentran en la pantalla Elegir una app.
- Instalada : Play services verifican que la aplicación admita el filtro de intents
ACTION_COMMISSION_DEVICE. Si falta el filtro de intents, se dirige al usuario a Play Store para que actualice la app. - No instalada : Se dirige al usuario a Play Store para que instale la app antes de continuar.