Die Kamera-Pipeline-Architektur

Die Architektur von Scanbot erfordert eine Initialisierung beim Start der App, gefolgt von einem kameragesteuerten Scanaufruf. Die Scanner-Methode erfordert einen BarcodeScannerScreenConfiguration, da der gesamte Vorgang kameragesteuert ist:

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

Das SDK verarbeitet Live-Videobilder in Echtzeit, hebt erkannte Barcodes im Sucher hervor und gibt eine Rückmeldung, wenn ein Barcode bestätigt wird oder der Benutzer abbricht. Das Konfigurationsobjekt steuert das Erscheinungsbild der Kamera-Benutzeroberfläche, nicht das Verarbeitungsverhalten. Das ist das vollständige Modell.

Detaillierter Funktionsvergleich

Scanbot SDK-Ansatz

Scanbots Architektur basiert auf einer nativen Kamera-Pipeline. Wenn ScanbotSDKMain.Barcode.StartScannerAsync(configuration) aufgerufen wird, übergibt die Bibliothek die Kontrolle an eine Vollbildkamera-Erfahrung, die von den nativen Kamera-APIs des Geräts auf iOS, Android oder Windows betrieben wird. Die Bibliothek verarbeitet kontinuierlich Live-Videobilder, wendet auf jedes Bild eine Barcode-Erkennung an und gibt die Kontrolle an die aufrufende Anwendung zurück, wenn ein Barcode bestätigt wird oder der Benutzer den Scanner abschaltet. Im Scanbot-Modell gibt es kein Konzept eines statischen Bildes – die Eingabe ist immer ein Strom von Live-Videobildern von der Gerätekamera.

Dieses Design erzeugt ein Scan-Erlebnis mit Echtzeit-Barcodes, die im Sucher hervorgehoben werden, konfigurierbarem Scanbereich mit Seitenverhältniskontrolle, Taschenlampenumschaltung, Audio- und haptischem Feedback und Ausrichtungsverriegelung. Dies sind UI-Funktionen, die für den Kameraanwendungsfall gebaut wurden. Der Kompromiss besteht darin, dass die Bibliothek untrennbar mit der Kamerahardware und dem sie steuernden Betriebssystem verbunden ist.

IronBarcode Ansatz

IronBarcode akzeptiert jede binäre Darstellung eines Barcode-haltigen Bildes und gibt dekodierte Ergebnisse über dieselbe statische Methode zurück, unabhängig davon, wie das Bild erzeugt wurde:

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

Derselbe Aufruf wird in einer Konsolenanwendung, einem ASP.NET CoreController, einer Azure-Funktion, einem WPF-Formular oder einer MAUI-Seite ausgeführt. IronBarcode liest Barcodes nativ aus PDFs – nicht als aus PDFs extrahierte Bilder, sondern durch direktes Parsen der PDF-Struktur und Auffinden von Barcodes auf jeder Seite.

Scanbot SDK-Ansatz

Das Scanbot MAUI-Paket zielt auf net9.0-android und net9.0-ios. Ein .NET MAUI Application Projekt, das nur diese beiden Ziele deklariert, wird erfolgreich erstellt. Wenn jedoch net9.0-maccatalyst oder ein Windows MAUI-Ziel zu TargetFrameworks hinzugefügt wird, kann die Scanbot MAUI-Paketreferenz in diesen Zielen nicht aufgelöst werden. Dies ist kein Konfigurationsproblem — das MAUI-Paket bietet keine Assemblies für Windows oder macOS MAUI. Für Windows-Desktops gilt das separate Scanbot.BarcodeSDK.Windows Paket für UWP/WinUI 3-Anwendungen mit Autofokus-Kamera.

Das Ergebnis ist, dass das .NET-Paketset von Scanbot auf MAUI-Mobilgeräte und UWP/WinUI 3-Desktop abzielt, anstatt auf Server oder nicht-kameraorientierte Desktop-Projekttypen.

IronBarcode Ansatz

IronBarcode wird als einzelnes NuGet Paket verteilt, das in allen .NET Projekttypen und Zielframeworks korrekt aufgelöst wird:

# 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

Für MAUI-Anwendungen, die auch Windows- oder macOS-Desktop-Anwendungen anvisieren , unterstützt IronBarcode alle vier MAUI-Ziele über eine einzige Paketreferenz ohne plattformabhängige Konfiguration. Teams, die ein MAUI-Projekt entwickeln, das iOS, Android und Windows als Ziel hat, können IronBarcode einmal hinzufügen und BarcodeReader.Read() auf allen drei Plattformen ohne Modifikation nutzen.

Scanbot SDK-Ansatz

In einem MAUI-Projekt für iOS und Android bietet Scanbot einen nativen Kamera-Sucher, der in den Navigationsablauf der App integriert ist. Der ScanbotSDKMain.Barcode.StartScannerAsync() Aufruf präsentiert den Vollbild-Scanner und das Ergebnis wird an die aufrufende Seite zurückgegeben, wenn der Benutzer den Scan abschließt oder abbricht. Diese Integration verleiht der mobilen Anwendung eine Scan-UI, die sich für die Plattform originär anfühlt.

Die Einschränkung zeigt sich bei der Erweiterung des Projekts. Das Hinzufügen eines macOS- oder eines Windows MAUI-Ziels führt zu einem Build-Fehler auf diesen Plattformen (Windows-Desktops werden stattdessen durch das separate Scanbot.BarcodeSDK.Windows Paket für UWP/WinUI 3-Anwendungen behandelt). Das Hinzufügen einer serverseitigen Komponente, die einen Kopf benötigt und die Barcode-Verarbeitung benötigt, erfordert eine separate Bibliothek — die Scanbot-Abhängigkeit kann dem Projekt nicht in ASP.NET Core, Azure Functionsoder Docker folgen.

IronBarcode Ansatz

In einem MAUI-Projekt arbeitet IronBarcode mit der MediaPicker der Plattform zusammen, um Fotos aufzunehmen und Barcodes aus den resultierenden Bildern zu lesen. Der Scan-Workflow nutzt die Systemkamera anstelle eines benutzerdefinierten Suchers:

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

Der Clou ist die Live-Sucheranzeige. Der Benutzer sieht die Systemkamera-Benutzeroberfläche anstelle eines benutzerdefinierten Scanbereichs, was für Geschäftsanwendungen, bei denen eine einfache Punkt-und-Aufnahme ausreicht, ausreichend ist. Das .NET MAUI Barcode-Scanner-Tutorial behandelt das vollständige MAUI-Integrationsmuster für iOS- und Android -Ziele, einschließlich Berechtigungsverwaltung und Projektkonfiguration.

Scanbot-Ansatz

Scanbot arbeitet mit einem jährlichen Pauschalgebührenmodell. Die jährlichen Lizenzkosten werden nicht nach Scanvolumen bemessen. Dies ermöglicht eine planbare jährliche Budgetierung für Teams mit stabilen, ausschließlich mobilen Anwendungen. Für genaue Preisinformationen wenden Sie sich bitte an das Vertriebsteam von Scanbot. Veröffentlichte Zahlen liegen nicht vor. Die jährliche Verlängerungspflicht bedeutet, dass die Lizenz laufende Betriebskosten verursacht.

IronBarcode Ansatz

IronBarcode wird als einmaliger, unbefristeter Kauf in vier Stufen angeboten: Lite für 749 $, Plus für 1.499 $, Professional für 2.999 $ und Unlimited für 5.999 $. Für die weitere Nutzung der erworbenen Version ist keine jährliche Verlängerung erforderlich. Software-Updates innerhalb der Lizenzlaufzeit sind inbegriffen. Die Preise werden auf der Website von Iron Software veröffentlicht, ohne dass ein Verkaufsgespräch erforderlich ist.

Serverseitige und Backend-Verarbeitung

Eine mit Scanbot erstellte mobile App existiert oft zusammen mit einer serverseitigen Komponente, die Dokumenten-Uploads, Batch-Jobs oder API-Endpunkte verarbeitet. Wenn diese serverseitige Komponente eine Barcode-Verarbeitung benötigt – z. B. das Extrahieren von Barcodes aus hochgeladenen PDFs, das Validieren von Barcode-Werten in eingehenden Dokumenten oder das Verarbeiten von Barcode-Daten aus Bildanhängen –, steht Scanbot nicht zur Verfügung. Das Paket lässt sich weder in ASP.NET Core, Azure Functions, Konsolenanwendungen noch in anderen Nicht-MAUI-Projekten kompilieren. Teams in dieser Situation stehen vor der Wahl, entweder eine Abhängigkeit von mobilen Barcodes zu pflegen und gleichzeitig eine separate serverseitige Barcode-Lösung zu betreiben oder zu prüfen, ob IronBarcode beide Aufgaben mit einem einzigen Paket abdecken kann.

Anforderungen an Desktop-Anwendungen

Das Wertversprechen von MAUI besteht oft in der plattformübergreifenden Abdeckung: eine einzige Codebasis, die auf iOS, Android und Windows abzielt. Wenn das Windows MAUI-Ziel in die Roadmap aufgenommen wird — entweder aus den ersten Anforderungen oder als spätere Ergänzung — kann das ScanbotBarcodeSDK.MAUI Paket auf diesem Ziel nicht aufgelöst werden, da Scanbot Windows mittels eines separaten UWP/WinUI 3 Pakets (Scanbot.BarcodeSDK.Windows) statt über Windows MAUIabdeckt. Teams, die einen einzigen Windows-Build-Pfad innerhalb eines multi-target MAUI-Projekts wollen oder die eine Windows-Komponente ohne Bildschirm (z.B. einen Windows-Dienst) benötigen, bekommen dies nicht aus Scanbots Paketset. IronBarcode liefert ein einzelnes Paket, das auf dem Windows-MAUI-Ziel auflöst und auch in headless-Desktop- und Serverkontexten läuft.

PDF- und Dokumenten-Workflows

Anwendungen, die vom Live-Scannen zur Dokumentenautomatisierung übergehen, stoßen mit Scanbot an eine Leistungsgrenze. Barcodes aus einer PDF-Rechnung lesen, Tracking-Codes aus einem gescannten Versandetikett-Bild extrahieren oder Barcodedaten aus einem archivierten Dokument verarbeiten, liegen außerhalb des Scanbot-Eingabemodells, das auf einen Live-Kamera-Feed aufgebaut ist. IronBarcode verarbeitet all diese dateibasierten Eingaben nativ. Das gleiche Paket, das in der MAUI-Mobil-App läuft, kann Barcodes aus PDF-Dokumenten in einem Hintergrundverarbeitungsjob extrahieren, ohne dass zusätzliche Abhängigkeiten erforderlich sind.

Vorhersehbare Lizenzkosten

Die jährlichen Verlängerungskosten erfordern eine Neubewertung bei jedem Verlängerungszyklus. Teams, die mit Scanbot im Rahmen einer kleinen mobilen Implementierung begonnen und diese auf eine breitere Implementierung mit mehr Benutzern oder Plattformen ausgeweitet haben, finden die jährliche Gebühr möglicherweise weniger günstig, wenn der Umfang wächst. Das Einmal-Dauerlizenzmodell von IronBarcode beseitigt die Verpflichtung zur Erneuerung. Teams, die Evaluierungen zur Lizenzverlängerung durchführen, überlegen oft, ob ein einmaliger Kauf besser zu ihrer langfristigen Kostenplanung passt, insbesondere wenn der erweiterte Projektumfang serverseitige oder Desktop-Plattformen umfasst, die ohnehin nicht von Scanbot abgedeckt werden.

Kein gleichwertiger Live-Sucher

Der Echtzeit-Kamerasucher von Scanbot – mit Scanbereichsüberlagerung, kontinuierlicher Erkennung und haptischem Feedback – hat kein direktes Äquivalent in IronBarcode. Das Ersatzmuster verwendet MAUI's MediaPicker.CapturePhotoAsync(), um die Systemkamera zu öffnen, ein Foto aufzunehmen und das Bild zur Verarbeitung zurückzugeben. Die Benutzererfahrung ist eher ein Fotoaufnahmeprozess als ein kontinuierlicher Scanvorgang. Für Geschäftsanwendungen (Inventur, Logistik, Dokumentenverarbeitung) ist dieser Unterschied selten von Bedeutung. Bei Verbraucher-Apps, bei denen das Live-Overlay ein zentraler Bestandteil des Produkterlebnisses ist, stellt dies einen echten Unterschied in der Benutzererfahrung dar, der vor der Migration bewertet werden sollte.

Ereignis-Callback-Muster zur direkten Rückgabe

Scanbots ScanbotSDKMain.Barcode.StartScannerAsync() ist asynchron und gibt ein Ergebnis mit einer IsSuccess Flag und einer Value.Items Sammlung zurück. IronBarcodes BarcodeReader.Read() gibt direkt eine Sammlung zurück — es gibt kein Wrapper-Objekt mit einem Statusfeld. Die Erfolgskontrolle ändert sich von result.IsSuccess zu results.Any() oder einer Nullüberprüfung auf results.FirstOrDefault().

Format Enum Namespace ändern

Scanbots BarcodeFormat Enum (zum Beispiel, BarcodeFormat.Code128) und IronBarcodes BarcodeEncoding Enum (zum Beispiel, BarcodeEncoding.Code128) enthalten ähnliche Mitglieder, sind aber unterschiedliche Typen in verschiedenen Namespaces. Code, der Formatwerte anhand des Enum-Typs speichert oder vergleicht, erfordert eine Aktualisierung der Typreferenz. String-Vergleiche basierend auf der .ToString() Ausgabe sind in der Regel kompatibel, da die Mitgliedsnamen ähnlich sind, aber explizite Enum-Typ-Vergleiche erfordern eine Aktualisierung auf BarcodeEncoding Werte.

Windows Build-Ergänzungen

Falls das Scanbot-Paket vor der Migration zu Build-Fehlern bei Windows MAUIgeführt hat, behebt dessen Entfernung diese Fehler. Nach dem Hinzufügen von IronBarcode sollten Sie überprüfen, ob Windows-spezifische Funktionen – Dateiauswahldialoge, lokale Dateipfade, Windows-Berechtigungen – im MAUI-App-Code angemessen behandelt werden, da diese sich von den Dateizugriffsmustern von iOS und Android unterscheiden.