Escáner de código de barras MAUI con IronBarcode: Guía paso a paso

Entendiendo cómo IronBarcode se integra en MAUI

.NET MAUI le ofrece una única base de código orientada a Android, iOS, macOS y Windows. El desafío con el escaneo de códigos de barras en este entorno es que cada plataforma maneja el acceso a la cámara de manera diferente. IronBarcode aborda esto trabajando en la capa de procesamiento de imágenes - usted captura la imagen a través de MediaPicker de MAUI, a continuación, entrega los bytes a IronBarcode para su análisis.

Esta separación de preocupaciones mantiene su código limpio y evita los SDK de código de barras específicos de la plataforma. El modelo de procesamiento fuera de línea de IronBarcode también significa que los datos del código de barras nunca salen del dispositivo, lo que es importante para las aplicaciones en industrias reguladas.

Formatos de códigos de barras compatibles

IronBarcode lee una amplia gama de formatos , entre los que se incluyen:

Instalación de IronBarcode mediante NuGet

Abra la consola del Administrador de paquetes NuGet y ejecute:

Install-Package BarCode

Como alternativa, haga clic con el botón derecho en su proyecto en el Explorador de soluciones, seleccione "Administrar paquetes NuGet", busque IronBarCode e instale la última versión estable. Específicamente para proyectos .NET MAUI , el paquete NuGet de IronBarcode incluye todas las dependencias nativas necesarias.

Activando su licencia

Después de la instalación, active IronBarcode con su clave de licencia al comienzo del ciclo de vida de la aplicación. El mejor lugar es en MauiProgram.cs antes de que se ejecute el app builder:

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Obtenga una clave de licencia de prueba gratuita en el sitio web de IronSoftware. Las claves de prueba le permiten evaluar todas las funciones sin límite de tiempo durante el desarrollo, aunque el resultado puede incluir una marca de agua de prueba hasta que aplique la licencia completa.

Permisos de Android

Editar Platforms/Android/AndroidManifest.xml para declarar el acceso a la cámara:

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" android:required="true" />
<uses-feature android:name="android.hardware.camera.autofocus" />

La entrada android.permission.CAMERA solicita permiso de ejecución al usuario. Las declaraciones uses-feature informan a Google Play Store de que tu aplicación requiere hardware de cámara y capacidad de autoenfoque. Sin estos, los dispositivos Android pueden conceder la solicitud de permiso pero aún así bloquear el acceso a la cámara internamente.

Para Android 13 y versiones posteriores (nivel de API 33+), es posible que también necesite gestionar permisos multimedia granulares en su MainActivity.cs utilizando ActivityCompat.RequestPermissions. La abstracción MAUI MediaPicker maneja la mayor parte de esto de forma automática, pero se recomienda la prueba física del dispositivo antes de su lanzamiento.

Permisos de iOS

Modifique Platforms/iOS/Info.plist para incluir la descripción del uso de la cámara:

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

<key>NSCameraUsageDescription</key>
<string>This app requires camera access to scan barcodes</string>

iOS requiere una explicación legible para humanos para cada permiso sensible a la privacidad. El proceso de revisión de la App Store de Apple rechazará su aplicación si esta descripción falta o es vaga. El texto aparece en el cuadro de diálogo de permisos del sistema que se muestra al usuario la primera vez que la aplicación solicita acceso a la cámara.

Para iPadOS, considere también la posibilidad de añadir NSPhotoLibraryUsageDescription si tiene previsto permitir a los usuarios escanear códigos de barras de fotos guardadas además de la cámara en directo.

Windows y macOS

Para los destinos de Windows Desktop y macOS, los permisos de acceso a la cámara se administran a través del manifiesto de la aplicación y los archivos de derechos respectivamente. El marco MAUI maneja la mayor parte de esto a nivel de plantilla, pero compruebe que Package.appxmanifest en Windows incluye la capacidad del dispositivo de cámara web.

Agregar comentarios sobre el estado del escaneo

Para que la experiencia sea mejor, considere la posibilidad de envolver los botones de escaneo en un ActivityIndicator que se muestre mientras se está procesando. La API asíncrona de IronBarcode hace que esto sea sencillo: puede establecer IsRunning = true antes de llamar a BarcodeReader.ReadAsync y restablecerlo en el bloque finally.

Prueba de la implementación del escaneo

Con el código en su lugar, puedes probarlo con un código de barras estándar:

Después de escanear, el valor decodificado aparece en la pantalla:

Dirigido a tipos específicos de códigos de barras

Especificar los tipos de códigos de barras exactos que espera reduce drásticamente el tiempo de procesamiento porque IronBarcode omite las verificaciones de formato que no necesita:

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

var results = await BarcodeReader.ReadAsync(bitmap, options);

Imports System.Threading.Tasks

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128
}

Dim results = Await BarcodeReader.ReadAsync(bitmap, options)

Cómo crear un escáner de código de barras MAUI con IronBarcode: Figura 4 - Múltiples códigos escaneados desde la misma imagen

La configuración de ExpectMultipleBarcodes = true indica a IronBarcode que continúe escaneando después de encontrar el primer resultado, lo que resulta esencial para los flujos de trabajo de almacén en los que un solo albarán puede contener una docena de códigos de barras.

Opciones de velocidad de lectura

El ReadingSpeed enum ofrece cuatro niveles: ExtremeDetail, Detailed, Balanced y QuickScan. Utilice QuickScan para situaciones de gran volumen en las que los códigos de barras estén limpios y bien iluminados. Cambie a Detailed o ExtremeDetail cuando escanee a partir de capturas de cámara de baja resolución o etiquetas que hayan sido parcialmente dañadas.

Para obtener más información sobre cómo ajustar BarcodeReaderOptions , incluidos los filtros de corrección de imagen y los umbrales de confianza, la documentación proporciona ejemplos detallados.

Corrección y preprocesamiento de imágenes

IronBarcode incluye corrección de imagen incorporada que maneja automáticamente códigos de barras rotados, torcidos o mal iluminados. También puede aplicar filtros de preprocesamiento manualmente a través de BarcodeReaderOptions.ImageFilters:

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Detailed,
    ImageFilters = new ImageFilterCollection
    {
        new SharpenFilter(),
        new ContrastFilter(1.2f)
    }
};

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Detailed,
    .ImageFilters = New ImageFilterCollection From {
        New SharpenFilter(),
        New ContrastFilter(1.2F)
    }
}

Los filtros de preprocesamiento son particularmente útiles cuando la aplicación apunta a dispositivos Android más antiguos con sensores de cámara de menor calidad, o cuando es probable que los usuarios fotografíen códigos de barras en condiciones de iluminación subóptimas, como almacenes o entornos al aire libre.

La cámara no se abre

Si la cámara no se inicia, compruebe que los permisos están correctamente declarados en AndroidManifest.xml y Info.plist. Luego, vuelva a implementar la aplicación desde una compilación limpia en lugar de una recarga en caliente. En Android, verifique también si su dispositivo de prueba utiliza una configuración de cámara no estándar: algunos dispositivos con múltiples cámaras requieren una selección de lente explícita.

En el simulador, MediaPicker.CapturePhotoAsync() no es compatible. Pruebe siempre las funciones de la cámara en un dispositivo físico. El emulador admite PickPhotoAsync para la selección de la galería, que puede utilizar para realizar pruebas básicas de la interfaz de usuario con imágenes precargadas.

Mala precisión de escaneo

Si IronBarcode no devuelve resultados o valores incorrectos, pruebe estos ajustes:

• Aumente el Speed a ReadingSpeed.Detailed o ExtremeDetail
• Añadir SharpenFilter y ContrastFilter al proceso de filtrado de imágenes
• Asegúrese de que la resolución de la imagen capturada sea de al menos 720p; las resoluciones más bajas provocan detecciones fallidas con formatos densos como Data Matrix.
• Compruebe si el tipo de código de barras está incluido en su máscara ExpectBarcodeTypes

La guía de solución de problemas de IronBarcode cubre pasos de diagnóstico adicionales para problemas específicos del formato.

Gestión de la memoria

Las imágenes de cámara de gran tamaño consumen mucha memoria cuando se cargan en MemoryStream. Utilice siempre declaraciones using en todos los objetos de flujo para garantizar su eliminación. Para flujos de trabajo de escaneo continuo en los que los usuarios escanean varios elementos en secuencia, llame también a bitmap.Dispose() explícitamente después del procesamiento en lugar de esperar al recolector de basura.

En dispositivos Android con espacio de almacenamiento limitado, considere reducir la resolución de la imagen antes de pasarla a IronBarcode si los escaneos son de códigos de barras limpios y de alto contraste que no requieren una resolución completa para decodificarse con precisión.

Comportamiento de iOS específico de la plataforma

En iOS, la primera vez que la aplicación solicita permiso para la cámara, el sistema muestra un cuadro de diálogo único. Si el usuario lo niega, las siguientes llamadas a CapturePhotoAsync lanzarán un PermissionException. Maneje este caso dirigiendo al usuario a Configuración, lo que puede hacer con AppInfo.ShowSettingsUI().

Confirma que NSCameraUsageDescription está presente en Info.plist antes de enviarlo a la App Store. La falta de cadenas de privacidad provoca un rechazo automático sin una explicación detallada del equipo de revisión. Revise las Pautas de interfaz humana de Apple para el acceso a la cámara para conocer las mejores prácticas sobre el tiempo y los mensajes de las solicitudes de permiso.