0:0010:01

Recursos

Resumen

La verificación de rostro en una cámara de selfie personalizada en Android requiere conectar botones, códigos de detección y el ciclo de vida de la cámara para que tu rostro aparezca por primera vez en pantalla. Si estás desarrollando con el SDK de Huawei y detección facial, aquí ves cómo armar ese flujo paso a paso sin perderte en el camino.

¿Cómo se envía el código de detección desde el botón?

Todo arranca en el main activity. Ahí le dices a cada botón qué tipo de detección va a ejecutar enviando un código a través de un intent.

Usas putExtra con la llave detect mode y le pasas un número. En el ejemplo, el primer botón envía el código 1002 y el segundo el 1003 [00:21]. El número en sí es arbitrario, lo importante es que cada botón tenga uno distinto para diferenciar la acción.

¿Para qué sirve el detect mode en la detección facial? Es un código numérico que viaja en el intent desde la actividad principal hacia la cámara. Le indica qué tipo de verificación ejecutar, por ejemplo 1002 o 1003, y permite distinguir entre modos de detección.

Duplicas la misma funcionalidad para el segundo botón, cambias la referencia y ajustas el código. Simple, pero clave para que la cámara sepa qué hacer.

¿Cómo se recibe y valida el código en la actividad de cámara?

En la actividad de la cámara creas una variable llamada detectMode, inicializada en cero [01:14]. Ahí recibes el código que viaja desde la actividad principal.

Luego, dentro del on create, llamas al intent y validas dentro de un try que el código llegue correctamente usando getIntExtra con la llave detect mode. Si no llega nada, defines un valor por defecto de 1.

El manejo de errores no es opcional aquí. Envuelves la lectura en un catch que captura una excepción en tiempo de ejecución y la registras como error con un mensaje tipo "no pude traer el código de detección" [07:28]. Esto evita que la app se caiga si el intent viene vacío.

¿Qué hace la función save instance state?

Creas una función que guarda el estado de la cámara cuando la app cambia entre landscape y portrait [01:36]. Usas la versión que trae el bundle, quitas la llamada super inicial y agregas outState.putInt con la llave lensType.

Ese lensType cumple dos funciones:

  • Guardar si la cámara viene en modo front o back.
  • Conservar la orientación de la pantalla.

Aunque la orientación esté bloqueada solo en portrait, esta función te sirve si decides desbloquearla más adelante. Después vuelves a llamar al super con el onState.

¿Cómo se maneja el motor de lente de la cámara?

La cámara funciona en modo sincrónico, y eso cambia todo. Significa que tienes que controlar manualmente cada estado del motor para que no se quede colgado.

Creas la función startLensEngine para inicializar el motor [02:40]. Dentro validas el botón de restart, pones la visualización en gone y verificas que el lens engine exista y sea diferente de null.

Todo esto va dentro de un try con manejo de IOException. Si el lente lanza un error, lo liberas y lo devuelves a null [03:33]. Como la cámara trabaja sincrónicamente, debes capturar todas las excepciones posibles.

Si no hay excepción, validas el detectMode:

  • Con código 1003, le dices al preview que inicialice el lente y además el overlay, la capa donde se pintará la detección.
  • Con código 1002, el preview solo inicializa el lens engine sin la capa.

¿Cómo se retoma la foto con start preview?

Creas la función startPreview que hereda de view y puede ser vacía [04:35]. Cuando el preview se libera, vuelves a crear e inicializar el lente.

Esto permite retomar la foto: el motor arranca de nuevo y la previsualización vuelve a mostrarse. Es el botón de "reintentar" en la práctica.

¿Por qué el ciclo de vida importa en una cámara sincrónica?

Porque si no gestionas el ciclo de vida, la cámara sigue consumiendo recursos aunque la app esté en pausa. Creas tres funciones esenciales: onResume, onPause y onDestroy [05:05].

Cada una controla el motor según el estado de la app:

  • En onResume llamas a startLensEngine para reactivar el motor.
  • En onPause le dices al preview que se detenga con stop.
  • En onDestroy verificas si el lens engine existe y, si es así, lo liberas para no usarlo más.

¿Por qué hay que liberar el lens engine en onDestroy? Porque la cámara opera en modo sincrónico y mantiene recursos activos. Liberarla al destruir la actividad evita fugas de memoria y bloqueos del dispositivo.

Este control del ciclo de vida es lo que separa una cámara estable de una que se congela al minimizar la app.

¿Qué hacer si la cámara se ve en negro?

Aquí viene lo interesante. Al correr la app por primera vez, iniciar sesión con Huawei ID y dar clic a un botón, la visualización aparece en negro [06:34]. Un error silencioso.

Revisando el lens engine preview, el problema estaba en dos puntos:

  1. Faltaba llamar el callback de la vista. Agregas surfaceView, llamas al holder y añades el surface callback con su función [07:50].
  2. La proporción estaba mal. El código usaba childWidth con el valor de height; debes cambiarlo a width para que la proporción de la cámara salga correcta [08:15].

Tras corregir el callback y la proporción, compilas de nuevo, autorizas el inicio de sesión, pruebas un botón y por fin tu rostro aparece en la cámara [08:40].

Con esto ya tienes tu cámara personalizada funcionando y te ves por primera vez en tu cámara de selfies. ¿Te animas a probar desbloqueando la orientación con el lensType que configuraste? Cuéntame en los comentarios cómo te fue con el ciclo de vida de tu cámara.

Verificación de rostro: tu primera selfie con código

Ver clases