Wie die Barkoder-Architektur aussieht

Die Bildverarbeitung erfolgt über den C/C++-Kern des SDKs. Die iOS- und Android-Wrapper stellen diesen Kern über plattformnative APIs bereit. Auf .NET binden die MAUI- und Xamarin-Plug-ins dieselben nativen SDKs ein und bieten eine BarkoderView Kontrolle an:

// dotnet add package Plugin.Maui.Barkoder
// XAML hosts a BarkoderView; this is the code-behind callback.
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.SetZoomFactor(1.5f);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
            Console.WriteLine($"Value: {r.TextualData}");
        }
    }
}

// dotnet add package Plugin.Maui.Barkoder
// XAML hosts a BarkoderView; this is the code-behind callback.
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.SetZoomFactor(1.5f);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
            Console.WriteLine($"Value: {r.TextualData}");
        }
    }
}

Imports Barkoder.Maui

Public Partial Class ScanPage
    Inherits ContentPage
    Implements IBarkoderDelegate

    Public Sub New()
        InitializeComponent()
        BarkoderView.SetFlashEnabled(False)
        BarkoderView.SetZoomFactor(1.5F)
        BarkoderView.StartScanning(Me)
    End Sub

    Public Sub DidFinishScanning(result As BarcodeResult()) Implements IBarkoderDelegate.DidFinishScanning
        For Each r In result
            Console.WriteLine($"Type: {r.BarcodeTypeName}")
            Console.WriteLine($"Value: {r.TextualData}")
        Next
    End Sub
End Class

Dies funktioniert innerhalb einer MAUI-Mobil-App gegen eine Live-Kamera. Es gibt keine Dateiüberladung, keine Stream-Überladung, keine PDF-Überladung und keine gleichwertige Oberfläche für ASP.NET Core-, Konsolen- oder Desktop-Projekte. Die nativen iOS- und Android-Codepfade verwenden dasselbe Komponentenmodell in Swift, Objective-C, Kotlin oder Java.

Die Features, die Barkoder einen Platz in den Zusammenfassungen einbringen, sind echte Fähigkeiten. MatrixSight und der DeBlur-Modus bieten eine proprietäre Technologie zur Schadensbehebung, die auch physisch beschädigte, schlecht gedruckte oder unter schlechten Lichtverhältnissen erfasste Barcodes lesen kann. Die Multi-Barcode-Erkennung dekodiert mehrere Barcodes gleichzeitig in einem einzigen Kamerabild und ermöglicht es Lagerarbeitern, ganze Regale auf einmal zu scannen. DPM (Direct Part Marking) Scanning unterstützt DataMatrix und andere Formate in lasergeätzten und punktgehämmerten Konfigurationen, die die meisten Allzweckbibliotheken nicht gut verarbeiten können. Die Unterstützung für hochauflösende Formate umfasst PDF417, aztekisch und andere 2D-Formate mit hoher Genauigkeit auf mobilen Kameras.

Detaillierter Funktionsvergleich

Barkoder SDK-Ansatz

Die veröffentlichte Plattformliste von Barkoder umfasst iOS Native(Swift / Objective-C), Android Native(Kotlin / Java), React Native, Flutter, Cordova, Capacitor, .NET MAUI, Xamarin und Web (WASM). Auf .NET speziell entspricht das Plugin.Maui.Barkoder und Barkoder.Xamarin. ASP.NET Core, Azure Functions, AWS Lambda, Docker, Linux servers, WPF, WinForms, Avalonia, and Blazor are absent. Die Architektur des SDKs basiert auf einer Live-Kamera-Pipeline auf einem Mobilgerät. Es gibt keinen dateibasierten Eingabemodus, keine Stream-API, keinen Batch-Verarbeitungspfad und kein serverseitiges Ausführungsmodell.

Für .NET-Arbeiten außerhalb einer MAUI- oder Xamarin-Mobil-App – eine Backend-API, einen Worker-Service, ein Desktop-Tool, eine PDF-Dokumentenpipeline – bietet Barkoder keinen Weg. Es gibt keine asynchrone API-Oberfläche für die Servernutzung, keine Abhängigkeitsinjektionsintegration, keine Unterstützung für Azure oder AWS Lambdaund keine PDF-Verarbeitungsfunktion.

IronBarcode Ansatz

IronBarcode wird über NuGet mit einem einzigen Befehl installiert und beim Start mit einem Lizenzschlüssel initialisiert:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read a barcode from an image
var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

// Read a barcode from an image
var results = BarcodeReader.Read("scan.png");
foreach (var result in results)
{
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Value: {result.Value}");
}

Imports IronBarCode

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

' Read a barcode from an image
Dim results = BarcodeReader.Read("scan.png")
For Each result In results
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Value: {result.Value}")
Next

Die Bibliothek läuft vollständig lokal – keine Netzwerkaufrufe, keine Datenübertragung, keine externen Abhängigkeiten. Es integriert sich mit der Abhängigkeitsinjektion von ASP.NET Core , unterstützt async/await und lässt sich ohne Änderungen auf Docker, Azure Functionsund AWS Lambdabereitstellen. Für eine produktionsreife ASP.NET Core Integration siehe die IronBarcode Dokumentation .

Barkoder SDK-Ansatz

Der DeBlur-Modus von Barkoder wendet vor dem Dekodierungsversuch eine Bildvorverarbeitung an – Kontrastverbesserung, Schärfung, Rotationskorrektur. Dies funktioniert ausschließlich innerhalb der Verarbeitungskette mobiler Kameras. Der Modus wird auf SDK-Ebene konfiguriert, bevor der Scanvorgang beginnt, und das Kamerabild wird kontinuierlich verarbeitet. Es gibt keinen entsprechenden dateibasierten Pfad.

// dotnet add package Plugin.Maui.Barkoder
// Configured against the BarkoderView in a MAUI ContentPage
BarkoderView.DeblurEnabled = true;
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.Code128 });
BarkoderView.StartScanning(this);

// dotnet add package Plugin.Maui.Barkoder
// Configured against the BarkoderView in a MAUI ContentPage
BarkoderView.DeblurEnabled = true;
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.Code128 });
BarkoderView.StartScanning(this);

IronBarcode Ansatz

IronBarcode löst das gleiche Problem durch ReadingSpeed.ExtremeDetail, welches eine Mehrfachdurchlauf-Bildanalyse-Pipeline aktiviert — einschließlich ML-basierter Schadensbehebung, Kontrastverstärkung, Schärfung und Rotationskorrektur — bevor der Versuch der Dekodierung unternommen wird. Dies funktioniert mit beliebigen Datei-, Datenstrom- oder Byte-Array-Eingaben:

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

Imports IronBarCode

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("worn-shipping-label.png", options)

If results.Any() Then
    Console.WriteLine($"Recovered: {results.First().Value}")
Else
    Console.WriteLine("Could not decode — image quality too low")
End If

ReadingSpeed.Balanced bearbeitet die meisten sauberen oder leicht beschädigten Barcodes und ist schneller. Reservieren Sie ExtremeDetail für Fälle, in denen Balanced fehlschlägt — es ist gründlich aber erheblich langsamer. Weitere Hinweise zum Lesen schwieriger Barcodes finden Sie in der IronBarcode Lesedokumentation .

Barkoder SDK-Ansatz

Der Multi-Barcode-Modus von Barkoder erkennt und dekodiert mehrere Barcodes gleichzeitig aus einem einzigen Kamerabild. In einem Lagerkontext hält ein Arbeiter ein Telefon über ein Regal und empfängt alle Barcode-Werte auf einmal. Dies wird auf SDK-Ebene konfiguriert, bevor der Scanvorgang beginnt:

// Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = true;
BarkoderView.StartScanning(this);

// IBarkoderDelegate callback delivers all decoded codes per frame
public void DidFinishScanning(BarcodeResult[] results)
{
    foreach (var r in results)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

// Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = true;
BarkoderView.StartScanning(this);

// IBarkoderDelegate callback delivers all decoded codes per frame
public void DidFinishScanning(BarcodeResult[] results)
{
    foreach (var r in results)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

' Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = True
BarkoderView.StartScanning(Me)

' IBarkoderDelegate callback delivers all decoded codes per frame
Public Sub DidFinishScanning(results As BarcodeResult())
    For Each r In results
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}")
    Next
End Sub

IronBarcode Ansatz

In serverseitigen .NET -Anwendungen betrifft das Szenario mit mehreren Barcodes typischerweise ein Dokument – ​​eine Rechnung mit einem Sendungsverfolgungs-Barcode und einem Produkt-Barcode oder ein Versandmanifest mit mehreren Artikeln pro Seite. IronBarcode bearbeitet dies mit ExpectMultipleBarcodes = true, und die gleiche Option funktioniert identisch mit Bildern und PDFs:

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
};

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}");
}

Imports IronBarCode

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

' Works on images and PDFs — single method call
Dim results = BarcodeReader.Read("shipping-manifest.pdf", options)

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber} | {barcode.Format} | {barcode.Value}")
Next

Keine Seitenextraktion, keine Mehrfachanfragen, kein Netzwerk-Overhead pro Barcode. Die PDF-Datei wird nativ in einem einzigen Aufruf gelesen. Weitere Informationen zum Lesen mehrerer Barcodes und PDFs finden Sie in der IronBarcode Dokumentation .

Barkoder SDK-Ansatz

Barkoder unterstützt das Lesen von DataMatrix mit DPM-Konfigurationen für lasergeätzte und punktgehämmerte Markierungen. Das SDK unterstützt außerdem PDF417, aztekisch und andere hochauflösende 2D-Formate mit hoher Genauigkeit auf mobilen Kameras. Das alles läuft innerhalb der Kamera-Pipeline auf iOS oder Android ab:

// Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.DataMatrix });
BarkoderView.StartScanning(this);

// Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.DataMatrix });
BarkoderView.StartScanning(this);

' Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(New BarcodeType() { BarcodeType.DataMatrix })
BarkoderView.StartScanning(Me)

Barkoder generiert weder DataMatrix noch ein anderes Barcode-Format. Es handelt sich um ein SDK mit Lesezugriff.

IronBarcode Ansatz

IronBarcode liest und generiert DataMatrix nativ. Auf der Leseseite bearbeitet ReadingSpeed.ExtremeDetail die typischen niedrigen Kontraste und rauen Kanten von lasergravierten DPM-Markierungen. Auf der Erzeugungsseite produziert BarcodeWriter.CreateBarcode() DataMatrix für die Erstellung von Teileetiketten:

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

Imports IronBarCode

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

' Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("part-label.png")

' Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("branded-qr.png")

' Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
Dim results = BarcodeReader.Read("etched-part.png")

Eine vollständige Liste der unterstützten Formate und Generierungsoptionen finden Sie im IronBarcode Barcode-Generierungsleitfaden .

.NET-Projektanforderungen außerhalb von MAUI

Das häufigste Szenario ist einfach: Ein Entwickler oder ein Team erstellt eine .NET Anwendung – ASP.NET Core, einen Windows-Dienst, ein Konsolentool, eine Desktop-App – und stößt dabei auf Barkoder. Sie lesen über MatrixSight, DeBlur und Mehrfach-Barcode-Erkennung, finden die Funktionen überzeugend und entdecken dann, dass die .NET-Oberfläche Plugin.Maui.Barkoder und Barkoder.Xamarin ist — beide nur für mobile Kamera-UI. Teams in dieser Situation migrieren nicht von Barkoder weg; Sie wählen von Anfang an das richtige Werkzeug für ihre Plattform aus. IronBarcode ist die .NET Antwort auf die Anforderungen, die Barkoder auf mobilen Geräten erfüllt.

Serverseitige Barcode-Verarbeitungs-Workflows

Manche Teams entwickeln zunächst einen Prototyp für einen Barcode-Verarbeitungs-Workflow mithilfe einer mobilen Scan-App – beispielsweise Barkoder oder einem anderen mobilen SDK – und müssen diesen Workflow später serverseitig replizieren oder erweitern. Gängige Beispiele hierfür sind die Verarbeitung hochgeladener Barcode-Bilder über einen API-Endpunkt, das Auslesen von Barcodes aus PDF-Dokumenten in einem Dokumentenmanagementsystem oder die Stapelverarbeitung gescannter Etikettenarchive. Keiner dieser Arbeitsabläufe ist mit Barkoder möglich, da es kein serverseitiges Bereitstellungsmodell gibt. IronBarcode verarbeitet sie alle mit der gleichen statischen API über ASP.NET Core, Azure Functions, Docker und AWS Lambdahinweg.

Anforderungen an die Barcode-Generierung

Teams, die .NET Anwendungen für Logistik, Inventarisierung oder Compliance entwickeln, stellen häufig fest, dass das Lesen von Barcodes nur die halbe Miete ist. Die Generierung von Barcodes – das Drucken von Etiketten, das Einbetten von QR-Codes in Dokumente, das Erstellen von Versandmanifesten – ist ebenso wichtig. Barkoder ist von Haus aus schreibgeschützt; Es besitzt keine Stromerzeugungskapazität. Wenn der Umfang eines Projekts über das reine Lesen hinausgeht, macht eine Bibliothek, die beide Seiten des Arbeitsablaufs abdeckt, die Integration einer zweiten Abhängigkeit überflüssig. IronBarcode bietet sowohl das Lesen als auch das Generieren von Barcodes in über 50 Formaten über eine einheitliche API.

PDF-Dokumentverarbeitung

In .NET Enterprise werden Barcodes häufig in PDF-Dokumente eingebettet – Rechnungen, Versandmanifeste, Krankenakten, Compliance-Dokumente. Barkoder hat keine Ahnung von diesem Arbeitsablauf; Es ist für die Kameraeingabe auf Mobilgeräten konzipiert. Teams, die Barcodes aus eingehenden PDF-Dokumenten lesen, Barcode-Daten für Geschäftslogik extrahieren oder das Vorhandensein von Barcodes in Dokumentenarchiven überprüfen müssen, benötigen eine Bibliothek mit nativer PDF-Unterstützung. IronBarcode liest Barcodes direkt aus PDFs, ohne dass eine Zwischenbildextraktion erforderlich ist.

Vorhersagbarkeit von Preisen und Bereitstellung

Die Barkoder-Mobile-SDK-Preise sind um das mobile Anwendungs- und Vertriebsmodell strukturiert – Abonnement, pro App und pro Gerät abgestufte Tarife, die an den mobilen Einsatz gebunden sind. Für Teams, deren .NET-Arbeiten außerhalb von MAUI oder Xamarin liegen, gilt dieses Preismodell nicht, da das SDK dort nicht läuft. Wenn IronBarcode das geeignete Werkzeug ist, ist das Preismodell einfach: eine unbefristete Lizenz ohne pro Anfrage-Gebühren und ohne Volumenbeschränkungen für die Anzahl der verarbeiteten Barcodes.

Von der Eingabe per Mobilkamera zur dateibasierten Eingabe

Teams, die einen auf Barkoder basierenden mobilen Scan-Prototyp implementiert haben und die Funktionalität in .NET replizieren müssen, werden feststellen, dass sich das Eingabemodell von Kamerabildern zu Datei, Stream oder Byte-Array ändert. IronBarcode akzeptiert die gleichen Daten in mehreren Formen — ein Dateipfad-String, ein Stream, ein byte[] oder ein System.Drawing.Image. Die Logik der Barcode-Verarbeitung ist ansonsten identisch:

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

' All of these call the same underlying pipeline
Dim results1 = BarcodeReader.Read("scan.png")
Dim results2 = BarcodeReader.Read(imageStream)
Dim results3 = BarcodeReader.Read(imageBytes)

Geschwindigkeit vs. Genauigkeit – ein Kompromiss

Der DeBlur-Modus von Barkoder ist immer aktiv, wenn konfiguriert, und läuft innerhalb der mobilen Kamera-Schleife. IronBarcode beschreibt den Genauigkeits-gegen-Geschwindigkeit-Kompromiss explizit über ReadingSpeed. Für die meisten Dateien ist ReadingSpeed.Balanced angebracht. Für beschädigte oder verschlechterte Eingaben, die Balanced nicht dekodieren kann, wendet ReadingSpeed.ExtremeDetail die vollständige Mehrfachdurchlauf-ML-Pipeline an. Die Strukturierung der Batch-Verarbeitung, um standardmäßig Balanced zu verwenden und nur bei Ausfällen auf ExtremeDetail zurückzufallen, wird als empfohlener Ansatz für leistungsintensive Arbeitsabläufe angesehen.

Asynchrone Integration in ASP.NET Core

Die BarcodeReader.Read()-Methode von IronBarcode ist synchron. In ASP.NET Core-Endpunkten, die gleichzeitige Anfragen bearbeiten, umwickeln Sie den Aufruf mit Task.Run(), um den Anfrage-Thread nicht zu blockieren:

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

Dim results = Await Task.Run(Function() BarcodeReader.Read(imageBytes, options))

Formatspezifikation für die Leistung

IronBarcode erkennt Barcode-Formate standardmäßig automatisch. Bei Szenarien mit hohem Durchsatz, in denen das erwartete Format bekannt ist, verkürzt die Angabe des Formats die Verarbeitungszeit, da Formatprüfungen, die nicht übereinstimmen, entfallen. Verwenden Sie BarcodeReaderOptions.ExpectBarcodeTypes, um die Suche einzugrenzen, wenn das Format im Voraus bekannt ist.