Información acerca de las complicaciones

Una complicación es cualquier función que se muestre en una cara de reloj, además del tiempo. Por ejemplo, un indicador de carga de batería es una complicación. La API de Complications está diseñada para caras de reloj y apps de fuente de datos.

En el resto de este documento, se describen fuentes de datos, caras de reloj y tipos de complicaciones.

Fuente de datos de complicación

Las apps que proporcionan datos (como el nivel de batería, el estado del clima o el recuento de pasos) a las caras de reloj para las complicaciones se denominan fuentes de datos de complicaciones. Esas fuentes brindan datos sin procesar y no se encargan de controlar la forma en que se representan sus datos en una cara de reloj. Para obtener más información sobre cómo escribir apps que proporcionen datos a caras de reloj, consulta Cómo exponer datos a complicaciones.

En el siguiente diagrama, se muestra cómo Wear OS by Google actúa como intermediario en el flujo de datos de las fuentes a las caras de reloj.

Flujo de datos de complicaciones
Figura 1: Flujo de datos de complicaciones

Complicaciones en caras de reloj

Las caras de reloj reciben datos de fuentes de datos de complicaciones, lo que les permite incluir complicaciones sin la necesidad de usar código para obtener los datos subyacentes. Las caras de reloj controlan la forma en que se representan los datos, por lo que pueden integrar datos naturalmente con su diseño. Para obtener más información, consulta la guía de diseño sobre complicaciones.

Nota: En las próximas versiones de Wear OS, las caras de reloj deberán usar el Formato de Caras de Relojes para admitir complicaciones que contengan datos del usuario. Te recomendamos que actualices la cara de reloj para usar el Formato de Caras de Relojes. Obtén más información sobre estos cambios en las complicaciones.

Para obtener más información para agregar complicaciones a una cara de reloj, consulta Cómo agregar complicaciones a una cara de reloj.

Tipos de complicaciones

Los tipos de complicaciones definen la clase de datos que puede mostrar una complicación o que puede proporcionar una fuente de datos. Por ejemplo, usa el tipo SHORT_TEXT cuando los datos consistan principalmente en una cadena corta. Un objeto ComplicationData siempre tiene un solo tipo de complicación que define los campos obligatorios y opcionales. Un campo obligatorio representa los datos más importantes; la mayoría de los tipos toman su nombre del campo obligatorio.

Las fuentes de datos utilizan los tipos de complicaciones de forma diferente a las caras de reloj:

  • Una fuente de datos selecciona los tipos de datos de complicaciones que proporcionará (incluidos los campos opcionales de dichos tipos de datos) y la cantidad de tipos diferentes que se pueden admitir. Por ejemplo, una fuente de recuento de pasos podría admitir los tipos RANGED_VALUE y SHORT_TEXT, mientras que una fuente de próxima reunión podría admitir los tipos SHORT_TEXT y LONG_TEXT.
  • Puedes seleccionar la cantidad de complicaciones que incluirás en tu cara de reloj y los tipos de complicaciones que admitirás. Por ejemplo, una complicación de dial en una cara de reloj podría admitir los tipos SHORT_TEXT, ICON y RANGED_VALUE. Un medidor en la cara de reloj puede admitir solo el tipo RANGED_VALUE.

Para obtener más información sobre los diferentes tipos de complicaciones y los campos admitidos por cada tipo, consulta Tipos de complicaciones.