Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Uma
complicação (link em inglês)
é qualquer recurso que aparece no mostrador do relógio, além do horário.
Por exemplo, o indicador
de bateria é uma complicação. A
API Complications
é destinada a mostradores de relógio e apps de fontes de dados.
Este documento descreve fontes de dados, mostradores de relógio e
tipos de complicação.
Fonte de dados de complicações
Apps que fornecem dados, como
nível de bateria, clima ou dados de contagem de passos, a mostradores de relógio para
complicações são conhecidos como fontes de dados de complicação. Essas fontes
disponibilizam dados brutos
e não são responsáveis por controlar o modo como as próprias informações são renderizadas em um
mostrador do relógio.
Para saber mais sobre como criar apps que forneçam dados para mostradores de relógio, consulte
Expor dados a
complicações.
O diagrama abaixo mostra como o Wear OS by Google media o fluxo de dados
das fontes até os mostradores do relógio.
Figura 1. O fluxo de dados de complicação.
Complicações em mostradores de relógio
Os mostradores de relógios recebem informações de fontes de dados de complicação, o que permite que eles
incluam
complicações sem precisar de código para coletar os dados. Os mostradores
de relógio mantêm
o controle sobre como os dados são renderizados, para que possam integrar os dados
naturalmente com o
design. Para mais informações, consulte o guia de design de
complicações.
Os tipos de complicação definem quais dados podem ser mostrados em uma
complicação ou disponibilizados por
uma fonte de dados. Por exemplo, use o tipo SHORT_TEXT quando os
dados consistem
principalmente em uma string curta. Um objeto
ComplicationData sempre tem um único tipo de
complicação que define campos obrigatórios e opcionais. Um campo
obrigatório
representa os dados principais. A maioria dos tipos adota o nome do
campo obrigatório.
As fontes de dados usam tipos de complicação diferentes dos mostradores do relógio:
Uma fonte de dados escolhe os tipos de dados de complicação a disponibilizar,
inclusive quais campos opcionais desses tipos vão ser disponibilizados, e
quantos tipos diferentes podem ser aceitos. Por exemplo, uma fonte de
contagem de passos pode oferecer suporte aos tipos RANGED_VALUE e
SHORT_TEXT,
e uma fonte de dados de "próxima reunião" pode oferecer suporte aos tipos SHORT_TEXT
e LONG_TEXT.
Você pode escolher quantas complicações vão ser incluídas no mostrador do relógio
e os tipos de
complicação com suporte. Por exemplo, uma complicação em um mostrador do relógio
pode oferecer suporte
aos tipos SHORT_TEXT, ICON e
RANGED_VALUE.
Um medidor no mostrador do relógio pode oferecer suporte apenas para o
tipo RANGED_VALUE.
Para saber mais sobre os diferentes tipos de complicação e os campos com suporte de
cada tipo, consulte
Tipos de complicação.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]
