Crear el motor del lente es el paso que le da vida a la cámara de selfies en tu app Android con Machine Learning de Huawei. Aquí aprenderás a construir la clase LensEnginePreview, inicializar la superficie de la cámara y controlar cuándo arranca o se detiene. Es ideal si ya tienes tu proyecto base y quieres conectar la vista con el procesamiento de imagen.
Qué es el LensEngine y por qué lo necesitas
El lens engine es el componente que activa y procesa la cámara dentro de tu aplicación. Sin él, tu SurfaceView muestra una superficie vacía sin captura real.
¿Qué es el LensEngine en Huawei ML Kit? Es la clase que gestiona el ciclo de vida de la cámara: la inicia, la detiene y la libera. Hereda del paquete de Machine Learning de Huawei y conecta la superficie de video con el reconocimiento facial o de imagen.
Todo arranca creando una nueva clase dentro del paquete de cámara llamada LensEnginePreview [00:34]. Esta clase recibe en su constructor un contexto y unos atributos, y hereda de ViewGroup, pasándole ambos parámetros [01:05].
Al heredar de ViewGroup, el editor te pedirá implementar el método onLayout, que ubicarás al final de la clase [01:24].
Cómo preparar las variables del motor de lente
Antes de encender nada, necesitas declarar las piezas que controlan el estado de la cámara. Piensa en ellas como los interruptores internos del motor.
Estas son las variables clave que defines dentro de la clase [01:40]:
context: guarda el contexto recibido en el constructor.
surfaceView: hereda de SurfaceView, la clase de Android para trabajar con superficies de video.
startRequested: booleano que indica si ya pediste activar la cámara.
- Una variable booleana que confirma si la superficie está disponible.
lensEngine: el motor de lente de Huawei, iniciado en null.
overlay: la capa GraphicOverlay creada en clases anteriores, también en null.
Después inicializas los valores: startRequested en false, la disponibilidad de superficie en false, y creas el surfaceView pasándole el contexto [03:03]. Luego agregas esa vista con addView para que la superficie quede dentro del ViewGroup [03:24].
¿Por qué el lensEngine inicia en null? Porque la cámara aún no está activa. Al iniciar en null puedes verificar si el motor existe antes de usarlo y evitar errores cuando la cámara todavía no arranca.
Cómo controlar el arranque y el cierre de la cámara
El motor necesita funciones para encender, apagar y liberar recursos. Aquí entra el manejo de excepciones, porque la cámara del dispositivo puede fallar.
La función start inicializa el lens engine y lanza una excepción si la cámara del dispositivo no responde [04:00]. Dentro verificas si el motor es null, lo que significa que todavía no está disponible, y marcas startRequested en true [05:01].
Existe una segunda versión de start sobrescrita que recibe el lensEngine y el overlay. Esta iguala el overlay interno al que recibe y llama a la función start original pasándole el motor [05:44].
La función stop cierra el lente si es diferente de null, deteniendo la captura [04:43]. La función release libera la cámara cuando ya no es nula y vuelve a poner el lensEngine en null, algo que usarás más adelante justo cuando la foto se tome [06:21].
Cómo verificar que la cámara está lista con startIfReady
No basta con pedir la cámara: hay que confirmar que la superficie existe antes de arrancar. Para eso creas startIfReady, otra función envuelta en manejo de excepciones [06:51].
La lógica es directa: si ya pediste el request de inicio y la superficie está disponible, le dices al lensEngine que inicialice pasándole surfaceView.holder [07:08]. La clase holder forma parte del ViewGroup de Android y conecta la superficie con el motor.
Si el overlay no es nulo, calculas el tamaño de visualización con displayDimension [07:40]. Aquí aparece un detalle técnico interesante: usas el método coarse de Huawei, que corrige al máximo las variables de tamaño, aplicándolo tanto al alto como al ancho con atLeast para ajustar mínimo y máximo [08:03].
Luego verificas la orientación del dispositivo. La cámara se trabaja siempre en modo portrait o portarretrato, nunca en landscape [08:49]. Según la orientación, el overlay recibe la información con setCameraInfo, pasando mínimo, máximo, el lensEngine y el lensType.
¿Qué es el lensType en la selfie cam? Es el valor que define qué cámara usas: camera back para la trasera o camera front para la frontal. Determina de dónde se captura la imagen según dónde estés parado.
Al final limpias el overlay con clear y pones startRequested en false [09:40].
Cómo implementar el SurfaceCallback para la superficie
Para saber cuándo la superficie nace, cambia o muere, creas una clase inner llamada SurfaceCallback que hereda de SurfaceHolder.Callback [09:52].
Esta clase implementa tres miembros que responden al ciclo de vida de la superficie [10:08]:
- Cuando la superficie cambia: en esta app no cambia, se mantiene igual siempre.
- Cuando la superficie es destruida: marcas la disponibilidad en
false, porque ya no existe.
- Cuando la superficie es creada: marcas que está disponible y, dentro de un
try, llamas a startIfReady para arrancar la cámara.
Si algo falla al crear la superficie, atrapas una IOException o una excepción en tiempo de ejecución y notificas que no se pudo iniciar la cámara [11:05].
Con el SurfaceCallback listo, ya sabes en todo momento si la superficie está disponible y tu motor de lente queda preparado para conectarse en la siguiente etapa. ¿Te quedó alguna duda sobre cómo conectar el holder con el motor? Déjala en los comentarios.