Arquitectura del flujo de trabajo de la cámara

La arquitectura de Scanbot requiere una inicialización al iniciar la aplicación, seguida de una llamada de escaneo controlada por la cámara. El método del escáner requiere un BarcodeScannerScreenConfiguration porque toda la operación depende de la cámara:

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

Imports ScanbotSDK.MAUI
Imports ScanbotSDK.MAUI.Barcode

' In MauiProgram.vb — initialization required before any scan
' ScanbotSDKMain.Initialize(New SdkConfiguration With {
'     .LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
'     .LoggingEnabled = False
' }, builder)

' Configure scanner appearance and behavior
Dim configuration As New BarcodeScannerScreenConfiguration With {
    .UseCase = New SingleScanningMode()
}

' Open full-screen camera scanner — UI takes over the entire screen
Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

If result.IsSuccess Then
    For Each item In result.Value.Items
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}")
    Next
End If

El SDK procesa los fotogramas de vídeo en directo en tiempo real, resalta los códigos de barras detectados en el visor y regresa cuando se confirma un código de barras o el usuario cancela la operación. El objeto de configuración controla la apariencia de la interfaz de usuario de la cámara, no el comportamiento de procesamiento. Ese es el modelo completo.

Comparación detallada de características

Enfoque del SDK de Scanbot

La arquitectura de Scanbot está construida en torno a un pipeline de cámara nativa. Cuando se llama a ScanbotSDKMain.Barcode.StartScannerAsync(configuration), la biblioteca transfiere el control a una experiencia de cámara en pantalla completa impulsada por las APIs de cámara nativas del dispositivo en iOS, Android o Windows. La biblioteca procesa continuamente los fotogramas de vídeo en directo, aplica la detección de códigos de barras a cada fotograma y devuelve el control a la aplicación que la llamó cuando se confirma un código de barras o el usuario desactiva el escáner. En el modelo de Scanbot no existe el concepto de imagen estática: la entrada es siempre una secuencia de fotogramas de vídeo en directo procedentes de la cámara del dispositivo.

Este diseño produce una experiencia de escaneo con códigos de barras en tiempo real destacados en el visor, región de escaneo configurable con control de relación de aspecto, interruptor de linterna, retroalimentación de audio y háptica, y bloqueo de orientación. Estas son características de UI construidas para el caso de uso de la cámara. La desventaja es que la biblioteca es inseparable del hardware de la cámara y del sistema operativo que la impulsa.

Enfoque IronBarcode

IronBarcode acepta cualquier representación binaria de una imagen que contenga un código de barras y devuelve los resultados decodificados mediante el mismo método estático, independientemente de cómo se haya obtenido la imagen:

// Install: dotnet add package BarCode
using IronBarCode;

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

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

// Install: dotnet add package BarCode
using IronBarCode;

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

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

Imports IronBarCode

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

' From a file path — works in any project type
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

' From a PDF — reads all barcodes on all pages
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' From a stream — useful for HTTP file uploads
Using stream = File.OpenRead("document.pdf")
    Dim streamResults = BarcodeReader.Read(stream)
End Using

' With processing options
Dim options = New BarcodeReaderOptions With {.Speed = ReadingSpeed.Balanced}
Dim configuredResults = BarcodeReader.Read("image.png", options)

La misma llamada se ejecuta en una aplicación de consola, un controlador ASP.NET Core, una función de Azure, un formulario WPF o una página MAUI. IronBarcode lee los códigos de barras de los archivos PDF de forma nativa , no como imágenes extraídas de los PDF, sino analizando directamente la estructura del PDF y buscando los códigos de barras en cada página.

Enfoque del SDK de Scanbot

El paquete MAUI de Scanbot tiene como objetivo net9.0-android y net9.0-ios. Un proyecto .NET MAUI Application que declare solo esos dos objetivos se construirá con éxito. Sin embargo, cuando se añade net9.0-maccatalyst o un objetivo MAUI de Windowsa TargetFrameworks, la referencia del paquete MAUI de Scanbot no se resuelve en esos objetivos. Esto no es un problema de configuración: el paquete MAUI no proporciona ensamblajes para MAUI Windows o macOS. El escritorio de Windows está cubierto por el paquete separado Scanbot.BarcodeSDK.Windows para aplicaciones UWP/WinUI 3 con una cámara autofoco.

El resultado es que el conjunto de paquetes .NET de Scanbot tiene como objetivo móviles MAUI y escritorios UWP/WinUI 3, en lugar de tipos de proyecto del lado del servidor o de escritorio sin cámara.

Enfoque IronBarcode

IronBarcode se distribuye como un único paquete NuGet que se resuelve correctamente en todos los tipos de proyectos .NET y marcos de destino:

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

Para las aplicaciones MAUI que también están dirigidas a Windows o macOS , IronBarcode admite las cuatro plataformas MAUI desde una única referencia de paquete sin necesidad de configuración condicional por plataforma. Los equipos que están construyendo un proyecto MAUI que tiene como objetivo iOS, Android y Windows pueden añadir IronBarcode una vez y usar BarcodeReader.Read() en las tres plataformas sin modificaciones.

Enfoque del SDK de Scanbot

En un proyecto MAUI dirigido a iOS y Android, Scanbot proporciona un visor de cámara nativo integrado en el flujo de navegación de la aplicación. La llamada ScanbotSDKMain.Barcode.StartScannerAsync() presenta el escáner de pantalla completa, y el resultado regresa a la página llamante cuando el usuario completa o descarta el escaneo. Esta integración le da a la aplicación móvil una interfaz de usuario de escaneo que se siente nativa a la plataforma.

La limitación aparece cuando el proyecto se expande. Agregar un objetivo macOS o un objetivo MAUI de Windowsrompe la construcción en esas plataformas (el escritorio de Windows se maneja en su lugar por el paquete separado Scanbot.BarcodeSDK.Windows para aplicaciones UWP/WinUI 3). Agregar un componente del lado del servidor sin cabeza que necesite procesamiento de códigos de barras requiere una biblioteca separada: la dependencia de Scanbot no puede seguir el proyecto en ASP.NET Core, Funciones de Azure o Docker.

Enfoque IronBarcode

En un proyecto MAUI, IronBarcode trabaja con el MediaPicker de la plataforma para capturar fotos y leer códigos de barras de las imágenes resultantes. El flujo de trabajo de escaneo utiliza la cámara del sistema en lugar de un visor personalizado:

// Works on iOS, Android, Windows, and macOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

// Works on iOS, Android, Windows, and macOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

Imports IronBarCode

Private Async Sub ScanButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                Await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK")
            Next
        End Using
    End Using
End Sub

La ventaja es la superposición en tiempo real del visor. El usuario ve la interfaz de usuario de la cámara del sistema en lugar de una región de escaneo personalizada, lo cual es adecuado para aplicaciones comerciales donde basta con apuntar y capturar. El tutorial del escáner de códigos de barras .NET MAUI cubre el patrón de integración completo de MAUI para dispositivos iOS y Android , incluyendo la gestión de permisos y la configuración del proyecto.

Enfoque de Scanbot

Scanbot funciona con un modelo de tarifa plana anual. El costo anual de la licencia no se mide por volumen de escaneo. Esto proporciona una presupuestación anual predecible para equipos con implementaciones estables exclusivamente móviles. Para conocer el precio exacto, póngase en contacto con el equipo de ventas de Scanbot. Las cifras publicadas no están disponibles. La obligación de renovación anual implica que la licencia supone un coste operativo continuo.

Enfoque IronBarcode

IronBarcode se vende como una compra única y perpetua en cuatro niveles: Lite por $749, Plus por $1,499, Professional por $2,999 e Unlimited por $5,999. No se requiere renovación anual para seguir utilizando la versión adquirida. Las actualizaciones de software dentro del período de licencia están incluidas. Los precios se publican en el sitio web de Iron Software sin necesidad de una conversación de ventas.

Procesamiento del lado del servidor y del backend

Una aplicación móvil desarrollada con Scanbot suele coexistir con un componente del lado del servidor que gestiona la carga de documentos, los trabajos por lotes o los puntos finales de la API. Cuando ese componente del servidor necesita procesar códigos de barras (extraer códigos de barras de archivos PDF cargados, validar valores de códigos de barras en documentos entrantes o procesar datos de códigos de barras de archivos adjuntos de imagen), Scanbot no está disponible. El paquete no se compila en ASP.NET Core, Azure Functions, aplicaciones de consola ni en ningún proyecto que no sea MAUI. Los equipos que se encuentran en esta situación deben mantener una dependencia de códigos de barras para dispositivos móviles junto con una solución de códigos de barras independiente para servidores, o bien, evaluar si IronBarcode puede cubrir ambas funciones con un solo paquete.

Requisitos de la aplicación de escritorio

La propuesta de valor de MAUI suele ser la compatibilidad multiplataforma: un único código base que sirve para iOS, Android y Windows. Cuando el objetivo MAUI de Windowsentra en la hoja de ruta — ya sea desde los requisitos iniciales o como una adición posterior — el paquete ScanbotBarcodeSDK.MAUI no se resuelve en ese objetivo, porque Scanbot cubre Windows a través de un paquete separado UWP/WinUI 3 (Scanbot.BarcodeSDK.Windows) en lugar de a través de MAUI Windows. Los equipos que desean una única ruta de compilación de Windows dentro de un proyecto MAUI de múltiples objetivos, o que necesitan un componente de Windows sin cabeza (como un servicio de Windows), no lo obtendrán del conjunto de paquetes de Scanbot. IronBarcode proporciona un único paquete que se resuelve en el objetivo MAUI de Windows y también se ejecuta en contextos de escritorio sin cabeza y servidor.

Flujos de trabajo de PDF y documentos

Las aplicaciones que pasan del escaneo en tiempo real a la automatización de documentos se topan con una limitación de capacidades en Scanbot. Leer códigos de barras de una factura PDF, extraer códigos de rastreo de una imagen de etiqueta de envío escaneada o procesar datos de códigos de barras de un documento archivado se encuentran fuera del modelo de entrada de Scanbot, que está construido alrededor de una transmisión en vivo de la cámara. IronBarcode gestiona de forma nativa todas estas entradas basadas en archivos. El mismo paquete que se ejecuta en la aplicación móvil MAUI puede extraer códigos de barras de documentos PDF mediante un procesamiento en segundo plano, sin dependencias adicionales.

Costes de licencia predecibles

Los costes de renovación anuales invitan a una reevaluación en cada ciclo de renovación. Los equipos que comenzaron con Scanbot en una implementación móvil a pequeña escala y se expandieron a una implementación más amplia con más usuarios o plataformas pueden encontrar que la tarifa anual es menos favorable a medida que aumenta el alcance. El modelo perpetuo de pago único de IronBarcode elimina la obligación de renovación. Los equipos que realizan evaluaciones de renovación de licencias a menudo consideran si una compra única se ajusta mejor a su planificación de costos a largo plazo, especialmente cuando el alcance ampliado del proyecto incluye plataformas de servidor o de escritorio que, de todos modos, quedan fuera de la cobertura de Scanbot.

No tiene equivalente a un visor en directo.

El visor de cámara en tiempo real de Scanbot, con la superposición de la región de escaneo, la detección continua y la retroalimentación háptica, no tiene un equivalente directo en IronBarcode. El patrón de reemplazo utiliza el MediaPicker.CapturePhotoAsync() de MAUI para abrir la cámara del sistema, capturar una foto y devolver la imagen para su procesamiento. La experiencia del usuario consiste en un proceso de captura de fotos, en lugar de un proceso de escaneo continuo. En las aplicaciones empresariales (inventario, logística, procesamiento de documentos), esta distinción rara vez es significativa. En el caso de las aplicaciones de consumo donde la superposición en tiempo real es fundamental para la experiencia del producto, esta es una diferencia real en la experiencia del usuario que debe evaluarse antes de comprometerse con la migración.

Patrón de devolución de llamada de evento para retorno directo

El ScanbotSDKMain.Barcode.StartScannerAsync() de Scanbot es asíncrono y devuelve un resultado con una bandera IsSuccess y una colección Value.Items. El BarcodeReader.Read() de IronBarcode devuelve una colección directamente, no hay un objeto contenedor con un campo de estado. La verificación de éxito cambia de result.IsSuccess a results.Any() o una verificación de nulo en results.FirstOrDefault().

Cambio de espacio de nombres de enumeración de formato

El enum BarcodeFormat de Scanbot (por ejemplo, BarcodeFormat.Code128) y el enum BarcodeEncoding de IronBarcode (por ejemplo, BarcodeEncoding.Code128) contienen miembros similares pero son tipos diferentes en diferentes espacios de nombres. El código que almacena o compara valores de formato por tipo de enumeración requiere que se actualice la referencia de tipo. Las comparaciones de cadenas basadas en la salida .ToString() son generalmente compatibles ya que los nombres de los miembros son similares, pero las comparaciones explícitas de tipos de enum requieren actualización a los valores BarcodeEncoding.

Complementos de compilación de Windows

Si el paquete Scanbot estaba causando fallos en la compilación de MAUI de Windowsantes de la migración, eliminarlo resuelve esos fallos. Tras añadir IronBarcode, verifique que las funcionalidades específicas de Windows (cuadros de selección de archivos, rutas de archivos locales, permisos de Windows) se gestionen correctamente en el código de la aplicación MAUI, ya que difieren de los patrones de acceso a archivos de iOS y Android.