Cómo agregar complicaciones a una cara de reloj

Una complicación de una cara de reloj muestra datos de una fuente de datos. Con el Formato de Caras de Relojes, puedes elegir las fuentes de datos para obtener las de datos no estructurados. Esto permite que las caras de reloj muestren información de la hora del día sin la necesidad de usar código para obtener los datos.

Cómo usar el Formato de Caras de Relojes

El elemento Complication te permite definir hasta ocho complicaciones en una sola cara de reloj. El elemento también te permite definir en qué parte de la cara de reloj. aparece cada complicación.

Para obtener más información, consulta el ejemplo de WatchFaceFormat sobre GitHub.

Tipos y campos

En la siguiente tabla, se describen los tipos y los campos de las Objeto ComplicationData. Si una cara de reloj solicita un campo que no es válido para un tipo de complicación, se devuelve un valor predeterminado para el campo. Por ejemplo: Si una cara de reloj intenta acceder a un campo LONG_TEXT en un tipo SHORT_TEXT, el Se muestra el valor predeterminado para el campo LONG_TEXT, nulo. Ten en cuenta los campos opcionales no hay garantía de que se muestren.

Tipo	Campos obligatorios	Campos opcionales	Notas
SHORT_TEXT	Texto corto	Ícono Ícono de protección de pantalla Título corto Descripción del contenido	Muestra solo un ícono o título corto si se proporcionan uno o ambos.
MONOCHROMATIC_IMAGE	Imagen monocromática	Ícono de protección de pantalla Descripción del contenido	Se usa cuando no se necesita texto. Se prevé que el ícono sea de un solo color y el tono puede ajustarse según la cara de reloj.
RANGED_VALUE	Valor Valor mínimo Valor máximo	Imagen monocromática Ícono de protección de pantalla Texto corto Título corto Rampa de colores Valor dinámico Descripción del contenido	Si quieres diseñar tu propia barra de progreso, puedes usar el método isRangedValueProgressHidden() para ocultar la barra de progreso que proporciona la clase ComplicationDrawable.
GOAL_PROGRESS	Valor Valor objetivo	Imagen monocromática Ícono de protección de pantalla Texto corto Título corto Rampa de colores Valor dinámico Descripción del contenido	GOAL_PROGRESS está diseñado para acciones como el recuento de pasos, en el que el valor comienza en cero y puede superar el valor objetivo.
LONG_TEXT	Texto largo	Título largo Imagen monocromática Ícono de protección de pantalla Imagen pequeña Descripción del contenido	Muestra el título largo si está incluido.
SMALL_IMAGE	Imagen pequeña	Descripción del contenido	Una imagen pequeña tiene uno de dos estilos: de foto o de ícono. El estilo de foto implica que se espera que llene el espacio y que se pueda recortar. El estilo de ícono indica que no se puede recortar y que se puede rellenar. La variabilidad de la imagen puede producir una imagen no apta para mostrar en el modo ambiente en dispositivos con protección de pantalla o en modo ambiente con baja velocidad de bits. Cuando están habilitados la protección de pantalla o el modo ambiente con baja velocidad de bits, la cara de reloj puede usar una imagen pequeña de protección de pantalla, ya que es seguro. De lo contrario, debido a que para una cara de reloj es difícil determinar la aptitud, no se muestra la imagen.
LARGE_IMAGE	Imagen grande	Descripción del contenido	Se prevé que esta imagen sea suficientemente grande como para llenar la cara de reloj. La variabilidad de la imagen puede producir una imagen no apta para mostrar en el modo ambiente en dispositivos con protección de pantalla o en modo ambiente con baja velocidad de bits. Debido a que es difícil que una cara de reloj determine si una imagen es apta para mostrar, no mostrará una imagen en modo ambiente si se habilitan la protección de pantalla o el modo ambiente con baja velocidad de bits.
WEIGHTED_ELEMENTS	Lista de elementos	Imagen monocromática Ícono de protección de pantalla Texto corto Título corto Descripción del contenido	Cada elemento consta de un color y un peso (mayor que cero). El tamaño del elemento cuando se renderiza debe ser proporcional a su peso. No es necesario que los pesos sumen un valor particular. Ten en cuenta que las caras de reloj pueden cambiar el color de WEIGHTED_ELEMENTS.

En la siguiente tabla, se describen los tipos de complicaciones para datos vacíos que se pueden enviar a cualquier espacio para complicación. No tienen campos y no es necesario incluirlos en una lista de tipos compatibles. Permiten a las caras de reloj diferenciar entre estos tres casos:

• No se seleccionó ninguna fuente.
• El usuario seleccionó "empty" para un espacio.
• Una fuente no tiene datos para enviar.

Las fuentes no pueden enviar TYPE_EMPTY en respuesta a solicitudes de actualización. Envía TYPE_NO_DATA en su lugar.

Tipo de complicación	Descripción
TYPE_NOT_CONFIGURED	Lo envía el sistema cuando se activa una complicación, pero el usuario no seleccionó una fuente y no se estableció un valor predeterminado. Las fuentes no pueden enviarlo.
TYPE_EMPTY	Lo envía el sistema cuando se activa una complicación y el usuario elige "empty" en lugar de una fuente, o bien cuando la cara de reloj no selecciona una fuente ni este tipo de complicación como valor predeterminado. Las fuentes no pueden enviarlo.
TYPE_NO_DATA	Lo envía el sistema cuando se activa una complicación (que tiene una fuente) para borrarla antes de que la fuente envíe datos reales. Las fuentes pueden enviarlo si no tienen datos reales para enviar.

En algunos dispositivos, las caras de reloj y las complicaciones deben usar el Formato de Caras de Relojes

Si tu cara de reloj existente usa la biblioteca de caras de reloj de Jetpack o Biblioteca de compatibilidad para wearables, los usuarios siguen viendo datos de todas las fuentes de datos en complicaciones de cara de reloj en los siguientes dispositivos:

• Dispositivos que ejecutan Wear OS 4 o versiones anteriores
• Dispositivos que reciben una actualización inalámbrica a Wear OS 5.

Además, si tu cara de reloj existente usa la biblioteca de caras de reloj de Jetpack Wearable Support Library y se instala en uno de estos dispositivos, el cara de reloj puede seguir recibiendo actualizaciones.

Sin embargo, en los relojes nuevos lanzados con Wear OS 5, las caras de reloj deben usar el Formato de Caras de Relojes. Por este motivo, te recomendamos que migres el Formato de Caras de Relojes.