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 Flujo de datos de complicaciones](https://developer.android.google.cn/static/wear/images/complications-data-flow.png?authuser=9&hl=es)
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.
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
ySHORT_TEXT
, mientras que una fuente de próxima reunión podría admitir los tiposSHORT_TEXT
yLONG_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
yRANGED_VALUE
. Un medidor en la cara de reloj puede admitir solo el tipoRANGED_VALUE
.
Para obtener más información sobre los diferentes tipos de complicaciones y los campos admitidos por cada tipo, consulta Tipos de complicaciones.