La API de Commissioning en Android admite la administración múltiple (o administración múltiple) para Matter, lo que significa que la API de Commissioning puede funcionar como comisionado principal o secundario de Matter y que puedes agregar tu propio comisionado:
Como comisionado principal de Matter, haz lo siguiente:
- En este modo, primero se agrega la estructura de Google con la UX de Google.
- Puedes agregar un comisionador personalizado.
- Se llama a tu comisionador después de que se agrega el tejido de Google al dispositivo y, luego, se vuelve a abrir la ventana de comisión de Matter.
- Si, por algún motivo, Google no puede completar primero la asignación a su propio tejido, no se ejecutará tu servicio de asignación personalizado.
Como comisionado secundario de Matter, haz lo siguiente:
- En este modo, puedes implementar tu propia UX de comisión y realizar la incorporación a tu propio tejido (o a otros tejidos).
- Se puede llamar a la API de Google Commissioning más adelante con una ventana de comisión abierta para agregar el tejido de Google. En este modo, Google recomienda que, cuando un usuario final te otorgue permiso para usar las APIs de Home, la app solicite activamente a los usuarios que agreguen el tejido de Google (con la API de Commissioning) después de que se complete el flujo de comisión.
Cómo usar la API de Commissioning como el comisionador principal de Matter
En estos pasos, se muestra el flujo de puesta en marcha con todas las funciones de Matter preferido por Google:
El usuario inicia el flujo de comisión en la app. Por ejemplo, presiona un botón etiquetado como Agregar dispositivo.
La UX de Google toma el control y muestra la pantalla Escanea el código QR de Matter, lo que permite que el usuario escanee el código QR para comenzar el proceso de configuración.
En la pantalla Conecta este dispositivo con tu Cuenta de Google, el usuario presiona Acepto para agregar un dispositivo al ecosistema de Google. Si, en cambio, el usuario presiona Cancelar en esta pantalla, se detendrá de inmediato toda la puesta en marcha del dispositivo.
En la pantalla Elige una casa, el usuario selecciona la casa desde la que puede controlar el dispositivo. Si no hay ninguna casa disponible, se crea una nueva. Si no se encuentran concentradores adecuados en la casa o si el usuario no tiene permisos, el proceso de comisión finaliza.
A continuación, debería aparecer la pantalla Dispositivo conectado y comenzar el proceso de configuración de Matter. El usuario puede elegir una sala y un nombre de dispositivo en esta pantalla.
Aparecerá la pantalla Se está preparando tu dispositivo a medida que se incorpore el dispositivo al tejido de Matter.
Tu app reanuda el control y, si se registró, se ejecuta el comisionador personalizado.
Cómo usar la API de Commissioning como comisionador secundario de Matter
En estos pasos, se muestra el flujo de comisión de Matter en el que el proceso de comisión se produce antes del proceso de comisión de Google:
El usuario inicia el flujo de comisión en tu app. Por ejemplo, presiona Agregar dispositivo.
Se ejecuta el proceso de UX de comisión para agregar un dispositivo a tu fabric.
Una vez que se complete, puedes dictar el comportamiento posterior según lo que sepas del usuario. Por ejemplo, si el usuario habilitó las APIs de Google Home, lo que probablemente indica que quiere realizar la comisión en Google, podrías activar el proceso de comisión.
Tu proceso llama a la API de Commissioning y proporciona la carga útil, que contiene la contraseña, el discriminador y otra información disponible.
El proceso de comisión de Google agrega el dispositivo al entorno de Google.