Complicaciones
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Una complicación es un elemento de la IU en una cara de reloj que contiene información útil que los usuarios desean ver con frecuencia a lo largo del día. Por ejemplo, puedes crear una complicación del clima actual o una complicación de frecuencia cardíaca.
Principios de UX
En las siguientes secciones, se describen los principios que debes tener en cuenta cuando creas complicaciones.
Facilidad para ver |
Priorización del contenido |
Priorización de la privacidad |
| Las complicaciones son componentes pequeños diseñados para ayudar a los usuarios a completar tareas frecuentes con rapidez. Haz que el contenido sea simple y legible. |
Las complicaciones son más valiosas cuando el contenido que el usuario necesita se muestra con solo levantar la muñeca, sin necesidad de interacción adicional. |
El reloj viaja con el usuario a todas partes. Ten en cuenta que el contenido de las complicaciones es relevante para el contexto del usuario. |
Casos de uso
Cuando se presionan, las complicaciones pueden ayudar a los usuarios a acceder a una parte específica de una app. También pueden realizar una acción independiente. Por ejemplo, si presionas la complicación Recuento de agua, cambia el recuento de vasos.
WearOS incluye automáticamente una complicación de acceso directo a aplicaciones, por lo que no necesitas crear la tuya. En cambio, concéntrate en crear complicaciones que puedan ayudar a los usuarios a completar tareas enfocadas.
Tipos
Los tipos de complicaciones se refieren a los tipos de datos que se muestran en la complicación o que proporciona una fuente de datos. Una complicación siempre tiene un solo tipo que incluye campos opcionales y obligatorios. Un campo obligatorio contiene los datos principales. La mayoría de los tipos de complicaciones adquieren el nombre de su campo obligatorio. Puedes seleccionar la cantidad de complicaciones que incluirás en tu cara de reloj y los tipos de complicaciones que admitirás. Existen cinco tipos de complicaciones.
| Tipo |
Campos obligatorios |
Campos opcionales |
Nombre de clase |
Ejemplo |
| SHORT_TEXT |
Texto corto |
Ícono,
Ícono de protección de pantalla,
Título corto |
ShortTextComplicationData |
 |
| ÍCONO |
Ícono |
Ícono de protección de pantalla |
MonochromaticImageComplicationData |
 |
| RANGED_VALUE |
Valor
Valor mínimo
Valor máximo |
Ícono
,Ícono de protección de pantalla,
Texto corto,
Título corto |
RangedValueComplicationData |
 |
| LONG_TEXT |
Texto largo |
Título largo,
Ícono,
Ícono de protección de pantalla,
Imagen pequeña |
LongTextComplicationData |
 |
| SMALL_IMAGE |
Imagen pequeña |
|
SmallImageComplicationData |
 |
| LARGE_IMAGE |
Imagen grande |
|
PhotoImageComplicationData |
 |
Para obtener más información sobre las fuentes de datos de complicación, 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,["# Complications\n\nA complication is a UI element on a watch face that contains highly-glanceable\ninformation that users want to see often throughout the day. For example, you\ncould create a current weather complication, or a heart rate complication.\n\nUX Principles\n-------------\n\nThe following sections describe principles to keep in mind when creating\ncomplications.\n\n|------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| Glanceable ---------- | Content forward --------------- | Privacy first ------------- |\n| Complications are small components designed to help users complete frequent tasks quickly. Make content simple and readable. | Complications are most valuable when the content that the user needs is made visible by simply raising their wrist, without needing further interaction. | The watch travels with the user everywhere they go. Consider how the content in the complications is relevant to the user's context. |\n\nUse cases\n---------\n\nWhen tapped, complications can help users access a specific part of an app.\nThey can also perform a self-contained action. For example, tapping a\nWater Count complication changes the glass count.\n\nWearOS automatically includes an app shortcut complication, so you don't need to\ncreate your own. Instead focus on creating complications that can help users\ncomplete focused tasks.\n\nTypes\n-----\n\nComplication types refer to the kinds of data shown on the complication or\nsupplied by a data source. A complication always has a single type that includes\nrequired and optional fields. A required field contains the primary data. Most\ncomplication types take their name from their required field. You can choose how\nmany complications to include in your watch face and the complication types to\nsupport. There are five complication types.\n\n| Type | Required fields | Optional fields | Class name | Example |\n|--------------|---------------------------|--------------------------------------------------------|--------------------------------------|---------|\n| SHORT_TEXT | Short text | Icon, Burn in protection icon, Short title | `ShortTextComplicationData` | |\n| ICON | Icon | Burn in protection icon | `MonochromaticImageComplicationData` | |\n| RANGED_VALUE | Value Min value Max value | Icon, Burn in protection icon, Short text, Short title | `RangedValueComplicationData` | |\n| LONG_TEXT | Long text | Long title, Icon, Burn in protection icon, Small image | `LongTextComplicationData` | |\n| SMALL_IMAGE | Small image | | `SmallImageComplicationData` | |\n| LARGE_IMAGE | Large image | | `PhotoImageComplicationData` | |\n\nFor more information about complication data sources, see\n[Complication types](/training/wearables/watch-faces/complications#types)."]]
