El flujo de puesta en servicio de 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 Fast Pair. En esta sección, se aborda la experiencia del usuario (UX) para cada una.
Iniciado por la app
En esta situación, el usuario comienza la puesta en servicio en tu app, por lo general, desde una llamada a la acción (CTA) de "Agregar dispositivo". Te recomendamos que incluyas el botón Agregar dispositivo de la siguiente manera:
- Donde los usuarios ven todos sus dispositivos, como una página de Controles
- Donde los usuarios pueden administrar la casa, como una página de Configuración
- La página principal de tu app
Cuando se complete la puesta en servicio, te recomendamos que dirijas al usuario a la página principal de la app o a la ubicación en la app que le muestre el controlador del dispositivo 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 a la estructura de Google (esto corresponde a "Consentimiento + metadatos" en la Figura 1) y que seleccione la Cuenta de Google que desea usar.
Si el usuario tiene más de una casa, se le solicita que seleccione una. Si no tiene una casa configurada, se crea automáticamente una 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 Matter credenciales, verifica la conectividad de red y, luego, ejecuta el proceso de puesta en servicio, conectando el dispositivo a la estructura elegida.
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 o controlable en la app. Se requiere permiso para acceder al dispositivo y controlarlo en una app.
Iniciado por Fast Pair
La puesta en servicio también se puede iniciar con Fast Pair en Android. Después de escanear el código QR Matterdel dispositivo, se le solicita al usuario que seleccione una app para continuar con el proceso de puesta en servicio. Si seleccionas tu app, se utiliza la API de Commissioning de la app, como se ilustra en la Figura 3.
Si el usuario no tiene instalada la app en su dispositivo móvil, se le solicita que la instale antes de continuar. La UX desde la pantalla de consentimiento en adelante es la misma que en la Figura 2.
Se le solicita al usuario que escanee un código QR.
El usuario escanea el código QR Matter del dispositivo.
Se le solicita al usuario que seleccione una app para continuar con el proceso de puesta en servicio.
Si la app aún no está instalada, se le solicita al usuario que la instale.
La app se descarga de Google Play Store.
Se instala la app.
Una vez que la app se instala correctamente, se le solicita al usuario que continúe.
Se le solicita al usuario que acepte agregar el dispositivo a la estructura de Google (esto corresponde a "Consentimiento + metadatos" en la Figura 1) y que seleccione la Cuenta de Google que desea usar.
Si el usuario tiene más de una casa, se le solicita que seleccione una. Si no tiene una casa configurada, se crea automáticamente una 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 Matter credenciales, verifica la conectividad de red y, luego, ejecuta el proceso de puesta en servicio conectando el dispositivo a la estructura elegida.
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 puesta en servicio:
- En la pantalla Elegir 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.
- La primera siempre es Google Home app (GHA).
- La segunda es para la app preferida del fabricante del dispositivo, si se define en un
Google Home Developer Console proyecto asociado con el VID o el PID del
dispositivo. (Esta opción no se aplica a los desarrolladores de apps que no
compilan Matter dispositivos).
Existen dos situaciones en las que las apps se encuentran en la pantalla Elegir una app.
- Instalada : Google Play services verifican que la aplicación admita
el
ACTION_COMMISSION_DEVICEfiltro de intents. 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.