Comisión del SDK de Home Mobile

En esta página, se explica el uso de algunas funciones de la API de comisión en Google Home Mobile SDK.

Suprime las notificaciones de descubrimiento comisionadas

Notificación de Halfsheet de Android
Figura 1: Ejemplo de una notificación de media hoja de Android

De forma predeterminada, Google Play services en Android usa notificaciones de "semi hojas" que cubren la mitad inferior de la pantalla de un dispositivo móvil para brindarles a los usuarios una indicación proactiva de que hay cerca los dispositivos Matter que se pueden encargar.

Para evitar interrupciones mientras la app está en primer plano, puedes suprimir estas notificaciones llamando al método suppressHalfSheetNotification() en el Mobile SDK. 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.

Indica la compatibilidad con la comisión de Matter

Si usas Mobile SDK para realizar comisiones, 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 comisión de Matter mediante el manejo 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 la app de ejemplo como referencia.

Selector de apps

Selector de apps

Tu app aparece de dos maneras en el selector de apps durante el proceso de comisión:

  1. En la pantalla Elegir una app
  2. Si los usuarios seleccionan Elegir otra app, esta se mostrará en la pantalla Otras apps instaladas.

Apps sugeridas

El selector de apps muestra dos apps sugeridas.

  • La primera es siempre Google Home app (GHA).
  • La segunda es para la app preferida del fabricante del dispositivo, si está definida en un proyecto Developer Console asociado con el VID o el PID del dispositivo. App de la comisión preferida del fabricante del dispositivo

Hay dos situaciones en las que las apps aparecen en la pantalla Elegir una app.

  1. 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.
  2. No instalada: Se dirige al usuario a Play Store para que instale la app antes de continuar.