El flujo de comisión en tu app con la API de Commissioning se puede iniciar de dos maneras: directamente en tu app o a través de un selector de apps en el proceso de vinculación rápida. En esta sección, se aborda la experiencia del usuario (UX) de cada uno.
Iniciado por la app
En esta situación, el usuario inicia la comisión en tu app, por lo general, desde un llamado a la acción (CTA) de "Agregar dispositivo". Te recomendamos que destaques el botón Agregar dispositivo de la siguiente manera:
- Donde los usuarios ven todos sus dispositivos, como una página Controles
- Donde los usuarios pueden administrar la página principal, como una página de Configuración
- La página Principal de tu app
Cuando se complete la comisión, te recomendamos que dirijas al usuario a la página principal de la app o a una ubicación de la app que le muestre el controlador de dispositivos que acaba de configurar o una lista completa de todos los dispositivos, incluido el que acaba de configurar.
La UX se ilustra en la Figura 2:
El usuario de la app hace clic en Agregar dispositivo.
El usuario escanea el código QR o ingresa el código de vinculación.
Se le solicita al usuario que acepte agregar el dispositivo al tejido de Google (esto corresponde a "Consentimiento y metadatos" en la Figura 1) y que seleccione la Cuenta de Google que usará.
Si el usuario tiene más de una casa, se le solicita que seleccione una. Si no tiene una casa configurada, se creará automáticamente una casa llamada "Casa".
La API de Commissioning se conecta al dispositivo.
Se le solicita al usuario que seleccione la habitación en la que se encuentra el dispositivo.
Se le solicita al usuario que cambie el nombre del dispositivo.
La API de Commissioning genera credenciales de Matter, verifica la conectividad de red y, luego, ejecuta el proceso de comisión, conectando el dispositivo al tejido elegido.
Si ya se otorgó permiso a la estructura y los dispositivos del usuario, el dispositivo debería aparecer en la casa junto con otros dispositivos de esa casa y se puede controlar con la app.
Si aún no se otorgó permiso a la estructura y los dispositivos del usuario, el dispositivo no debería ser visible ni controlable en la app. Se requiere permiso para acceder al dispositivo y controlarlo en una app.
Iniciado por Vinculación rápida
La comisión también se puede iniciar con Fast Pair en Android. Después de escanear el código QR de Matter del dispositivo, se le solicita al usuario que seleccione una app para continuar con el proceso de comisión. Si seleccionas tu app, se usa la API de Commissioning desde la app, como se ilustra en la Figura 3.
Si el usuario no tiene la app instalada en su dispositivo móvil, se le solicita que la instale antes de continuar. La UX a partir de la pantalla de consentimiento es la misma que la de la Figura 2.
Se le solicita al usuario que escanee un código QR.
El usuario escanea el código QR de Matter del dispositivo.
Se le solicita al usuario que seleccione una app para continuar con el proceso de comisión.
Si la app aún no está instalada, se le solicita al usuario que la instale.
La app se descarga desde Google Play Store.
La app está instalada.
Una vez que la app se instale correctamente, se le solicitará al usuario que continúe.
Se le solicita al usuario que acepte agregar el dispositivo al tejido de Google (esto corresponde a "Consentimiento y metadatos" en la Figura 1) y que seleccione la Cuenta de Google que usará.
Si el usuario tiene más de una casa, se le solicita que seleccione una. Si no tiene una casa configurada, se creará automáticamente una casa llamada "Casa".
La API de Commissioning se conecta al dispositivo.
Se le solicita al usuario que seleccione la habitación en la que se encuentra el dispositivo.
Se le solicita al usuario que cambie el nombre del dispositivo.
La API de Commissioning genera credenciales de Matter, verifica la conectividad de red y, luego, ejecuta el proceso de comisión y conecta el dispositivo al tejido elegido.
Si ya se otorgó permiso a la estructura y los dispositivos del usuario, el dispositivo debería aparecer en la casa junto con otros dispositivos de esa casa y se puede controlar con la app.
Si aún no se otorgó permiso a la estructura y los dispositivos del usuario, el dispositivo aún no debería ser visible ni controlable en la app. Se requiere permiso para acceder al dispositivo y controlarlo en una app.
Selector de apps
Existen dos formas en que tu app aparece en el selector de apps durante el proceso de comisión:
- En la pantalla Elige una app.
- Si los usuarios seleccionan Elegir otra app, se mostrará en la pantalla Otras apps instaladas.
Apps sugeridas
El selector de apps muestra dos apps sugeridas.
- El primero siempre es Google Home app (GHA).
- El segundo es para la app preferida del fabricante del dispositivo, si se define en un proyecto Google Home Developer Console asociado con el VID o el PID del dispositivo. (Esta opción no se aplica a los desarrolladores de apps que no compilan dispositivos Matter).
Hay dos situaciones en las que las apps se encuentran en la pantalla Elegir una app.
- Instalada: Google Play services verifica que la aplicación admita el filtro de intents
ACTION_COMMISSION_DEVICE. Si falta el filtro de intents, se dirige al usuario a Play Store para que actualice la app. - No instalada: Se dirige al usuario a Play Store para que instale la app antes de continuar.