La API de Commissioning admite la administración múltiple (o multiadministrador) para Matter, lo que significa que la API de Commissioning puede funcionar como el 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 el material de Google con la UX de Google.
- Puedes agregar un comisionado personalizado.
- Se llama a tu comisionado después de que se agrega Google Fabric al dispositivo y, luego, se vuelve a abrir la ventana de comisión de Matter.
- Si Google no puede completar la comisión en su propia infraestructura por algún motivo, no se ejecutará tu servicio de comisión personalizado.
Como comisionado secundario de Matter, haz lo siguiente:
- En este modo, puedes implementar tu propia UX de comisión y realizar la integración en su propio fabric (o en otros).
- Se puede llamar a la API de Google Commissioning más adelante con una ventana de comisión abierta para agregar Google Fabric. En este modo, Google recomienda que, cuando un usuario final te otorgue permiso para usar las APIs de Home, la app les solicite a los usuarios que agreguen el fabric 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 comisionado principal de Matter
En estos pasos, se muestra el flujo de comisión con todas las funciones de Matter que prefiere Google:
El usuario inicia el flujo de comisión en la app. Por ejemplo, presiona un botón etiquetado como Add Device.
La UX de Google toma el control y muestra la pantalla Scan Matter QR Code, lo que le 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, en su lugar, presiona Cancel en esta pantalla, toda la comisión del dispositivo finalizará de inmediato.
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, finaliza el proceso de comisión.
A continuación, debería aparecer la pantalla Device connected y comenzará el proceso de configuración de Matter. El usuario puede elegir un nombre de sala y dispositivo en esta pantalla.
La pantalla Se está preparando tu dispositivo aparece cuando el dispositivo se integra a la plataforma Matter.
Tu app reanuda el control, y el comisionado personalizado, si está registrado, se ejecuta ahora.
Cómo usar la API de Commissioning como el comisionado secundario de Matter
En estos pasos, se muestra el flujo de comisión de Matter, en el que tu proceso de comisión ocurre antes del proceso de comisión de Google:
El usuario inicia el flujo de comisión en tu app. Por ejemplo, el usuario presiona Agregar dispositivo.
Se ejecuta el proceso de UX de la comisión para agregar un dispositivo a tu fabric.
Una vez que se complete, puedes dictar el comportamiento que se producirá en función de lo que sepas del usuario. Por ejemplo, si el usuario aceptó las APIs de Google Home, lo que probablemente sea una indicación de que quiere realizar una comisión a Google, puedes 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 a Google Fabric.