Entre bastidores
Cómo AuraDisplay encuentra tu cámara y ajusta el anillo a su alrededor
Por el equipo de llcloud 5 min de lectura
Respuesta rápida
AuraDisplay le pregunta a Android dónde está el recorte de pantalla, elige el más cercano a la parte superior como cámara frontal y dibuja su anillo a su alrededor. Algunos fabricantes informan de una zona segura alta en lugar del círculo de la cámara, así que AuraDisplay la convierte en un círculo. Si el anillo sigue algo desplazado, lo ajustas una vez y se acuerda. Los móviles sin recorte usan el resplandor de borde.
Lo primero que la gente nota de AuraDisplay es el anillo alrededor de la cámara. Cuando está bien colocado, parece que el agujero de la cámara siempre estuvo pensado para brillar. Cuando está unos píxeles desplazado, lo notas cada vez. Por eso una buena parte de nuestro trabajo va a una pregunta: ¿dónde está exactamente tu cámara? Así la respondemos.
¿Cómo sabe una app dónde está la cámara?
Se lo pregunta a Android. Desde Android 9, el sistema puede describir cada recorte de pantalla, la parte del panel que ocupan la cámara o los sensores, como un rectángulo en coordenadas de pantalla. Los fabricantes rellenan esos números para su propio hardware, y las apps los leen con las mismas llamadas del sistema que usan para mantener los botones fuera del notch.
AuraDisplay lee el recorte de dos maneras. Se lo pregunta directamente a la pantalla, algo que funciona desde Android 10 y da una respuesta al instante. También escucha los márgenes de ventana que el sistema da a su capa, que es como se entera de los cambios. Ambas alimentan un único fragmento de código, así que el anillo nunca recibe dos respuestas distintas sobre dónde está la cámara.
Algunos móviles informan de más de un recorte. AuraDisplay elige el más cercano a la parte superior de la pantalla, que es la cámara frontal en todos los móviles que hemos visto.
¿Por qué algunos móviles necesitan un ajuste?
Porque el rectángulo que informa un móvil no siempre es la cámara. Android solo promete un rectángulo que cubra el recorte. Algunos fabricantes informan exactamente del círculo de la cámara. Otros informan de una zona generosa a su alrededor.
El caso más común que vemos es una franja alta y estrecha que empieza en lo más alto de la pantalla y termina justo debajo de la cámara, una zona segura y no el objetivo en sí. Varios modelos de Xiaomi lo hacen. Si centráramos el anillo en esa franja, flotaría por encima de la cámara.
Así que AuraDisplay comprueba la forma. Un rectángulo más de dos veces más alto que ancho, o dos veces más ancho que alto, se trata como una zona segura y se convierte en un círculo según su lado más corto. Cuando la franja toca la parte superior de la pantalla, la cámara está en su extremo inferior, así que el centro se calcula desde el borde inferior en lugar del medio.
Elegimos ese umbral con cuidado. Los móviles Pixel informan de un rectángulo algo más alto que ancho, y su centro ya es correcto. Un umbral más bajo habría "arreglado" móviles que nunca estuvieron rotos.
Ninguna regla cubre todos los paneles, y por eso la configuración termina con una pregunta. Después de que la notificación de prueba encienda el anillo, AuraDisplay pregunta si encaja con tu cámara. Si no, tocas Ajustar y lo mueves con dos controles, hasta 60 dp hacia los lados y 40 dp hacia arriba o abajo, y cambias su tamaño. El ajuste se guarda y se mantiene tras reiniciar.
¿Qué pasa cuando giras el móvil?
La rotación es donde un anillo que se veía perfecto puede fallar en silencio, así que la tratamos con cuidado.
Android informa del recorte en el marco de la rotación actual. Gira el móvil de lado y los números de la cámara pasan a otro borde. Pero nuestra corrección para zonas seguras altas supone que la cámara está en el borde superior, y tu propio ajuste se hizo con el móvil en vertical. Aplicar cualquiera de las dos a los números de un móvil girado coloca el anillo en el sitio equivocado.
Por eso AuraDisplay primero devuelve el recorte informado al marco vertical. Allí aplica la corrección de la zona segura y luego gira el resultado para que coincida con la pantalla. Tu ajuste guardado gira con él. Con el móvil en vertical se salta todo esto, así que el caso del día a día sigue el camino más simple.
Hay una trampa más. Cuando giras un móvil directamente de un lado horizontal al otro, Android no envía a las apps la señal habitual de "configuración cambiada", porque el ancho y el alto son los mismos antes y después. Solo la propia pantalla informa de la nueva rotación. AuraDisplay escucha a la pantalla precisamente por eso, para que el anillo no se quede en el lado equivocado.
Por defecto el anillo se oculta con el móvil en horizontal, porque normalmente es cuando ves un vídeo o juegas, y un anillo brillando en medio de la imagen distrae. Puedes activarlo para el modo horizontal en los ajustes. El resplandor de borde sigue el contorno en cualquier rotación y nunca se oculta.
¿Y si un móvil no informa de ningún recorte?
Entonces AuraDisplay no tiene nada que encontrar. Pasa en móviles sin cámara perforada ni notch, y en muchos móviles con Android 8, antes de que existiera la API de recortes. AuraDisplay coloca el anillo en la parte superior central de la pantalla como punto de partida, que puedes mover.
La mejor respuesta en esos móviles es el modo Borde. Pasa un resplandor por el contorno de la pantalla y funciona en cualquier móvil con Android 8.0 o posterior, con recorte o sin él. Nuestra guía sobre la iluminación de bordes en cualquier móvil Android muestra cómo se ve.
El resplandor de borde tiene su propio problema de ajuste: las esquinas de tu pantalla. Un resplandor dibujado como un rectángulo afilado queda dentro de esquinas redondeadas y se ve mal. Desde Android 12, el sistema informa a las apps del radio de cada esquina, y AuraDisplay sigue esa curva exacta, con una esquina cuadrada donde el móvil no informa de ninguna. En versiones anteriores no hay tal informe, así que AuraDisplay estima. Las pantallas altas reciben una esquina suavemente redondeada y las más cortas una cuadrada.
¿Qué significa esto en la pantalla siempre encendida?
El anillo está en el mismo sitio en la pantalla de bloqueo y en la pantalla siempre encendida, así que la cámara a la que miras es siempre la que brilla. Lo que cambia en la pantalla siempre encendida es el movimiento. El panel se redibuja más o menos una vez por segundo en ese modo, así que el anillo mantiene un resplandor fijo y vuelve a animarse cuando despiertas el móvil. Nuestra guía para ver notificaciones en la pantalla siempre encendida explica ese límite.
¿Adónde ir ahora?
Si estás configurando AuraDisplay en un móvil concreto, las guías por marca recorren los ajustes integrados que importan junto a ella: Pixel, Xiaomi, Redmi y POCO, OnePlus y Samsung. Para el panorama general, empieza por cómo tener una luz de notificación en Android.
Fuentes
Preguntas
¿Cómo sabe AuraDisplay dónde está mi cámara?
Android les dice a las apps dónde está el recorte de pantalla. Desde Android 9, el sistema describe cada recorte como un rectángulo en la pantalla, y los fabricantes rellenan esos números para sus propios paneles. AuraDisplay los lee, elige el recorte más cercano a la parte superior como cámara frontal y centra el anillo en él. No tienes que decirle nada.
¿Por qué el anillo no está centrado en mi cámara?
Los números vienen de tu fabricante, y algunos describen un área más ancha que la propia cámara, como una zona segura alta desde la parte superior de la pantalla. AuraDisplay corrige por su cuenta la forma más común. Si la tuya sigue algo desplazada, la pantalla de configuración pregunta si el anillo encaja y puedes moverlo y cambiar su tamaño. El ajuste se guarda.
¿Sigue el anillo a la cámara cuando giro el móvil?
Sí. AuraDisplay guarda la posición de la cámara en el marco vertical del móvil y la gira con la pantalla, incluido tu propio ajuste. Por defecto el anillo se oculta con el móvil en horizontal, porque suele ser un vídeo o un juego. Puedes activarlo para el modo horizontal, y el resplandor de borde se ve siempre en cualquier rotación.
¿Y si mi móvil no tiene cámara perforada?
Usa el modo Borde. Pasa un resplandor por el contorno de la pantalla y funciona en cualquier móvil con Android 8.0 o posterior, con o sin recorte. En Android 12 y posteriores sigue la curva exacta de las esquinas de tu pantalla, que el sistema informa a las apps. En versiones anteriores AuraDisplay estima la forma de la esquina a partir de las proporciones de la pantalla.