Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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.
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.
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.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# About complications\n\nA\n[complication](https://en.wikipedia.org/wiki/Complication_(horology))\nis any feature that is displayed on a watch face in addition to the time.\nFor example, a battery\nindicator is a complication. The\n[Complications API](/reference/kotlin/androidx/wear/watchface/complications/package-summary)\nis for both watch faces and data source apps.\n\n\nThe rest of this document describes data sources, watch faces, and\ncomplication types.\n\nComplication data source\n------------------------\n\nApps that provide data such as\nbattery level, weather, or step counts to watch faces for\ncomplications are called *complication data sources* . These data\nsources supply raw data\nand are not responsible for controlling how their data is rendered on a\nwatch face.\nTo learn about writing apps that provide data to watch faces, see\n[Expose data to\ncomplications](/training/wearables/exposing-data-complications).\n\nThe following diagram shows how Wear OS by Google mediates the flow of data\nfrom sources to watch faces.\n**Figure 1.** The flow of complication data.\n\nComplications on watch faces\n----------------------------\n\nWatch faces receive data from complication data sources, which lets them\ninclude\ncomplications without needing code for getting the underlying data. Watch\nfaces retain\ncontrol over how the data is rendered, so they can integrate data\nnaturally with their\ndesign. For more information, see the design guide about\n[Complications](/training/wearables/design/complications).\n\nTo learn how to add complications to a watch face, see\n[Add complications to a watch face](/training/wearables/watch-faces/adding-complications).\n\nComplication types\n------------------\n\nComplication types define what kinds of data can be shown in a\ncomplication or supplied by\na data source. For example, use the `SHORT_TEXT` type when the\ndata consists\nprimarily of a short string. A\n[`ComplicationData`](/reference/androidx/wear/watchface/complications/data/ComplicationData) object always has a single\ncomplication type that defines required and optional fields. A required\nfield\nrepresents the primary piece of data; most types take their name from\nthe required field.\n\nData sources use complication types differently from watch faces:\n\n- A data source chooses the types of complication data to supply, including which optional fields of those types to supply, and how many different types can be supported. For example, a step-count source might support the `RANGED_VALUE` and `SHORT_TEXT` types, and a next-meeting source might support the `SHORT_TEXT` and `LONG_TEXT` types.\n- You can choose how many complications to include in your watch face and the complication types to support. For example, a dial complication on a watch face might support the `SHORT_TEXT`, `ICON`, and `RANGED_VALUE` types. A gauge on the watch face might support only the `RANGED_VALUE` type.\n\nTo learn more about different complication types and fields supported by\neach type, see\n[Complication types](/training/wearables/watch-faces/adding-complications#types-fields)."]]
