Arquitetura do Pipeline da Câmera

A arquitetura do Scanbot requer inicialização na abertura do aplicativo, seguida por uma chamada de digitalização controlada pela câmera. O método do scanner requer um BarcodeScannerScreenConfiguration porque toda a operação é dirigida pela câmera:

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

O SDK processa quadros de vídeo ao vivo em tempo real, destaca os códigos de barras detectados no visor e retorna quando um código de barras é confirmado ou quando o usuário cancela. O objeto de configuração controla a aparência da interface do usuário da câmera, não o comportamento de processamento. Esse é o modelo completo.

Comparação Detalhada de Recursos

Abordagem do SDK Scanbot

A arquitetura do Scanbot é construída em torno de um pipeline de câmera nativo. Quando ScanbotSDKMain.Barcode.StartScannerAsync(configuration) é chamado, a biblioteca entrega o controle para uma experiência de câmera em tela cheia alimentada pelas APIs de câmera nativa do dispositivo no iOS, Android ou Windows. A biblioteca processa continuamente quadros de vídeo ao vivo, aplica a detecção de código de barras a cada quadro e retorna o controle ao aplicativo que fez a chamada quando um código de barras é confirmado ou o usuário dispensa o scanner. Não modelo Scanbot, não existe o conceito de imagem estática — a entrada é sempre um fluxo de quadros de vídeo ao vivo da câmera do dispositivo.

Este design produz uma experiência de escaneamento com códigos de barras em tempo real destacados no visor, região de escaneamento configurável com controle de proporção, alternância de lanterna, feedback de áudio e tátil, e bloqueio de orientação. Estes são recursos de interface gráfica construídos para o caso de uso da câmera. A desvantagem é que a biblioteca é inseparável do hardware da câmera e do sistema operacional que a controla.

Abordagem do IronBarcode

O IronBarcode aceita qualquer representação binária de uma imagem contendo um código de barras e retorna os resultados decodificados pelo mesmo método estático, independentemente de como a imagem foi obtida:

// 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)

A mesma chamada é executada em um aplicativo de console, um controladorASP.NET Core, uma Função do Azure, um formulário WPF ou uma página MAUI. O IronBarcodelê códigos de barras de PDFs nativamente — não como imagens extraídas de PDFs, mas analisando diretamente a estrutura do PDF e encontrando códigos de barras em cada página.

Abordagem do SDK Scanbot

O pacote Scanbot MAUI tem como alvo net9.0-android e net9.0-ios. Um projeto .NET MAUI Application que declara apenas esses dois destinos será construído com sucesso. Não entanto, quando net9.0-maccatalyst ou um destino MAUI do Windows é adicionado a TargetFrameworks, a referência ao pacote Scanbot MAUI falha ao resolver nesses destinos. Isso não é um problema de configuração — o pacote MAUI não fornece assemblies para MAUI no Windows ou macOS. O desktop do Windows é coberto pelo pacote Scanbot.BarcodeSDK.Windows separado para aplicativos UWP/WinUI 3 com uma câmera de autofoco.

O resultado é que o conjunto de pacotes .NET do Scanbot tem como alvo MAUI móvel e UWP/WinUI 3 no desktop, em vez de tipos de projetos de servidor ou desktop sem câmera.

Abordagem do IronBarcode

O IronBarcode é distribuído como um único pacote NuGet que funciona corretamente em todos os tipos de projetos .NET e frameworks 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 aplicações MAUI que também têm como alvo o Windows ou o macOS , o IronBarcode suporta todos os quatro destinos MAUI a partir de uma única referência de pacote, sem necessidade de configuração condicional à plataforma. As equipes que estão construindo um projeto MAUI que visa iOS, Android e Windows podem adicionar o IronBarcode uma vez e usar BarcodeReader.Read() em todas as três plataformas sem modificação.

Abordagem do SDK Scanbot

Em um projeto MAUI voltado para iOS e Android, o Scanbot fornece um visor de câmera nativo incorporado ao fluxo de navegação do aplicativo. A chamada ScanbotSDKMain.Barcode.StartScannerAsync() apresenta o scanner em tela cheia, e o resultado retorna para a página chamadora quando o usuário completa ou dispensa a digitalização. Essa integração dá ao aplicativo móvel uma interface de escaneamento que parece nativa da plataforma.

A limitação surge quando o projeto se expande. Adicionar um destino macOS ou um destino MAUI do Windows quebra a compilação nessas plataformas (o desktop do Windows é tratado em vez disso pelo pacote Scanbot.BarcodeSDK.Windows separado para aplicativos UWP/WinUI 3). Adicionar um componente de servidor sem cabeça que precisa de processamento de código de barras exige uma biblioteca separada — a dependência do Scanbot não pode acompanhar o projeto em ASP.NET Core, Azure Functions ou Docker.

Abordagem do IronBarcode

Em um projeto MAUI, o IronBarcode funciona com o MediaPicker da plataforma para capturar fotos e ler códigos de barras das imagens resultantes. O fluxo de trabalho de digitalização utiliza a câmera do sistema em vez de um visor personalizado:

// Works on iOS, Android, Windows, andmacOS 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, andmacOS 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
Imports System.IO
Imports System.Threading.Tasks

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

A vantagem é a sobreposição do visor em tempo real. O usuário visualiza a interface da câmera do sistema em vez de uma região de digitalização personalizada, o que é adequado para aplicações comerciais onde apontar e capturar é suficiente. O tutorial sobre o leitor de código de barras .NET MAUI aborda o padrão de integração MAUI completo para dispositivos iOS e Android , incluindo o gerenciamento de permissões e a configuração do projeto.

Abordagem Scanbot

A Scanbot opera com um modelo de taxa fixa anual. O custo anual da licença não é medido pelo volume de escaneamentos. Isso proporciona um orçamento anual previsível para equipes com implantações estáveis ​​exclusivamente em dispositivos móveis. Para obter o preço exato, é necessário entrar em contato com a equipe de vendas da Scanbot; Os dados publicados não estão disponíveis. A obrigação de renovação anual significa que a licença representa um custo operacional contínuo.

Abordagem do IronBarcode

O IronBarcode é vendido como uma compra única perpétua em quatro níveis: Lite por US$ 749, Plus por US$ 1.499, Professional por US$ 2.999 e Unlimited por US$ 5.999. Não há necessidade de renovação anual para o uso contínuo da versão adquirida. As atualizações de software durante o período de licença estão incluídas. Os preços são publicados no site da Iron Software, sem necessidade de uma conversa com um vendedor.

Processamento do lado do servidor e do backend

Um aplicativo móvel desenvolvido com o Scanbot geralmente existe em conjunto com um componente do lado do servidor que lida com uploads de documentos, trabalhos em lote ou endpoints de API. Quando esse componente do lado do servidor precisa de processamento de código de barras — extrair códigos de barras de PDFs carregados, validar valores de código de barras em documentos recebidos ou processar dados de código de barras de anexos de imagem — o Scanbot não está disponível. O pacote não compila em ASP.NET Core, Azure Functions, aplicativos de console ou qualquer projeto que não seja MAUI. Nessa situação, as equipes se veem obrigadas a manter uma dependência de código de barras para dispositivos móveis, além de uma solução separada de código de barras para servidores, ou a avaliar se o IronBarcode pode abranger ambas as funções em um único pacote.

Requisitos de aplicativos para desktop

A proposta de valor do MAUI reside frequentemente na sua abrangência multiplataforma: uma única base de código que abrange iOS, Android e Windows. Quando o alvo MAUI do Windows entra no roteiro — seja a partir de requisitos iniciais ou como uma adição posterior — o pacote ScanbotBarcodeSDK.MAUI falha ao resolver nesse alvo, porque o Scanbot cobre o Windows através de um pacote separado UWP/WinUI 3 (Scanbot.BarcodeSDK.Windows) em vez de através do MAUI Windows. Equipes que desejam um único caminho de construção do Windows dentro de um projeto MAUI com vários alvos, ou que precisam de um componente Windows sem interface (como um Serviço do Windows), não terão isso do conjunto de pacotes do Scanbot.IronBarcode fornece um único pacote que se resolve no alvo MAUI do Windows e também roda em contextos de desktop sem interface e servidor.

Fluxos de trabalho de PDF e documentos

Aplicações que migram da digitalização em tempo real para a automação de documentos encontram um limite de capacidade com o Scanbot. Ler códigos de barras de uma fatura em PDF, extrair códigos de rastreamento de uma imagem digitalizada de etiqueta de remessa ou processar dados de código de barras de um documento arquivado situam-se fora do modelo de entrada do Scanbot, que é construído em torno de um fluxo de câmera ao vivo. O IronBarcode lida com todas essas entradas baseadas em arquivos de forma nativa. O mesmo pacote que é executado no aplicativo móvel MAUI pode extrair códigos de barras de documentos PDF em um processo em segundo plano, sem quaisquer dependências adicionais.

Custos de licenciamento previsíveis

Os custos anuais de renovação exigem uma reavaliação a cada ciclo de renovação. Equipes que começaram a usar o Scanbot em uma implantação móvel de pequena escala e expandiram para uma implantação mais ampla com mais usuários ou plataformas podem achar a taxa anual menos vantajosa à medida que o escopo aumenta. O modelo de licença perpétua única da IronBarcode elimina a obrigação de renovação. As equipes que realizam avaliações de renovação de licenças frequentemente consideram se uma compra única se alinha melhor com seu planejamento de custos a longo prazo, principalmente quando o escopo expandido do projeto inclui plataformas de servidor ou desktop que, de qualquer forma, não estão cobertas pelo Scanbot.

Não há equivalente ao visor ao vivo.

O visor de câmera em tempo real do Scanbot — com sobreposição da região de digitalização, detecção contínua e feedback tátil — não tem equivalente direto no IronBarcode. O padrão de substituição usa o MediaPicker.CapturePhotoAsync() do MAUI para abrir a câmera do sistema, capturar uma foto e retornar a imagem para processamento. A experiência do usuário consiste em um fluxo de captura de fotos, e não em um fluxo contínuo de digitalização. Para aplicações comerciais (inventário, logística, processamento de documentos), essa distinção raramente é significativa. Para aplicativos voltados ao consumidor, nos quais a sobreposição em tempo real é fundamental para a experiência do produto, essa é uma diferença genuína na experiência do usuário que deve ser avaliada antes de se comprometer com a migração.

Padrão de retorno de chamada de evento para retorno direto

O ScanbotSDKMain.Barcode.StartScannerAsync() do Scanbot é assíncrono e retorna um resultado com um indicador IsSuccess e uma coleção Value.Items. O BarcodeReader.Read() do IronBarcode retorna uma coleção diretamente — não há um objeto wrapper com um campo de status. A verificação de sucesso muda de result.IsSuccess para results.Any() ou uma verificação de nulo em results.FirstOrDefault().

Alterar o namespace do Enum Formatar

O enum BarcodeFormat do Scanbot (por exemplo, BarcodeFormat.Code128) e o enum BarcodeEncoding do IronBarcode(por exemplo, BarcodeEncoding.Code128) contêm membros semelhantes, mas são tipos diferentes em espaços de nomes diferentes. O código que armazena ou compara valores de formato por tipo enum requer que a referência de tipo seja atualizada. Comparações de strings baseadas na saída de .ToString() são geralmente compatíveis, uma vez que os nomes dos membros são semelhantes, mas comparações de tipos explícitas de enum requerem atualização para valores BarcodeEncoding.

Adições de compilação do Windows

Se o pacote Scanbot estava causando falhas na compilação do MAUI do Windows antes da migração, removê-lo resolve esses problemas. Após adicionar o IronBarcode, verifique se os recursos específicos do Windows — caixas de diálogo de seleção de arquivos, caminhos de arquivos locais, permissões do Windows — são tratados adequadamente no código do aplicativo MAUI, uma vez que estes diferem dos padrões de acesso a arquivos do iOS e do Android.