En esta guía, se proporcionan lineamientos de UX para diseñar permisos y uso compartido de dispositivos de las APIs de Google Home sin problemas para la experiencia de incorporació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.
- Asegurarse de que los dispositivos se presenten de manera coherente en las apps habilitadas para la API de Home es fundamental para evitar crear una experiencia del usuario fragmentada y confusa en la que los usuarios deban alternar entre apps para realizar tareas básicas.
Componentes clave del flujo de uso compartido
| Componente | Programa | Descripción |
|---|---|---|
| API de Permissions en Android | APIs de Home para permisos en Android | 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 (que en la API se denomina 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 | Cloud-to-cloud 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 la fricción 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 específica de vinculación de cuentas en GHA. |
| API de Commissioning en Android | Puesta en marcha de Matter | Si bien, por lo general, se considera una API para poner en servicio dispositivos Matter nuevos, también puedes usarla para agregar el tejido de Google a dispositivos Matter que ya se pusieron en servicio en otro tejido. Por lo tanto, esta es una herramienta útil para el proceso de incorporación. |
Implementación técnica
La forma en que crees los flujos de uso compartido dependerá de los dispositivos que planees compartir con Google.
Para las siguientes situaciones, te recomendamos que sigas los pasos en el orden indicado. Esto ayuda a brindarles una mejor experiencia general.
Solo produces dispositivos Matter
Produces dispositivos compatibles con Matter que quieres comisionar a Google Home.
Llama a la API de Permissions en Android.
Llama a la API de Commissioning en Android en cada dispositivo Matter que se haya comisionado previamente en otra estructura.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada del usuario, te recomendamos que lo guíes 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
- Permitir que los usuarios inicien el proceso de uso compartido de dispositivos (con la API de Commissioning) haciendo clic en los dispositivos de esa lista
- Regresar a la lista de dispositivos Matter, mostrar 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 la entrada del usuario, te recomendamos que lo guíes a través de este proceso de la siguiente manera:
Solo produces dispositivos compartidos con Google a través de las APIs de Cloud-to-cloud
Realiza la vinculación directa de Cloud-to-cloud. Esto agrega los dispositivos a Google Home Graph.
- 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 en Android.
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 en Android.
Llama a la API de Commissioning para Android en cada dispositivo Matter que se haya comisionado previamente en otro tejido.
- Debido a que el uso compartido de Matter se debe realizar para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada del usuario, te recomendamos que lo guíes 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
- Permitir que los usuarios inicien el proceso de uso compartido de dispositivos (con la API de Commissioning) haciendo clic en los dispositivos de esa lista
- Regresar a la lista de dispositivos Matter, mostrar 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 la entrada del usuario, te recomendamos que lo guíes 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
En esta sección, se incluyen algunos recorridos críticos del usuario que se deben tener en cuenta cuando se desarrolla una app que aprovecha 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 una experiencia de uso compartido para tus usuarios.
Tampoco son mutuamente excluyentes y hay varios puntos de entrada:
Desde un menú de configuración
Como 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.
Es posible que quieras separar el uso compartido de dispositivos (vinculación de Cloud-to-cloud y la API de Commissioning de Matter) de los permisos de la app (la API de Permissions). Esto les permite a los usuarios controlar qué pasos 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 pueden 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 puesta en marcha
Este caso sería principalmente para socios que solo producen dispositivos Matter (no dispositivos Cloud-to-cloud) y no tienen su propio tejido de Matter. El punto de entrada para el usuario puede aparecer justo después de una pantalla de 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 de los usuarios:
Por lo general, debes solicitar a los usuarios que solo completen los pasos faltantes necesarios para incorporarse a la plataforma. Por ejemplo, es posible que los clientes de larga data ya compartan los dispositivos de un OEM con Google, en cuyo caso solo deben seguir el proceso de otorgamiento de permisos de las APIs de Home para darle acceso a la app a su Google Home.
Es posible que varios administradores de Google Home compartan una estructura de casa de Google Home y, en algunos casos, que solo se use una cuenta para compartir dispositivos con Google. Por lo tanto, 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 incorporación a Google Home (por ejemplo, "Crea automatizaciones avanzadas con la tecnología de 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 avance por las pantallas
En el caso de Matter, cuando el usuario ya 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 se pongan en marcha nuevos dispositivos. Por ejemplo, puedes agregar un dispositivo Matter a tu tejido y, luego, pedirle al usuario que lo agregue al tejido de Google.
Sugerencias de contenido
Es más fácil para los usuarios confiar en algo que entienden y que agrega valor. Empoderar a los usuarios proporcionándoles información para que tomen decisiones fundamentadas, incluidas las compensaciones
La presentación crítica
Los usuarios no seguirán compartiendo 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 claramente para que no se encuentre con un obstáculo inesperado.
- Es posible que solo tengas una oportunidad para captar a estos usuarios, así que aprovéchala.
Prácticas recomendadas
- Comienza con el punto de vista del usuario, es decir, el enfoque de "¿qué gano yo con esto?".
- No escribas más de cuatro líneas de contenido en un bloque de sección. Si usas más palabras, es posible que pierdas 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 interesante, pero útil.
- Intenta usar un tono y una voz lúdicos si se alinean con tu estrategia general.
- Usa frases que inviten a la acción, como "Comenzar".