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.
![Fluxo de dados de complicação Fluxo de dados de complicação](https://developer.android.google.cn/static/wear/images/complications-data-flow.png?authuser=9&hl=pt)
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.
Para aprender a adicionar complicações a um mostrador do relógio, consulte Adicionar complicações a um mostrador de relógio.
Tipos de complicação
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
eSHORT_TEXT
, e uma fonte de dados de "próxima reunião" pode oferecer suporte aos tiposSHORT_TEXT
eLONG_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
eRANGED_VALUE
. Um medidor no mostrador do relógio pode oferecer suporte apenas para o tipoRANGED_VALUE
.
Para saber mais sobre os diferentes tipos de complicação e os campos com suporte de cada tipo, consulte Tipos de complicação.