Fantástico ver como es el código de personalización de la camara 👍
Recursos
Resumen
Construir la capa gráfica de una cámara personalizada en Android requiere una clase base abstracta que coordine el dibujo, el escalamiento y la traslación de un cuadro sobre el rostro. Aquí aprenderás cómo crear esa estructura usando Lens Engine, el primer objeto de machine learning del proyecto, para que el marco solo aparezca cuando la cámara frontal te está mirando.
Esto es clave si desarrollas una selfie cam y quieres que el rostro quede centrado y rodeado por un recuadro dinámico, sin que se dibuje mal cuando cambias a la cámara trasera.
Por qué necesitas una clase base abstracta para el overlay
Todo arranca en el paquete overlay, donde creamos la clase BaseGraphic y la declaramos como abstracta. Esto obliga a que cualquier gráfico que heredes en clases futuras siga el mismo contrato de dibujo.
La clase recibe como parámetro la clase GraphicOverlay que ya existía de la sesión anterior, y define una función abstracta draw que recibe un Canvas de Android [00:34]. Al ser abstracta, cada gráfico hijo está obligado a implementar su propia forma de dibujarse.
¿Qué es una clase abstracta en Android? Es una plantilla que no se instancia directamente y define funciones que las clases hijas deben implementar obligatoriamente. Sirve para forzar una estructura común.
La idea central es tener una base reutilizable: en vez de repetir lógica de escalamiento en cada gráfico, la centralizas una sola vez.
Cómo funciona el escalamiento en x y en y
Antes de dibujar cualquier cosa, necesitas adaptar las coordenadas del rostro al tamaño real de la vista. Para eso creamos dos funciones de escalamiento.
La función escalarEnX recibe un Float y retorna un Float: toma la coordenada x y la multiplica por el factor de escala del overlay según el ancho [01:05]. La función escalarEnY hace lo mismo pero multiplicando por la altura [01:28].
escalarEnX: ajusta la posición horizontal multiplicando por el escalado del ancho.escalarEnY: ajusta la posición vertical multiplicando por el escalado del alto.
Estas dos funciones son la base para que el recuadro coincida con lo que realmente ves en pantalla.
Para qué sirve la traslación con Lens Engine
Aquí viene lo interesante. La traslación es lo que resuelve el problema del efecto espejo en la cámara frontal.
La función translateEnX recibe un Float y evalúa una condición: pregunta si el cameraFacing del GraphicOverlay, a través de Lens Engine, corresponde al lente frontal [01:52]. Lens Engine es el primer objeto de machine learning que usamos y es quien sabe hacia dónde apunta la cámara.
¿Qué hace Lens Engine en este proyecto? Detecta la orientación de la cámara (frontal o trasera) para decidir si el cuadro del rostro debe trasladarse o solo escalarse. Así evitas que el marco quede descuadrado en modo selfie.
Si la cámara es frontal, la coordenada se traslada usando el ancho del overlay y luego se escala en x, de modo que tu rostro quede centrado en el selfie. Si es la cámara trasera, no hay traslación: solo se escala en x [02:30].
La traslación en y es más simple: translateEnY devuelve directamente el escalamiento en y, sin lógica de espejo [03:05].
Cómo gestionar y dibujar los gráficos en GraphicOverlay
Con la base lista, regresamos a GraphicOverlay para manejar la colección de gráficos y pintarlos en pantalla. Primero declaramos una variable graphics de tipo ArrayList<BaseGraphic> inicializada vacía [03:30].
Luego implementamos tres funciones sincronizadas para evitar conflictos de concurrencia mientras la cámara dibuja:
clear: ejecutagraphics.clear()y unpostInvalidate()para que la cámara pueda reutilizarse y volver a pintar [03:50].addGraphic: recibe ungraphicde tipoBaseGraphicy lo agrega a la lista [04:18].draw: sobrescribe el dibujo sobre elCanvasy crea el recuadro que rodea el rostro [04:42].
El bloque synchronized garantiza que agregar, limpiar y dibujar no ocurran al mismo tiempo, lo que previene parpadeos o cuadros mal posicionados.
Qué valida la función draw antes de pintar
La función draw no pinta a ciegas. Verifica que el ancho del preview sea distinto de cero y que el alto también lo sea; eso confirma que la cámara está mostrando algo real [04:55].
Cuando se cumple, calcula dos variables de escala: el scaleValue del ancho dividiendo el ancho toFloat entre el tamaño toFloat, y lo mismo para el alto [05:20]. Después recorre cada gráfico de la lista y lo dibuja sobre el canvas [05:50].
¿Por qué el cuadro solo aparece con la cámara frontal? Porque Lens Engine solo aplica traslación cuando detecta el lente frontal. Con la cámara trasera no se dibuja el recuadro, evitando un marco descolocado.
El resultado es un cuadro que bordea tu rostro únicamente cuando la selfie cam te enfoca de frente, manteniendo todo centrado.
¿Ya tienes claro cómo encajan el escalamiento y la traslación en tu propio overlay? Cuéntame en los comentarios qué parte te costó más implementar.