En el mercado canónico, la app para teléfonos es la forma predominante en la que el usuario interactúa con la app.
Cómo establecer una cara de reloj
Cuando el usuario selecciona una cara de reloj en la app para teléfonos, el flujo posterior para establecer la cara de reloj tiene dos partes:
- Instalación: Instala la cara de reloj con Watch Face Push, que se inicia a través de
MessageClient
. Este paso es sencillo y usaaddWatchFace
oupdateWatchFace
, que se activan conMessageClient
desde el teléfono hacia el reloj. - Activación: Establece la cara de reloj instalada como activa. Este paso tiene varios caminos posibles, según el estado del permiso:
- Es posible que no sea necesario realizar ninguna acción. Es posible que el mercado ya tenga el control de la cara de reloj activa.
- Es posible que no se requiera la intervención del usuario. La app tiene los permisos necesarios para establecer la cara de reloj activa y puede hacerlo directamente con
setWatchFaceAsActive()
. - Es posible que se necesite orientación, ya sea sobre cómo aceptar solicitudes de permisos o cómo configurar manualmente la cara del reloj con un gesto de presión prolongada o a través de una app complementaria.
Respuesta de instalación
Para facilitar la fase de activación, la fase de instalación debe devolver la siguiente información del reloj al teléfono:
- Resultado del intento de instalación
- El resultado de
isWatchFaceActive()
para determinar si la app ya tiene la cara de reloj activa. - Indica si
setWatchFaceAsActive()
ya se llamó en el pasado. La app para Wear OS debe hacer un seguimiento de esta información y conservarla de forma local. Esta llamada a la API solo se puede usar una vez.
Activación
Después de la instalación, la respuesta puede indicar que la app ya tiene la cara de reloj activa. Sin embargo, si no lo hace, la app puede optar por mostrar un botón para establecer la cara de reloj como activa.
Situación 1: Se agotaron todos los intentos para establecer la cara de reloj activa
Si la respuesta de la instalación indicó que ya se había llamado a setWatchFaceAsActive()
en el pasado, el botón debería dirigir a una pantalla de aprendizaje en el teléfono, en la que se le muestre al usuario cómo mantener presionado el dial del reloj para configurarlo manualmente en el que desee.
Situación 2: Intenta establecer la cara de reloj activa
El teléfono debe indicarle al reloj que verifique el permiso SET_PUSHED_WATCH_FACE_AS_ACTIVE
necesario:
- Si el usuario ya otorgó el permiso, continúa con la llamada a setWatchFaceAsActive().
- Si el usuario rechazó el permiso anteriormente, el reloj debe comunicar esto al teléfono, donde se puede mostrar una pantalla educativa que explique la necesidad del permiso y cómo otorgarlo manualmente.
Si no se solicitó el permiso antes, el reloj debe indicarle al teléfono que muestre un momento educativo que guíe al usuario sobre cómo aceptar permisos en el reloj, y el reloj debe proceder a solicitar el permiso.
- Si el usuario otorga el permiso, el reloj debe llamar a
setWatchFaceAsActive()
. - De lo contrario, el reloj debe indicarle al teléfono que muestre una pantalla educativa en la que se explique la necesidad del permiso y cómo otorgarlo de forma manual.
- Si el usuario otorga el permiso, el reloj debe llamar a