Cómo configurar tu app para teléfonos para enviar caras de reloj

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 del teléfono, el flujo posterior para configurarla tiene dos partes:

  1. Instalación: Instala la cara de reloj con el envío de caras de reloj, que se inicia a través de MessageClient. Este paso es sencillo y se realiza con addWatchFace o updateWatchFace, activado con MessageClient desde el teléfono al reloj.
  2. Activación: Establece la cara de reloj instalada como activa. Este paso tiene varias rutas posibles, según el estado del permiso:
    • Es posible que no se requiera ninguna acción. Es posible que el mercado ya tenga 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 para aceptar solicitudes de permisos o para configurar la cara de reloj de forma manual con un gesto de mantener presionado o a través de una app complementaria.

Respuesta de la instalación

Para facilitar la fase de activación, la fase de instalación debe mostrar la siguiente información del reloj al teléfono:

  • El resultado del intento de instalación
  • El resultado de isWatchFaceActive(): Para determinar si la app ya tiene la cara de reloj activa.
  • Si ya se llamó a setWatchFaceAsActive() 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 elegir mostrar un botón para establecer la cara de reloj como activa.

Situación 1: Se agotaron todos los intentos de 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 al usuario a una pantalla educativa en el teléfono, en la que se le muestre cómo mantener presionada la cara de reloj para configurarla manualmente en la 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 lo otorgó, continúa con la llamada a setWatchFaceAsActive().
  • Si el usuario rechazó el permiso anteriormente, el reloj debe informarlo al teléfono, donde se puede mostrar una pantalla educativa que explique la necesidad del permiso y cómo otorgarlo de forma manual.

  • Si no se solicitó el permiso antes, el reloj debe indicarle al teléfono que muestre un momento educativo en el que se le indique al usuario cómo aceptar permisos en el reloj y, luego, debe 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.