Pular para o conteúdo

Bastidores

Como o AuraDisplay encontra a sua câmera e encaixa o anel ao redor dela

Pela equipe llcloud 5 min de leitura

Resposta rápida

O AuraDisplay pergunta ao Android onde fica o recorte da tela, escolhe o mais próximo do topo como a câmera frontal e desenha o anel ao redor dele. Algumas fabricantes informam uma zona segura alta em vez do círculo da câmera, então o AuraDisplay a remodela num círculo. Se o anel ainda ficar um pouco fora, você o ajusta uma vez e ele lembra. Celulares sem recorte usam o brilho de borda.

A primeira coisa que as pessoas notam no AuraDisplay é o anel ao redor da câmera. Quando ele fica certo, o furinho parece que sempre foi feito pra brilhar. Quando fica alguns pixels fora, você nota toda vez. Por isso boa parte do nosso trabalho gira em torno de uma pergunta: onde exatamente fica a sua câmera? Veja como a respondemos.

Como um app sabe onde fica a câmera?

Ele pergunta ao Android. Desde o Android 9, o sistema consegue descrever cada recorte da tela, a parte do painel ocupada pela câmera ou por sensores, como um retângulo em coordenadas da tela. As fabricantes preenchem esses números pro próprio hardware, e os apps os leem pelas mesmas chamadas do sistema que usam pra manter botões longe do notch.

O AuraDisplay lê o recorte de duas formas. Pergunta direto à tela, o que funciona do Android 10 em diante e dá uma resposta na hora. E também escuta as margens de janela (window insets) que o sistema entrega à sobreposição dele, que é como ele fica sabendo de mudanças. As duas alimentam um único trecho de código, então o anel nunca recebe duas respostas diferentes sobre onde está a câmera.

Alguns celulares informam mais de um recorte. O AuraDisplay escolhe o mais próximo do topo da tela, que é a câmera frontal em todos os celulares que já vimos.

Por que alguns celulares pedem um ajuste?

Porque o retângulo que um celular informa nem sempre é a câmera. O Android só promete um retângulo que cubra o recorte. Algumas fabricantes informam exatamente o círculo da câmera. Outras informam uma área generosa ao redor dela.

O caso mais comum que vemos é uma faixa alta e estreita que começa no topo da tela e termina logo abaixo da câmera, uma zona segura e não a lente em si. Vários modelos Xiaomi fazem isso. Se centralizássemos o anel nessa faixa, ele ficaria flutuando acima da câmera.

Então o AuraDisplay confere o formato. Um retângulo com mais que o dobro de altura que de largura, ou o dobro de largura que de altura, é tratado como zona segura e remodelado num círculo a partir do lado menor. Quando a faixa encosta no topo da tela, a câmera fica na ponta de baixo dela, então o centro é calculado a partir da borda inferior e não do meio.

Escolhemos esse limite com cuidado. Os celulares Pixel informam um retângulo um pouco mais alto que largo, e o centro dele já está certo. Um limite mais baixo teria "consertado" celulares que nunca estiveram quebrados.

Nenhuma regra cobre todos os painéis, e por isso a configuração termina com uma pergunta. Depois que a notificação do autoteste acende o anel, o AuraDisplay pergunta se ele está alinhado com a sua câmera. Se não, você toca em Ajustar e o move com dois controles, até 60dp pro lado e 40dp pra cima ou pra baixo, e muda o tamanho. O ajuste fica salvo e permanece depois de reiniciar.

O que acontece quando você gira o celular?

A rotação é onde um anel que parecia perfeito pode dar errado sem ninguém notar, então a tratamos com cuidado.

O Android informa o recorte no quadro da rotação atual. Vire o celular de lado e os números da câmera vão pra outra borda. Só que a nossa correção pras zonas seguras altas supõe que a câmera está na borda de cima, e o seu ajuste foi feito com o celular em pé. Aplicar qualquer um dos dois a números do celular deitado põe o anel no lugar errado.

Então o AuraDisplay primeiro gira o recorte informado de volta pro quadro em pé. Aplica a correção da zona segura ali e depois gira o resultado pra frente pra combinar com a tela. O seu ajuste salvo gira junto. Segurar o celular em pé pula tudo isso, então o caso do dia a dia segue o caminho mais simples.

Há mais uma armadilha. Quando você vira um celular direto de um lado da paisagem pro outro, o Android não manda aos apps o sinal de "configuração mudou", porque largura e altura são as mesmas antes e depois. Só a própria tela informa a nova rotação. O AuraDisplay escuta a tela justamente por isso, pra o anel não ficar do lado errado.

Por padrão o anel some com o celular deitado, porque em geral é quando você assiste a um vídeo ou joga, e um anel brilhando no meio da imagem distrai. Dá pra ligar pro modo paisagem nas configurações. O brilho de borda acompanha o contorno em qualquer rotação e nunca some.

E se um celular não informa recorte nenhum?

Aí o AuraDisplay não tem o que encontrar. Isso acontece em celulares sem furinho nem notch, e em muitos celulares com Android 8, antes de a API de recorte existir. O AuraDisplay põe o anel no centro do topo da tela como ponto de partida, e você pode movê-lo.

A resposta melhor nesses celulares é o modo Borda. Ele faz um brilho correr pelo contorno da tela e funciona em qualquer celular com Android 8.0 ou mais novo, com recorte ou não. Nosso guia de iluminação de borda em qualquer Android mostra como fica.

O brilho de borda tem o próprio problema de encaixe: os cantos da tela. Um brilho desenhado como retângulo de quinas vivas fica dentro de cantos arredondados e parece errado. Desde o Android 12, o sistema informa aos apps o raio de cada canto, e o AuraDisplay segue essa curva exata, com canto reto onde o celular não informa nada. Nas versões mais antigas não há esse dado, então o AuraDisplay estima. Telas altas ganham um canto suavemente arredondado e telas mais curtas um canto reto.

O que isso significa no Always On Display?

O anel fica no mesmo lugar na tela de bloqueio e no Always On Display, então a câmera que você olha é sempre a que brilha. O que muda no Always On Display é o movimento. O painel é redesenhado cerca de uma vez por segundo nesse modo, então o anel mantém um brilho fixo ali e volta a animar quando você acorda o celular. Nosso guia sobre ver notificações no Always On Display explica esse limite.

Pra onde ir agora?

Se você está configurando o AuraDisplay num celular específico, os guias por marca mostram as configurações embutidas que importam junto com ele: Pixel, Xiaomi, Redmi e POCO, OnePlus e Samsung. Pro quadro geral, comece por como ter uma luz de notificação no Android.

Fontes

Perguntas

Como o AuraDisplay sabe onde fica a minha câmera?

O Android informa aos apps onde fica o recorte da tela. Desde o Android 9, o sistema descreve cada recorte como um retângulo na tela, e as fabricantes preenchem esses números pros próprios painéis. O AuraDisplay os lê, escolhe o recorte mais próximo do topo como a câmera frontal e centraliza o anel nele. Você não precisa dizer nada a ele.

Por que o anel não está centralizado na minha câmera?

Os números vêm da fabricante do celular, e alguns descrevem uma área maior que a própria câmera, como uma zona segura alta a partir do topo da tela. O AuraDisplay corrige sozinho o formato mais comum. Se o seu ainda ficar um pouco fora, a tela de configuração pergunta se o anel está alinhado, e você pode mover e mudar o tamanho. O ajuste fica salvo.

O anel acompanha a câmera quando eu giro o celular?

Acompanha. O AuraDisplay guarda a posição da câmera no quadro do celular em pé e a gira junto com a tela, incluindo o seu ajuste. Por padrão o anel some com o celular deitado, já que em geral é um vídeo ou um jogo. Você pode ligar pro modo paisagem, e o brilho de borda sempre aparece em qualquer rotação.

E se o meu celular não tem furinho?

Use o modo Borda. Ele faz um brilho correr pelo contorno da tela e funciona em qualquer celular com Android 8.0 ou mais novo, com ou sem recorte. No Android 12 e mais novo ele segue a curva exata dos cantos da sua tela, que o sistema informa aos apps. Em versões mais antigas o AuraDisplay estima o formato dos cantos pela proporção da tela.

Continue lendo