Escaneo de códigos de barras
Mediante el aprendizaje automático, la cámara en tiempo real de un dispositivo puede leer los datos codificados en la mayoría de los formatos estándar de códigos de barras.

Uso
Los códigos de barras son una forma sencilla y práctica de transferir datos complejos o estructurados del mundo real a un dispositivo. La API de escaneo de códigos de barras de ML Kit permite que tu app lea la mayoría de los formatos estándar de códigos de barras sin que los usuarios tengan que cambiar a otra app de escaneo.
El escaneo de códigos de barras puede ayudar a los usuarios con tareas sencillas de identificación y de acceso a contenido, como buscar un producto para comprarlo, consultar los detalles de un evento o completar un formulario.
Estas directrices de diseño abordan el escaneo de códigos de barras con la cámara en tiempo real.
Guías para desarrolladores sobre el escaneo de códigos de barras
Enlace relacionado
Ejemplo – AndroidApp de demostración de ML Kit para Android
Enlace relacionado
Principios
El diseño de esta función se basa en los siguientes principios:
Navegar con la cámara del dispositivo
En lugar de escribir un término de búsqueda, se usa la cámara del dispositivo como un “control remoto” para escanear códigos de barras.
Para enseñar a los usuarios cómo escanear códigos de barras con su cámara, ofrece un tutorial de introducción e instrucciones permanentes.
Mantener la vista de la cámara despejada y legible
Alinea los componentes de la interfaz de la cámara con los bordes superior e inferior de la pantalla, y asegúrate de que el texto y los iconos sigan siendo legibles cuando se superpongan a la imagen de la cámara.
Todos los elementos no interactivos que se muestren sobre la imagen en tiempo real de la cámara deben ser translúcidos para minimizar la obstrucción de la vista.

Proporcionar retroalimentación
El uso de la cámara para escanear códigos de barras plantea requisitos específicos de usabilidad. La calidad de la imagen debe ser adecuada, y los usuarios deben saber cómo corregir los problemas de imagen causados por la iluminación o por estar demasiado lejos del código de barras.
Los estados de error deben comunicarse mediante varios recursos visuales (como componentes y movimiento) e incluir explicaciones de cómo los usuarios pueden mejorar el escaneo.

Componentes
El escaneo de códigos de barras con la cámara en tiempo real utiliza componentes existentes de Material Design y elementos nuevos específicos para la interacción con la cámara. Para ver ejemplos de código y demostraciones de los elementos nuevos (como el marco del código de barras), consulta el código fuente de la app de demostración de ML Kit Material Design para Android.

1. Barra superior de la aplicación
2. Marco del código de barras
3. Tooltip
4. Hoja inferior modal

Barra superior de la aplicación
La barra superior de la aplicación proporciona acceso permanente a las siguientes acciones:
- Un botón para salir de la experiencia de escaneo
- Un interruptor para mejorar la iluminación (con el flash de la cámara)
- Una sección de Ayuda para solucionar problemas de escaneo

Correcto
Marco del código de barras
El marco del código de barras es un área ubicada en el centro de la pantalla donde el usuario puede escanear un código de barras. De manera predeterminada, el marco es un cuadrado, pero tu app debe ajustar su tamaño y su relación de aspecto para que coincidan con los tipos de códigos de barras admitidos.
El marco cumple tres propósitos:
- Confirmación: La forma del marco se ajusta a las dimensiones de un solo código de barras, por lo que resulta evidente que solo se puede escanear uno a la vez.
- Legibilidad: Si bien los formatos de código de barras sencillos se pueden leer a distancia, los formatos complejos (como PDF417) pueden necesitar una imagen tomada desde más cerca y de mayor calidad para leerse con precisión. Al superponer un borde de detección parcial sobre el marco, la interfaz indica que el usuario debe acercarse más para escanear.
- Actividad: El borde del marco presenta una animación pulsante durante la fase de “exploración” para indicar que la app está buscando códigos de barras.
1. La exploración usa una animación pulsante para indicar que la app está buscando códigos de barras
2. Se muestra un borde parcial sobre el marco (junto con un tooltip) para indicar que el usuario debe acercarse más al código de barras
3. La búsqueda se expresa mediante un indicador de progreso indeterminado sobre el marco del código de barras
4. Los errores transforman el trazo continuo del marco del código de barras en un estilo punteado
Tooltip
Los tooltips muestran texto informativo a los usuarios. Por ejemplo, comunican estados (con mensajes como “Buscando…”) y orientan al usuario hacia el siguiente paso (con mensajes como “Apunta la cámara hacia un código de barras”).

Correcto

Incorrecto

Incorrecto
Hoja inferior modal
Las hojas inferiores modales proporcionan acceso a la información del código de barras mientras el usuario permanece en la función de escaneo de códigos de barras. El diseño y el contenido de la hoja inferior dependen del tipo de datos codificados en el código de barras; por ejemplo:
- Los datos estructurados (como la información de contacto) se pueden mostrar en campos de texto para consultarlos y editarlos
- La información proveniente de una base de datos debe mostrarse con un estilo apropiado para visualizar el contenido. Los tipos de contenido varían: por ejemplo, el contenido de redes sociales tiene una estructura diferente a la de un producto de venta minorista.
Cómo mostrar los resultados
Si es más rápido o más fácil para el usuario completar su tarea en otra pantalla de la app, presenta la información del código de barras en esa pantalla en lugar de una hoja inferior modal. Consulta la sección Experiencia para obtener más información sobre cuándo y dónde mostrar la información del código de barras en la app.


Experiencia
El escaneo de códigos de barras con la cámara en tiempo real se realiza en tres fases:
- Exploración: Usar la cámara para buscar datos de entrada
- Reconocimiento: Detectar un código de barras
- Comunicación: Mostrar los resultados del código de barras de forma integrada o en otra pantalla
Exploración
La “exploración” es la fase en la que la cámara busca códigos de barras en la imagen en tiempo real. El escaneo de códigos de barras comienza cuando el usuario abre la función de códigos de barras en una app.
Durante esta fase, la app debe:
- Explicar cómo funciona esta función
- Comunicar las acciones disponibles en la app
- Orientar al usuario sobre cómo ajustar el manejo de la cámara
Correcto
Correcto
Guía de ajustes
Las condiciones del entorno, como una iluminación demasiado intensa o demasiado escasa, pueden dificultar el escaneo de un código de barras.

Reconocimiento
Cuando la cámara detecta un código de barras, la app debe:
- Pausar la cámara y leer el valor del código de barras
- Mostrar el valor de inmediato si se trata de datos estructurados
- Realizar la búsqueda y mostrar el progreso si el valor del código de barras debe consultarse
En esta fase, la API de escaneo de códigos de barras detecta un código de barras en la imagen de la cámara y lee su valor. La imagen de la cámara se detiene momentáneamente para evitar que se escanee otro código de barras.
Los códigos de barras que contienen datos estructurados reconocidos por la API (como coordenadas de ubicación y eventos de calendario) se pueden presentar de inmediato al usuario. Si el código de barras no contiene datos estructurados, la información detallada se recupera de una base de datos. La app muestra un estado de carga mientras se obtiene esta información.
Correcto
Correcto
Cómo realizar correcciones
La detección de un código de barras no garantiza que tu app encuentre resultados. Pueden producirse los siguientes problemas:
- Sin resultados relevantes: Un código de barras que se haya escaneado correctamente podría no contener información relevante para tu app o tu caso de uso, como el escaneo de un código de barras de una fuente no relacionada con la app.
- Pérdida de conexión a la red: Si el valor del código de barras se consulta en una base de datos en línea, la solicitud de datos puede fallar si no hay conexión a Internet.
- Código de barras demasiado pequeño: Si bien los formatos de código de barras sencillos se pueden leer a distancia, los formatos complejos (como PDF417) pueden requerir una imagen tomada desde más cerca y de mayor calidad para leerse con precisión. Para indicar al usuario que debe acercarse más al código de barras antes de poder escanearlo, establece un tamaño mínimo de escaneo para los formatos de códigos de barras que acepta tu app y usa varios recursos visuales (como el marco del código de barras y el tooltip).

Correcto
Correcto
Comunicación
Los resultados de un escaneo de código de barras se pueden mostrar de varias maneras:
- Sobre la imagen de la cámara (en una hoja inferior modal o en un diálogo)
- En la pantalla donde se usará la información del código de barras, tras salir de la función de escaneo de códigos de barras
Para adaptar la interfaz a tu caso de uso, se recomiendan los siguientes patrones de navegación y componentes:
| Ejemplo de caso de uso | ¿El usuario permanece en el escáner de códigos de barras? | Dónde se muestran los resultados |
|---|---|---|
| Explorar productos en una tienda | Sí | Hoja inferior modal |
| Agregar un contacto | Sí, hasta que el usuario lo guarde | Una hoja inferior modal o un diálogo de pantalla completa |
| Completar un formulario | No; se vuelve al formulario | Se completan automáticamente los campos relevantes del formulario para el usuario |
Correcto
Correcto
Correcto
Aplicación de temas
Tema Material de Shrine
El escaneo de códigos de barras se usa en el flujo de compra de la app de Shrine.


Marco del código de barras
El marco del código de barras de Shrine usa el color On Primary de la marca para el velo. El borde del marco tiene esquinas rectas que reflejan la forma geométrica del logotipo de la marca.

2. El marco del código de barras de Shrine usa Shrine Pink 900 (#442C2E) como color del velo, con un borde recto.
Tooltip
El tooltip de Shrine se distingue por el uso de colores personalizados, tipografía y una ubicación específica.

2. El tooltip de Shrine usa colores personalizados y tipografía, y extiende el contenedor hasta los bordes de la pantalla.