La API de Commissioning en Android admite la administración múltiple (o multiadministrador) para Matter, lo que significa que la API de Commissioning puede actuar 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 comisionado personalizado.
- Se llama a tu comisionado después de que se agrega la estructura de Google al dispositivo y, luego, se vuelve a abrir la ventana de comisionamiento Matter.
- Si Google no puede completar la puesta en marcha en su propia estructura primero por algún motivo, tu servicio de puesta en marcha personalizado no se ejecutará.
Como comisionado secundario de Matter, haz lo siguiente:
- En este modo, puedes implementar tu propia UX de puesta en marcha y realizar la integración a tu propia estructura (o a otras estructuras).
- Se puede llamar a la API de Google Commissioning más adelante con una ventana de aprovisionamiento abierta para agregar la estructura de Google. En este modo, Google recomienda que, cuando un usuario final te haya otorgado permiso para usar las APIs de Home, la app les solicite activamente a los usuarios que agreguen la estructura de Google (con la API de Commissioning) después de que se complete tu flujo de puesta en servicio.
Cómo usar la API de Commissioning como el comisionado principal de Matter
En estos pasos, se muestra el flujo de puesta en marcha completo y con todas las funciones que prefiere Google:Matter
El usuario inicia el flujo de puesta en servicio en la app. Por ejemplo, el usuario presiona un botón etiquetado como Agregar dispositivo.
La UX de Google toma el control y muestra la pantalla Escanear código QRMatter, 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 detendrá de inmediato toda la puesta en servicio del dispositivo.
En la pantalla Elige una casa, el usuario selecciona la casa desde la que puede controlar el dispositivo. Si no hay una casa disponible, se crea una nueva. Si no se encuentran centros adecuados en la casa o si el usuario no tiene permisos, finaliza el proceso de puesta en marcha.
A continuación, debería aparecer la pantalla Dispositivo conectado y comenzar el proceso de configuración de Matter. En esta pantalla, el usuario puede elegir el nombre de la habitación y del dispositivo.
Aparece la pantalla Se está preparando tu dispositivo mientras se incorpora el dispositivo a la estructura de 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 flujo de la puesta en servicio de Matter, en el que tu proceso de puesta en servicio se realiza antes del proceso de puesta en servicio de Google:
El usuario inicia el flujo de puesta en marcha en tu app. Por ejemplo, el usuario presiona Agregar dispositivo.
Se ejecuta tu proceso de UX de puesta en marcha para agregar un dispositivo a tu estructura.
Una vez que lo completes, podrás dictar el comportamiento subsiguiente basándote en tu conocimiento del usuario. Por ejemplo, si el usuario habilitó las APIs de Google Home, lo que probablemente indica que desea realizar la puesta en marcha en Google, puedes activar el proceso de puesta en marcha.
Tu proceso llama a la API de Commissioning y proporciona la carga útil, que contiene el código, el discriminador y otra información disponible.
El proceso de comisión de Google agrega el dispositivo al entorno de Google.