En esta guía, se proporciona orientación sobre la UX para diseñar permisos de dispositivos y uso compartido de APIs de Google Home sin problemas para la experiencia de integración en tu aplicación.
Los temas principales que se describen aquí son los siguientes:
- ¿Por qué compartir dispositivos con Google Home?
- Fases clave del flujo de uso compartido
- Implementación técnica
- Prácticas recomendadas de UX
¿Por qué compartir dispositivos con Google Home?
Para disfrutar de las funciones que ofrecen las APIs de Home, los usuarios deben compartir sus dispositivos con Google Home por los siguientes motivos:
- Es un requisito técnico para que Google use estos dispositivos en las automatizaciones.
- Ayuda a mantener una experiencia de Google Home coherente y flexible.
- Es fundamental asegurarse de que los dispositivos se presenten de manera coherente en las apps compatibles con la API de Home para evitar crear una experiencia del usuario fragmentada y confusa en la que los usuarios deban cambiar de app para realizar tareas básicas.
Componentes clave del flujo de uso compartido
| Componente | Programa | Descripción |
|---|---|---|
| API de Permissions | APIs de Home para permisos | Les solicita a los usuarios que otorguen permisos a tu app. Antes de usar cualquiera de las APIs de Home, tu app debe tener permiso para acceder a los dispositivos de la casa del usuario (denominado en la API como estructura). Sin embargo, el orden en el que se realiza este paso depende de la situación del desarrollador y se incluye en la implementación técnica. |
| Vinculación de nube a nube | De nube a nube para la vinculación de cuentas | Te permite iniciar el proceso de vinculación de cuentas para compartir dispositivos conectados a la nube con Google Home desde tu app. Para reducir los inconvenientes de los usuarios, te recomendamos que uses la función de vínculo directo (disponible en Android y iOS) que lleva a los usuarios directamente a tu página de vinculación de cuentas específica en GHA. |
| API de Commissioning | Comisión de Matter | Si bien, por lo general, se considera una API para encargar nuevos dispositivos Matter, también puedes usarla para agregar el tejido de Google a dispositivos Matter que ya se encargaron a otro tejido. Por lo tanto, esta es una herramienta útil para el proceso de integración. |
Implementación técnica
La forma en que crees los flujos de uso compartido depende de los dispositivos que planeas compartir con Google.
En las siguientes situaciones, te recomendamos que sigas los pasos en el orden indicado. Esto ayuda a brindar a los usuarios una mejor experiencia general.
Solo produces dispositivos Matter
Produces dispositivos compatibles con Matter que quieres encargar a Google Home.
Llama a la API de Permissions.
Llama a la API de Google Commissioning en cada dispositivo Matter que se haya encargado previamente a otro entorno.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren entradas del usuario, te recomendamos que guíes al usuario a través de este proceso de la siguiente manera:
- Proporcionar a los usuarios una lista de dispositivos Matter que no se comparten con Google
- Permite que los usuarios inicien el proceso de uso compartido de dispositivos (con la API de Commissioning) haciendo clic en los dispositivos de esa lista.
- Regresa a la lista de dispositivos Matter, donde se muestra el progreso de la tarea y el estado de uso compartido al usuario.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren entradas del usuario, te recomendamos que guíes al usuario a través de este proceso de la siguiente manera:
Solo produces dispositivos compartidos con Google mediante APIs de nube a nube
Realiza la vinculación directa de Cloud-to-cloud. De esta forma, se agregan los dispositivos al grafo de Google Home.
- Te recomendamos que primero realices la vinculación de Cloud-to-cloud para evitar situaciones potencialmente confusas, como que se le presente al usuario una lista que contenga dispositivos que se comparten con Google y dispositivos que no se comparten con Google.
Llama a la API de Permissions.
Produces dispositivos de nube a nube y Matter
Realiza la vinculación directa de Cloud-to-cloud.
- Te recomendamos que primero realices la vinculación de Cloud-to-cloud para evitar situaciones potencialmente confusas, como que se le presente al usuario una lista que contenga dispositivos que se comparten con Google y dispositivos que no se comparten con Google.
Llama a la API de Permissions.
Llama a la API de Google Commissioning en cada dispositivo Matter que se haya encargado previamente a otro entorno.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren entradas del usuario, te recomendamos que guíes al usuario a través de este proceso de la siguiente manera:
- Proporcionar a los usuarios una lista de dispositivos Matter que no se comparten con Google
- Permite que los usuarios inicien el proceso de uso compartido de dispositivos (con la API de Commissioning) haciendo clic en los dispositivos de esa lista.
- Regresa a la lista de dispositivos Matter, muestra el progreso de la tarea y comparte el estado con el usuario.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren entradas del usuario, te recomendamos que guíes al usuario a través de este proceso de la siguiente manera:
No tienes dispositivos para compartir con Google
Llama a la API de Permissions.
Prácticas recomendadas de UX
Esta sección contiene algunos recorridos del usuario fundamentales que debes tener en cuenta cuando desarrolles una app que aproveche las APIs de Home.
Dónde presentar el uso compartido de dispositivos en la app
Esta no es una lista exhaustiva, y es posible que encuentres otras oportunidades para proporcionar una presentación oportuna de Google Home y compartir la experiencia con tus usuarios.
Tampoco son mutuamente excluyentes y hay varios puntos de entrada:
Desde un menú de configuración
Dado que es probable que los usuarios estén acostumbrados a configurar conexiones con sus ecosistemas de Google Home a través de un menú de configuración, este método les permite continuar con este paradigma.
Te recomendamos que separes el uso compartido de dispositivos (vinculación de Cloud-to-cloud y la API de Matter Commissioning) de los permisos de apps (la API de Permissions). Esto les permite a los usuarios controlar los pasos que completan y te brinda la oportunidad de mostrarles el estado de la conexión.
Cuando se usan dispositivos en automatizaciones que ejecuta Google
En la pestaña Automatizaciones, los usuarios podían presionar un punto de entrada al flujo de uso compartido, leer una pantalla de propuesta de valor que explica claramente los beneficios de continuar y, luego, avanzar rápidamente por el flujo de permisos.
Solo desde la comisión
Esta situación se aplicaría principalmente a los socios que solo producen dispositivos Matter (sin dispositivos Cloud-to-cloud) y no tienen su propia plataforma Matter. El punto de entrada del usuario puede aparecer justo después de una pantalla del tipo listo para usar en la que el uso compartido de dispositivos Matter (a través de la API de Commissioning) y los permisos de la app (a través de la API de Permissions) forman parte del mismo flujo de experiencia del usuario.
Lógica de uso compartido
Estas son algunas sugerencias sobre las instrucciones para el usuario:
Por lo general, debes pedirles a los usuarios que solo completen los pasos faltantes necesarios para integrar la plataforma. Por ejemplo, es posible que los clientes antiguos ya compartan los dispositivos de un OEM con Google. En ese caso, solo deben realizar el proceso de otorgamiento de permisos de las APIs de Home para permitir que la app acceda a su Google Home.
Es posible que varios administradores de Google Home compartan una estructura de Google Home y, en algunos casos, solo se use una cuenta para compartir dispositivos con Google. Como resultado, completar la vinculación de Cloud-to-cloud no debería ser un requisito previo para solicitar permisos de las APIs de Home.
Sugerencias de diseño visual
Un beneficio claro de la integración a Google Home (por ejemplo, "Crea automatizaciones avanzadas con Google Home" o "Controla dispositivos con las apps que elijas").
Un llamado a la acción (por ejemplo, “Comenzar”) y una forma de cancelar si el usuario no quiere continuar
Si el espacio lo permite, una explicación de lo que sucederá a medida que el usuario avanza por las pantallas
En el caso de Matter, específicamente, cuando el usuario te otorgó acceso a su casa a través de las APIs de Home, puedes permitir que comparta los dispositivos de su casa con Google Home cuando comisione dispositivos nuevos. Por ejemplo, puedes agregar un dispositivo Matter a tu fabric y, luego, solicitarle al usuario que lo agregue al fabric de Google.
Sugerencias de contenido
Es más fácil para los usuarios confiar en algo que entienden y que agrega valor. Otorga poder a los usuarios proporcionándoles información para tomar decisiones fundamentadas, incluidas las compensaciones.
El tono crítico
Los usuarios no seguirán el camino de compartir dispositivos si no hay una propuesta de valor sólida para hacerlo.
- Presta especial atención a cómo posicionas la oferta.
- Haz que sea atractivo, pero no prometas demasiado.
- Si el usuario necesita un dispositivo que se menciona en tu presentación, asegúrate de que se indique de forma clara para que no se enfrente a un obstáculo inesperado.
- Es posible que solo tengas una oportunidad para captar a estos usuarios, así que aprovechala.
Prácticas recomendadas
- Comienza con el punto de vista del usuario: el enfoque de "¿qué me aporta?".
- No escribas más de cuatro líneas de contenido en un bloque de sección. Si hay más palabras, es posible que se pierda la atención del usuario. Sin embargo, la claridad y la comprensión pueden ser más importantes que la concisión.
- Las automatizaciones son divertidas. Si el espacio lo permite, elige un ejemplo emocionante pero útil.
- Si se alinea con tu estrategia general, intenta usar una voz y un tono juguetones.
- Usa frases prácticas, como "Comenzar".