La API de puesta en marcha en Android admite la multiadministración (o multi-admin) para Matter, lo que significa que la API de puesta en marcha puede servir como comisionado Matter primario o secundario y que puede agregar su propio comisionado:
Como comisionado principal Matter:
- En este modo, primero se agrega la estructura de Google, utilizando la interfaz de usuario de Google.
- Puedes añadir un comisionado personalizado.
- Se llama a su comisionado después de que se agrega la estructura de Google al dispositivo, 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 Matter:
- En este modo, puede implementar su propia experiencia de usuario de puesta en marcha e incorporarla a su propia plataforma (o a otras plataformas).
- Se puede llamar a la API de Google Commissioning más adelante con una ventana de puesta en servicio 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 utilizar la API de puesta en marcha como comisionado principal de asuntos.
Estos pasos muestran las preferencias de GoogleMatter Flujo de puesta en marcha completo:
El usuario inicia el flujo de configuración en la aplicación. Por ejemplo, el usuario toca un botón etiquetado como Agregar dispositivo.
La interfaz de usuario de Google toma el control y muestra la pantalla Escanear 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, en cambio, toca Cancelar en esta pantalla, la puesta en marcha del dispositivo finaliza inmediatamente.
En la pantalla Elegir una casa, el usuario selecciona la casa desde la cual 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 servicio.
A continuación debería aparecer la pantalla Dispositivo conectado y comenzar el proceso de configuración Matter. En esta pantalla, el usuario puede elegir un nombre de habitación y de 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 utilizar la API de puesta en marcha como comisionado secundario de asuntos.
En estos pasos, se muestra el flujo de activación de Matter, en el que tu proceso de activación ocurre antes del proceso de activación de Google:
El usuario inicia el flujo de configuración en tu aplicación. Por ejemplo, el usuario toca 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 encargarle la tarea a Google, puedes activar el proceso de encargo.
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 a la estructura de Google.