Live-Kamera-Scanmuster

Das gesamte API-Muster BarcodeScanning.Native.Maui ist ein XAML-Steuerelement in Kombination mit einem C#-Ereignishandler:

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Dieses Steuerelement bietet Benutzern einen in die MAUI-Seite integrierten Echtzeit-Sucher. Die Barcode-Erkennung wird kontinuierlich ausgelöst, solange der Kamera-Feed aktiv ist. Die UX ist gut geeignet für Verbraucher-Apps, bei denen "point and scan" die primäre Interaktion ist. Die Einschränkung ist, dass dies die einzige Interaktion ist, die die Bibliothek unterstützt — Anforderungen, die über die Live-Kamera-Erkennung in einem MAUI-Kontext hinausgehen, fallen außerhalb ihres Anwendungsbereichs.

Detaillierter Funktionsvergleich

Barcode-Scanning.MAUI-Ansatz

BarcodeScanning.Native.Maui kapselt die native Kameraerkennungspipeline auf jeder Plattform. Auf Android verarbeitet ML Kit Frames; auf iOS und macOS verarbeitet das Apple Vision-Framework Frames; auf Windows verarbeitet ZXingCpp Frames. Die Bibliothek stellt dies als MAUI CameraView-Steuerelement mit einem OnDetectionFinished-Ereignis bereit. Der Anwendungscode verarbeitet niemals direkt Bildbytes – er verarbeitet ausschließlich die erkannten Barcodewerte, die sich aus dem Ereignis ergeben.

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

Die Konsequenz dieser Konstruktion ist, dass es keinen anderen Zugangspunkt gibt. Die Kamera ist nicht optional – sie ist die einzige Eingabe, die die Bibliothek kennt. Ein Server, eine Datei, ein PDF oder ein nicht-MAUI-Host hat keinen Zugang zur Bibliothek.

IronBarcode Ansatz

IronBarcode erhält Bilddaten über seine BarcodeReader.Read()-statische Methode. Der Aufrufer liefert die Daten – aus beliebiger Quelle – und die Bibliothek dekodiert sie. Auf MAUI stammen die Daten von MediaPicker; Auf einem Server stammt es aus einem Formular-Upload; Bei einer Desktop-Anwendung stammt es aus einem Dateidialog.

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

Private Async Sub ScanBarcodeButton_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
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

Dieser Code läuft identisch über die MAUI-Ziele, die ein Bild aufnehmen können. Für den Serverseitigen Gebrauch akzeptiert dieselbe BarcodeReader.Read()-Methode das Byte-Array einer hochgeladenen Datei oder einen PDF-Pfad. Die IronBarcode Dokumentation umfasst alle unterstützten Eingabetypen.

Barcode-Scanning.MAUI-Ansatz

BarcodeScanning.Native.Maui unterstützt alle vier MAUI-Ziele (iOS, Android, Windows seit 3.0.1, und macOS Catalyst), aber jedes Ziel verwendet eine andere Erkennungs-Engine: Apple Vision auf iOS und macOS, Google ML Kit auf Android und ZXingCpp auf Windows. Die Symbologieabdeckung und das Dekodierverhalten unterscheiden sich zwischen den drei Engines, sodass ein Barcode, der auf einer Plattform zuverlässig dekodiert wird, auf einer anderen anders funktionieren kann. Außerhalb von MAUI — ASP.NET, Konsole, WPF, WinForms, Blazor Server, Azure Functions — hat die Bibliothek keine Implementierung. Teams, die Barcode-Logik sowohl in einer MAUI-App als auch in einem Backend-Service benötigen, müssen eine andere Bibliothek für den nicht-MAUI-Code verwenden.

IronBarcode Ansatz

Der BarcodeReader.Read()-Aufruf von IronBarcode verwendet dieselbe verwaltete Engine auf jedem unterstützten Ziel, sodass sich das Verhalten über Windows, Linux, macOS, ASP.NET und jedes MAUI-Ziel, das ein Bild aufnehmen und dem Leser übergeben kann, konsistent verhält. Es gibt keine #if WINDOWS-Blöcke, keine bedingte Abhängigkeitsladung und keine Stummelausumsetzungen. Auch bei Datei- und PDF-Eingaben ist das Muster einheitlich:

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

Der IronBarcode MAUI-Integrationsleitfaden enthält vollständige Einrichtungsanweisungen für alle MAUI-Ziele. IronBarcode unterstützt auch die serverseitige Bereitstellung in ASP.NET, Docker-, Azure Functions- und AWS Lambda-Umgebungen, in denen BarcodeScanning.Native.Maui überhaupt keinen Pfad hat.

Barcode-Scanning.MAUI-Ansatz

Unter iOS kann BarcodeScanning.Native.Maui's zugrundeliegende Erkennung (Apple Vision) 13 Ziffern für UPC-A-Barcodes zurückgeben. UPC-A ist ein 12-stelliges Format; Die zusätzliche führende Null entspricht der EAN-13-Codierung. Die Bibliothek gibt diesen Rohwert durch, und Anwendungen normalisieren ihn nach Bedarf. Anwendungen, die UPC-A-Werte ohne Normalisierung in einer Datenbank speichern, können Datensätze mit einer führenden Null anhäufen.

Die dokumentierte Umgehung prüft das Format und kürzt den Wert:

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

' Normalize iOS UPC-A — strip the leading zero when present
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormats.Upca AndAlso value.Length = 13 Then
        value = value.Substring(1)
    End If

    ProcessBarcode(value)
End Sub

Der Formatcheck ist notwendig, damit EAN-13-Werte, die mit 0 beginnen, nicht fälschlicherweise gekürzt werden. PDF417 wird separat in GitHub-Issues als "sehr problematisch - die meisten Scans erfolgen nie" auf den iOS/Android-Engines dokumentiert, was für Versandetiketten, Führerscheine und Bordkarten relevant ist.

IronBarcode Ansatz

IronBarcode gibt den standardmäßigen 12-stelligen UPC-A-Wert über seine verwaltete Engine zurück. PDF417 ist ein unterstütztes Format. Die Generierungsseite ist ebenfalls über die API von IronBarcode verfügbar:

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Für Anwendungen, bei denen die Genauigkeit der Barcode-Daten unmittelbar Auswirkungen auf Inventursuchen, POS-Transaktionen oder Lieferkettenintegrationen hat, reduziert IronBarcodes konsistente Formathandhabung den Bedarf an plattformspezifischer Normalisierung. Die IronBarcode Dokumentation zum Barcode-Lesen beschreibt das formatspezifische Verhalten im Detail.

Konsistenz der plattformübergreifenden Engine wird zur Anforderung

MAUI-Anwendungen, die auf iOS, Android, Windows und macOS abzielen, greifen auf drei verschiedene Erkennungs-Engines zu, wenn sie BarcodeScanning.Native.Maui verwenden: Apple Vision (iOS/macOS), Google ML Kit (Android) und ZXingCpp (Windows). Jede Engine hat ihre eigene Abdeckung der Symbologie und ihr eigenes Dekodierungsverhalten, sodass derselbe Barcode auf verschiedenen Plattformen unterschiedlich dekodiert werden kann — und Anwendungen fügen oft Normalisierungsschichten hinzu, um die Unterschiede zu überbrücken. Wenn dieser Wartungsaufwand zunimmt oder wenn QA plattformübergreifende Regressionen meldet, die mit Unterschieden in den Engines verbunden sind, migrieren Teams manchmal die Barcode-Schicht zu einer einzigen verwalteten Engine, die sich auf jedem Ziel gleich verhält.

Anforderungen für Datei-Upload oder PDF-Verarbeitung hinzugefügt

Mobile Anwendungen beginnen oft mit Live-Kamera-Scannen als einziger Eingabemethode und erweitern sich später um die Möglichkeit, hochgeladene Bilder oder Dokumente zu akzeptieren. Wenn ein Benutzer einen Barcode aus einem Foto in der Galerie, aus einem über E-Mail empfangenen Bild oder aus einem PDF mit Versandscheinen oder Bordkarten scannen muss, hat BarcodeScanning.Native.Maui keinen Code-Pfad für diese Eingaben. Teams, die diese Anforderungsgrenze erreichen, stehen vor der Wahl: Entweder eine zweite Barcodelibrary zusammen mit BarcodeScanning.Native.Maui für Datei- und PDF-Eingaben hinzufügen oder zu einer einzigen Library migrieren, die alle Eingabetypen behandelt. Das Verwalten von zwei Barcodepaketen mit unterschiedlichen APIs und Ergebnistypen erhöht langfristig die Komplexität, die eine Ein-Paket-Lösung vermeidet.

Einführung der serverseitigen Barcode-Verarbeitung

Anwendungen, die Barcodes auf Mobilgeräten scannen, entwickeln häufig eine serverseitige Komponente – einen ASP.NET -API-Endpunkt, der Barcodes validiert, einen Hintergrundprozess, der PDFs verarbeitet, oder eine Cloud-Funktion, die Trackingnummern aus hochgeladenen Dokumenten extrahiert. BarcodeScanning.Native.Maui ist eine MAUI UI Kontrollbibliothek; es hat keine serverseitige Implementierung. Ein Team, das dieselbe Barcode-Leselogik sowohl auf Mobilgeräten als auch auf Servern benötigt, muss für die Serverseite eine andere Bibliothek verwenden. Sobald diese Serveranforderung gestellt wird, prüfen Teams häufig, ob die Konsolidierung auf eine einzige Bibliothek, die sowohl Mobilgeräte als auch Server abdeckt, der Pflege zweier separater Implementierungen vorzuziehen ist.

UPC-A-Daten-Normalisierung wird zu einem Anliegen

Das 13-stellige Verhalten des iOS UPC-A wird während der Entwicklung nicht immer erkannt. In der Entwicklung gescannte UPC-A-Barcodes scheinen korrekt zu funktionieren, aber die führende Null aus Apples Vision-Framework kann in der Datenbank erscheinen, wenn die Normalisierung fehlt. Teams, die 13-stellige UPC-A-Werte in Inventaraufzeichnungen, POS-Systemen oder Lieferkettenintegrationen entdecken, benötigen möglicherweise sowohl eine Codekorrektur als auch einen Datenkorrekturschritt. Das Hinzufügen der dokumentierten Normalisierung behandelt neue Scans; die Migration zu einer Bibliothek mit konsistenter UPC-A-Ausgabe wird manchmal als langfristige Lösung bevorzugt.

PDF417 Dokumentenscannen erforderlich

PDF417 ist das Barcode-Format, das in Nordamerika für Versandetiketten, Führerscheine und Bordkarten verwendet wird. Dies sind gängige Scanziele für Logistik-, Identitätsprüfungs- und Reiseanwendungen. BarcodeScanning.Native.Maui's GitHub-Issue-Tracker dokumentiert PDF417 als "sehr problematisch - die meisten Scans erfolgen nie" auf den iOS/Android-Engines. Für Anwendungen, bei denen die Zuverlässigkeit von PDF417 eine funktionale Anforderung ist, evaluieren Teams oft alternative Libraries.

Kameraereignis an MediaPicker und statisches Lesen

Die Kernstrukturänderung bei der Migration ist das Ersetzen des kontinuierlichen Kameraveranstaltungsmusters durch eine MediaPicker-Aufnahme gefolgt von BarcodeReader.Read(). Der OnDetectionFinished-Ereignishandler, das CameraView-XAML-Steuerelement und die scanner:-XML-Namensraumdeklaration werden alle entfernt. Stattdessen löst ein Button MediaPicker.CapturePhotoAsync() aus, und die resultierenden Foto-Bytes werden an BarcodeReader.Read() übergeben. Dadurch ändert sich das Benutzererlebnis von einem kontinuierlichen Live-Sucher zu einem Systemkamerabildschirm – was für die meisten Geschäftsanwendungen geeignet ist.

Änderungen am Thread-Marshalling

BarcodeScanning.Native.Maui löst OnDetectionFinished in einem Hintergrund-Thread aus, sodass alle vorhandenen Handler, die UI-Elemente aktualisieren, ihre Aktualisierungen in MainThread.BeginInvokeOnMainThread() einwickeln. Mit dem MediaPicker + asynchronen Muster, das von IronBarcode verwendet wird, erfolgt die Fortsetzung nach await im aufrufenden Kontext, der typischerweise der Haupt-Thread ist. In den meisten Fällen können die MainThread.BeginInvokeOnMainThread()-Wrapper entfernt werden, was den Code des Ereignishandlers vereinfachen.

UPC-A-Normalisierungs-Entfernung

Jede Codebasis, die das iOS UPC-A-13-stellige Verhalten von BarcodeScanning.Native.Maui behandelte, wird Code enthalten, der BarcodeFormats.Upca überprüft und Substring(1) aufruft, um die führende Null zu entfernen. Dieser Code sollte nach der Migration entfernt werden — IronBarcode gibt den standardmäßigen 12-stelligen Wert zurück, und das Belassen der Normalisierung würde das erste Zeichen von gültigen UPC-A-Lesevorgängen fälschlicherweise entfernen.

MAUI-Berechtigungen

BarcodeScanning.Native.Maui fügt Android und iOS automatisch Kameraberechtigungen zu den Manifesten als Teil seiner Paket-Setups hinzu. Mit IronBarcode, das MediaPicker verwendet, sind die Standard-MAUI-Kameraberechtigungen in AndroidManifest.xml und Info.plist erforderlich — dieselben Berechtigungen, die jede MAUI-App für MediaPicker.CapturePhotoAsync() benötigt. Diese Berechtigungen sind in MAUI-Projekten, die die Kamera für irgendeinen Zweck verwenden, in der Regel bereits vorhanden.