Sobre as complicações

Um complemento (link em inglês) é qualquer recurso que aparece no mostrador do relógio, além do horário. Por exemplo, o indicador de bateria é um complemento. 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 complemento.

Fonte de dados de complementos

Apps que fornecem dados, como nível de bateria, clima ou dados de contagem de passos, a mostradores de relógio para complementos são conhecidos como fontes de dados de complemento. 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. The flow of complication data.

Complicações em mostradores de relógio

Os mostradores de relógios recebem informações de fontes de dados de complemento, o que permite que eles incluam complementos 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 complemento

Os tipos de complemento definem quais dados podem ser mostrados em um complemento 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 complemento 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 complemento diferentes dos mostradores do relógio:

• Uma fonte de dados escolhe os tipos de dados de complemento 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 complementos vão ser incluídas no mostrador do relógio e os tipos de complemento com suporte. Por exemplo, um complemento em um mostrador do relógio pode oferecer suporte aos tipos SHORT_TEXT, SMALL_IMAGE 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 complemento e os campos com suporte de cada tipo, consulte Tipos de complemento.