Pular para o conteúdo

Complicações

O que são complicações, como um único design mostra dados de várias fontes de dados e como criar a sua própria complicação, passo a passo.

Em um relógio, uma complicação é tudo o que o mostrador exibe além da hora: a data, o clima, o seu próximo compromisso, o nível da bateria. A palavra vem da relojoaria, em que cada função extra deixava o mecanismo mais complicado.

No Wear OS, as complicações funcionam de um jeito especial, e é isso que as torna poderosas: o mostrador decide a aparência dos dados, e quem usa o relógio decide quais dados aparecem. Os apps do relógio oferecem dados (o app de clima oferece a temperatura, a agenda o seu próximo evento), e quem usa o relógio escolhe um deles para cada complicação, no próprio relógio.

Por isso, uma complicação que você cria no Pujie não é uma “complicação de clima” nem uma “complicação de bateria”. É um design para um tipo de dado: um estilo que diz “aqui vai uma linha curta de texto, com um ícone em cima”. Seja qual for a fonte de dados escolhida, a temperatura, a contagem de passos ou a hora do nascer do sol, o seu design a mostra.

Essa é a ideia para guardar. Parece estranha no começo, mas significa que um único design funciona com todos os apps do relógio, inclusive com apps que ainda nem existem. Aqui, um mesmo design de anel mostra a bateria, a contagem de passos e uma contagem regressiva da agenda, conforme a escolha de quem usa o relógio:

As fontes de dados oferecem os dados em alguns formatos fixos, chamados de tipos. Um contador de passos pode oferecer um número em uma escala (valor em intervalo) e um texto curto; um app de música, uma imagem pequena. A sua complicação diz quais tipos ela consegue mostrar:

TipoO que contémSempreÀs vezes
Texto curtoUma linha curta de texto: passos, uma temperatura, um rótuloTexto curtoÍcone, título curto
Texto longoUma linha mais longa: um evento da agenda, uma descriçãoTexto longoTítulo longo, ícone, imagem pequena
Valor em intervaloUm valor em uma escala, para desenhar como um medidor: bateria, passos rumo a uma metaValor, mínimo, máximoÍcone, texto curto, título curto
ÍconeUm ícone de uma cor só, que você pode colorirÍcone
Imagem pequenaUma imagem pequena: a capa de um álbum, o ícone de um appImagem pequena, como foto ou como ícone
Imagem grandeUma imagem em tamanho cheio, para um fundoImagem grande

Os campos de “às vezes” são o que deixa o design interessante: uma fonte de dados pode enviá-los ou não. Uma fonte de bateria dá um valor e talvez um ícone; outra fonte de valor em intervalo pode acrescentar um texto curto. Um bom design fica bem nos dois casos.

Uma complicação pode ser compatível com vários tipos. Quanto mais tipos, mais fontes de dados ficam disponíveis para a escolha de quem usa o relógio. A ordem importa: quando uma fonte oferece mais de um dos seus tipos, o relógio usa o que está mais acima na sua lista, então coloque primeiro o tipo que você desenhou com mais cuidado, que costuma ser o mais rico.

Algumas complicações da biblioteca e de usuários do Pujie, cada uma mostrando um valor de 65 em 100 com um ícone de bateria. Toque em uma da biblioteca para abri-la lá.

Toque no botão de adicionar acima da lista de elementos, escolha Complicação e depois Novo item. A primeira coisa que aparece é o painel Tipos de dados compatíveis:

O painel Tipos de dados compatíveis, com texto curto e valor em intervalo em Compatíveis e os outros tipos em DisponíveisO painel Tipos de dados compatíveis, com texto curto e valor em intervalo em Compatíveis e os outros tipos em Disponíveis

Arraste os tipos que o seu design vai mostrar de Disponíveis para cima, até Compatíveis, em ordem de prioridade, e toque em Criar. Toque na seta de um cartão para ver quais campos aquele tipo sempre tem e quais ele pode ter; as estrelas indicam o quanto um tipo consegue mostrar, de uma para um ícone a cinco para um valor em intervalo. Na dúvida? Comece só com Texto curto: é o tipo que a maioria das fontes de dados oferece. Veja Tipos de dados compatíveis.

Você também pode começar por uma complicação que outra pessoa criou: escolha Da biblioteca de mostradores em vez de Novo item.

A nova complicação abre no editor de elementos, já com camadas iniciais no lugar: uma para cada campo dos tipos que você escolheu, como o texto, o título ou o ícone. Essas camadas estão vinculadas ao campo delas: no relógio, mostram os dados da fonte de dados. Elas aparecem marcadas como Bloqueada na lista de camadas, para que um deslize não as remova sem querer.

Agora dê a elas o estilo que você quiser: fontes, cores, tamanhos, posições e tudo o que você quiser em volta, como um anel, um fundo ou a agulha de um medidor. Tudo o que dá para fazer no editor de elementos funciona aqui.

  • Campos de texto são tags em uma camada de texto: [cstext] é o texto curto, [cstitle] o título curto, [cltext] e [cltitle] os longos. Você pode colocá-las em qualquer camada de texto, com outro texto em volta.
  • Imagens e ícones são camadas de imagem vinculadas a um campo. Para vincular uma, escolha o campo como a imagem da camada em Origem da imagem.
  • Valores comandam a automação: [cvalue], [cmin] e [cmax], e [cnormval], o valor como uma fração de 0 a 1, que é o mais fácil de usar. Gire uma agulha com ele, ou faça um arco crescer com ele.
  • Campos opcionais podem vir vazios. Uma camada inicial de um campo opcional diz isso no nome. Se o seu design não precisar de uma delas, oculte a camada em vez de excluí-la.

Na complicação Value, a rotação da agulha e o ângulo do arco acompanham o valor: a agulha gira ([cvalue]-[cmin])/([cmax]-[cmin])*245 graus, a parte do intervalo vezes os 245 graus da escala, e a abertura do arco usa a mesma fórmula. Bars mostra cada barra só acima da parte dela, com a visibilidade [cnormval]>(2/6) para a terceira. Este é o Value de 0 a 100:

No topo do editor de elementos, Dados da complicação abre Escolha os dados da complicação: as fontes de dados com que você pode ver a prévia do seu design.

O painel Escolha os dados da complicação para a complicação Value: as fontes de Dados de teste, cada uma mostrada no medidor, como valor com texto e valor com ícone e textoO painel Escolha os dados da complicação para a complicação Value: as fontes de Dados de teste, cada uma mostrada no medidor, como valor com texto e valor com ícone e texto

As primeiras fontes são Dados de teste: valores inventados que mostram cada combinação de campos, como só texto, texto com ícone ou texto com título. Passe por todas elas: o seu design deve ficar bem com cada uma. Abaixo delas ficam as fontes reais, como a data, a bateria, a frequência cardíaca ou a contagem de passos.

Quando algo só deve aparecer com certos dados, use a automação para ocultá-lo. Cada tipo tem um marcador que é true quando aquele tipo está sendo mostrado, como [cisshorttext] ou [cisrangedvalue], e cada campo tem um que é true quando a fonte o enviou, como [chicon] para o ícone. Quando a complicação é compatível com vários tipos, as camadas iniciais que pertencem a só um deles já se ocultam assim.

Uma complicação pode ser tocada no relógio. Por padrão, a área de toque é uma caixa arredondada do tamanho da complicação. Para dar a ela a forma do seu design, escolha Definir como silhueta no menu de uma camada de forma ou de arco: uma elipse dá uma área de toque redonda, um arco uma área em forma de arco.

De volta ao editor de mostradores, posicione a complicação com a posição e o tamanho dela. Na linha dela, o botão de dados da complicação escolhe a fonte de dados com que ela começa: os dados que o relógio mostra até que quem usa o relógio escolha outra coisa. Escolha aqui uma fonte real, não uma de teste.

Quem usa o relógio escolhe os dados nele: toque e segure o mostrador, toque no botão de personalizar ou de editar abaixo dele e toque na complicação. O relógio lista todas as fontes de dados que oferecem um dos seus tipos. Cada complicação leva o nome do elemento dela, então dê nomes claros às suas complicações, como “Superior esquerda” ou “Medidor pequeno”.

O que acontece ao tocar em uma complicação no relógio depende da fonte de dados; em geral, abre o app de onde os dados vêm.

  • No máximo 8 complicações em um mostrador, somando a visualização interativa e a ambiente.
  • Curto ou longo? A maioria das fontes de dados oferece texto curto. Escolha texto longo só quando o seu design tiver espaço para uma frase.
  • As complicações também aparecem na visualização ambiente. Para isso, adicione uma aos elementos da guia Ambiente e mantenha-a discreta: nada de fundos claros.
  • Dados rápidos, sem escolha: quando os dados devem ser sempre os mesmos (sempre a bateria, por exemplo), um elemento dinâmico é mais simples: você mesmo coloca os dados, e quem usa o relógio não precisa escolher nada.