En esta página, se explica el uso de funciones seleccionadas de la API de comisión en Google Home Mobile SDK.
Elimina las notificaciones de descubrimiento por comisión
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 los dispositivos Matter con comisión están cerca.
Para evitar interrupciones mientras la app está en primer plano, puedes llamar al método suppressHalfSheetNotification() en Mobile SDK para suprimir estas notificaciones. Consulta la documentación de la API para obtener más información.
Si la app está en primer plano durante más de 15 minutos, se agota el tiempo de espera de la supresión habilitada por esta API. 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 notificaciones de media hoja.
Puedes encontrar una implementación de esta API en Google Home Sample App for Matter. Consulta HalfSheetSuppressionObserver.kt para obtener más información.
Cómo indicar la asistencia para la comisión de Matter
Si usas Mobile SDK para realizar la comisión, debes
agregar el nombre del paquete de la app
en Google Home Developer Console, implementar nuestras APIs de Matter
e indicar que tu app admite la asignación de Matter
a través del 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 maneras en las que tu app aparece en el selector de apps durante el proceso de comisión:
- En la pantalla Elige una app
- Si los usuarios seleccionan Elegir otra app, esta aparecerá en la pantalla Otras apps instaladas.
Apps sugeridas
En el selector de apps, se muestran dos apps sugeridas.
- El primero es siempre Google Home app (GHA).
- La segunda es para la app preferida del fabricante del dispositivo, si se define en un proyecto Developer Console asociado con el VID o PID del dispositivo.
Hay dos situaciones en las que las apps aparecen en la pantalla Elige una app.
- Instalada: Play services verifica que la aplicación sea compatible con 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.