En esta guía, se proporcionan instrucciones sobre la UX para diseñar permisos y uso compartido de dispositivos de las 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 capacidades 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.
- Garantizar que los dispositivos se presenten de manera coherente en todas las apps compatibles con la API de Home es fundamental 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 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 (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 | De nube a nube para la vinculación de cuentas | Te permite iniciar el proceso de vinculación de la cuenta para compartir dispositivos conectados a la nube con Google Home desde tu app. Para reducir la fricción del usuario, te recomendamos que uses la capacidad de vínculos directos (disponible en Android y iOS) que lleva a los usuarios directamente a tu página específica de vinculación de la cuenta en la GHA. |
| API de Commissioning en Android | Puesta en marcha de Matter | Si bien, por lo general, se considera una API para poner en funcionamiento dispositivos Matter nuevos, también puedes usarla para agregar la estructura de Google a dispositivos Matter que ya se hayan puesto en funcionamiento con otra estructura. Por lo tanto, 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.
En los siguientes casos, 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
Producir dispositivos compatibles con Matter que quieras poner en funcionamiento con 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 anteriormente en otra estructura.
- Dado que el uso compartido de Matter debe realizarse para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada 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 los dispositivos Matter que no se comparten con Google
- Permitir que los usuarios inicien el proceso de uso compartido del dispositivo (con la API de Commissioning) haciendo clic en los dispositivos de esa lista
- Regresa a la lista de dispositivos Matter y muestra el progreso de la tarea y el estado de uso compartido al usuario.
- Dado que el uso compartido de Matter debe realizarse para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada del usuario, te recomendamos que guíes al usuario a través de este proceso de la siguiente manera:
Solo produces dispositivos que se comparten con Google a través de las APIs de Cloud a Cloud.
Realiza la Cloud-to-cloud vinculación directa. Esto agrega los dispositivos al Gráfico de Google Home.
- Te recomendamos que primero realices la vinculación de Cloud-to-cloud para evitar situaciones potencialmente confusas, como que se le muestre 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.
Producir dispositivos tanto de Cloud-to-cloud como de Matter
Realiza la Cloud-to-cloud vinculación directa.
- Te recomendamos que primero realices la vinculación de Cloud-to-cloud para evitar situaciones potencialmente confusas, como que se le muestre 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 anteriormente en otra estructura.
- Dado que el uso compartido de Matter debe realizarse para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada 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 los dispositivos Matter que no se comparten con Google
- Permitir que los usuarios inicien el proceso de uso compartido del dispositivo (con la API de Commissioning) haciendo clic en los dispositivos de esa lista
- Regresa a la lista de dispositivos Matter y muestra el progreso de la tarea y el estado de uso compartido al usuario.
- Dado que el uso compartido de Matter debe realizarse para cada dispositivo de forma individual y hay muchas pantallas que requieren la entrada 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
En esta sección, se incluyen algunos recorridos críticos del usuario que debes tener en cuenta cuando desarrolles una app que aproveche las APIs de Home.
Dónde introducir el uso compartido de dispositivos en la app
Esta no es una lista exhaustiva, y es posible que encuentres otras oportunidades para ofrecer una experiencia de uso y de intercambio oportuna de Google Home a tus usuarios.
Estos tampoco son mutuamente excluyentes y hay varios puntos de entrada:
Desde un menú de configuración
Dado que los usuarios probablemente 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 desees separar el uso compartido de dispositivos (vinculación de Cloud-to-cloud y la API de Matter Commissioning) del permiso 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 de comisiones
Este caso de uso es principalmente para los socios que producen solo dispositivos Matter (no dispositivos Cloud-to-cloud) y no tienen su propia fábrica de Matter. El punto de entrada para el usuario puede aparecer justo después de una pantalla de tipo lista en la que el uso compartido de dispositivos Matter (a través de la API de Commissioning) y la concesión de 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 del usuario:
Por lo general, debes solicitar a los usuarios que solo completen los pasos faltantes necesarios para incorporarse a la plataforma. Por ejemplo, los clientes antiguos ya pueden compartir los dispositivos de un OEM con Google, en cuyo caso solo deben completar el proceso de otorgamiento de permisos de las APIs de Home para que la app acceda a su casa de 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. 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 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 específicamente, cuando el usuario te haya otorgado 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 ponga en funcionamiento dispositivos nuevos. Por ejemplo, puedes agregar un dispositivo Matter a tu estructura y, luego, solicitarle al usuario que agregue este dispositivo a la estructura de Google.
Sugerencias de contenido
Es más fácil para los usuarios confiar en algo que entienden y que agrega valor. Proporcionar información a los usuarios 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 atractiva, pero no prometas demasiado.
- Si el usuario necesita un dispositivo que se menciona en tu sugerencia, 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: el enfoque de "¿qué beneficios obtengo?".
- No escribas más de cuatro líneas de contenido en un bloque de sección. Si usas más palabras, es posible que el usuario pierda la atención. Sin embargo, la claridad y la comprensión pueden ser más importantes que la concisión.
- ¡Las automatizaciones son divertidas! Si hay espacio, elige un ejemplo interesante y útil.
- Intenta usar un tono y una voz lúdicos si se alinean con tu estrategia general.
- Usa frases prácticas, como "Comenzar".