La API de Commissioning en Android admite la administración múltiple (o multi-admin) 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 Matter:
- En este modo, el entorno de Google se agrega primero con la UX de Google.
- Puedes agregar un comisionado personalizado.
- Se llama a tu comisionado después de que se agrega el entorno de Google al dispositivo, luego se vuelve a abrir la ventana de comisionamiento.Matter
- Si Google no puede completar el comisionamiento a su propio entorno por algún motivo, no se ejecutará tu servicio de comisionamiento personalizado.
Como comisionado secundario de Matter:
- En este modo, puedes implementar tu propia UX de comisionamiento y realizar la incorporación a tu propio entorno (o a otros entornos).
- Se puede llamar a la API de Google Commissioning más adelante con una ventana de comisionamiento abierta para agregar el entorno de Google. En este modo, Google recomienda que, cuando un usuario final te otorgue permiso para usar las APIs de Home, la app les solicite de forma activa que agreguen el entorno de Google (con la API de Commissioning) después de que se complete tu flujo de comisionamiento.
Cómo usar la API de Commissioning como comisionado principal de Matter
En estos pasos, se muestra el flujo de comisionamiento completo y con todas las funciones de Matter que prefiere Google: Matter
El usuario inicia el flujo de comisionamiento en la app. Por ejemplo, el usuario presiona un botón con la etiqueta Agregar dispositivo.
La UX de Google toma el control y muestra la pantalla Matter Código QR, lo que permite al usuario escanear el código QR para comenzar el proceso de configuración.
En la pantalla Conecta este dispositivo a tu Cuenta de Google, el usuario presiona Acepto para agregar un dispositivo al ecosistema de Google. Si el usuario presiona Cancelar en esta pantalla, se detiene de inmediato todo el comisionamiento 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 hubs adecuados en la casa o si el usuario no tiene permisos, finaliza el proceso de comisionamiento.
A continuación, debería aparecer la pantalla Dispositivo conectado y comenzar el Matter proceso de configuración. El usuario puede elegir una sala y un nombre de dispositivo en esta pantalla.
Aparece la pantalla Se está preparando tu dispositivo mientras se incorpora el dispositivo al entorno de Matter Matter.
Tu app reanuda el control y el comisionado personalizado, si está registrado, se ejecuta ahora.
Cómo usar la API de Commissioning como comisionado secundario de Matter
En estos pasos, se muestra el Matter flujo de comisionamiento en el que tu proceso de comisionamiento se produce antes que el proceso de comisionamiento de Google:
El usuario inicia el flujo de comisionamiento en tu app. Por ejemplo, el usuario presiona Agregar dispositivo.
Se ejecuta tu proceso de UX de comisionamiento para agregar un dispositivo a tu entorno.
Una vez completado, puedes dictar el comportamiento posterior en función de tu conocimiento del usuario. Por ejemplo, si el usuario habilitó las APIs de Google Home, lo que probablemente indica que quiere realizar el comisionamiento en Google, puedes activar el proceso de comisionamiento.
Tu proceso llama a la API de Commissioning y proporciona la carga útil, que contiene el código de acceso, el discriminador y otra información disponible.
El proceso de comisionamiento de Google agrega el dispositivo al entorno de Google.