Sobre as complicações

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
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.

Observação:nas próximas versões do Wear OS, os mostradores do relógio vão precisar usar o Formato do mostrador do relógio para oferecer suporte a complicações que contenham dados do usuário. É recomendável atualizar o mostrador do relógio para usar o Formato do mostrador. Saiba mais sobre essas mudanças nas 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 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.