實時相機掃描模式

整個 BarcodeScanning.Native.Maui API 模式是 XAML 控制項搭配 C# 事件處理程式：

<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

該控件為使用者提供嵌入 MAUI 頁面中的實時觀景窗。 條碼檢測在相機饋送活動時不斷觸發。該 UX 非常適合主動檢測型態的消費者應用程式，當中的主要互動為"對準即掃描"。 限制在於這是該庫支持的唯一交互——在 MAUI 環境中超越實時相機檢測的需求都不在其範圍內。

詳細特性比較

BarcodeScanning.MAUI 方法

BarcodeScanning.Native.Maui 封裝了每個平臺上的本地相機檢測管道。 在 Android 上，ML Kit 處理幀； 在 iOS 和 macOS 上，Apple 的 Vision 框架處理幀； 在 Windows 上，ZXingCpp 處理幀。 該庫將其顯示為 MAUI CameraView 控制項搭配 OnDetectionFinished 事件。 應用程式碼永遠不直接處理圖像位元組——它僅處理從事件中產生的檢測條碼值。

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

這一設計的後果是沒有其他入口點。 相機不是可選的——它是該庫所知道的唯一輸入。 伺服器、文件、PDF 或任何非 MAUI 主機都沒有進入該庫的路徑。

IronBarcode方法

IronBarcode 通過其 BarcodeReader.Read() 靜態方法接收圖像資料。 調用者提供資料——來自任何來源——然後由該庫進行解碼。 在 MAUI 上，資料來自 MediaPicker； 在伺服器上，它來自表單上傳； 在桌面應用中，它來自文件對話框。

//IronBarcodein 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;
}

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

'IronBarcode in MAUI: capture a photo, then read barcodes from it
' NuGet: dotnet add package IronBarcode

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

這一程式碼在 MAUI 目標平臺中執行相同，該目標可以捕獲圖像。 對於伺服器端使用，相同的 BarcodeReader.Read() 方法接受上傳文件的位元組陣列或 PDF 路徑。 IronBarcode 文件 涵蓋了所有支持的輸入型別。

BarcodeScanning.MAUI 方法

BarcodeScanning.Native.Maui 支持所有四個 MAUI 目標（iOS、Android、Windows 自 3.0.1 起，和 macOS Catalyst），但每個目標使用不同的識別引擎：iOS 和 macOS 使用 Apple Vision，Android 使用 Google ML Kit，Windows 使用 ZXingCpp。 符號學覆盖和解碼行為因這三個引擎而異，因此在一個平臺上可靠解碼的條碼在另一個平臺可能表現不同。 在 MAUI 之外（ASP.NET、控制台、WPF、WinForms、Blazor 伺服器、Azure Functions）該庫沒有實現。 需要在 MAUI 應用和後台服務中使用條碼邏輯的團隊必須為非 MAUI 程式碼使用不同的庫。

IronBarcode方法

IronBarcode 的 BarcodeReader.Read() 調用在每個支持的目標上使用相同的受管理引擎，因此行為在 Windows、Linux、macOS、ASP.NET 和任何可以捕獲圖像並將其交給讀者的 MAUI 目標中是一致的。 沒有 #if WINDOWS 區塊，沒有条件依赖載入，沒有需要的僅占實現。 對於文件和 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");

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

IronBarcode MAUI 整合指南 提供了所有 MAUI 目標的完整設置說明。IronBarcode也支持在ASP.NET、Docker、Azure Functions 和 AWS Lambda 環境中進行伺服器端部署，在這些環境中 BarcodeScanning.Native.Maui 根本沒有路徑。

BarcodeScanning.MAUI 方法

在 iOS 上，BarcodeScanning.Native.Maui 的底層檢測（Apple Vision）可能會返回 13 位數的 UPC-A 條碼。 UPC-A 是一種 12 位數格式； 多出的一個前導零符合 EAN-13 編碼。 該庫傳遞此原始值，應用程式根據需要進行標準化。 未進行標準化的情況下將 UPC-A 值儲存在資料庫中的應用可能會積累帶有前零的記錄。

文件化的工作區檢查格式並修剪值：

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

格式檢查是必要的，這樣以 0 開頭的 EAN-13 值不會被錯誤修剪。 PDF417 在 GitHub 問題中被單獨記錄為"非常有問題——大多數掃描從未發生"在 iOS/Android 引擎上，這與運送標籤、駕駛執照和登機牌相關。

IronBarcode方法

IronBarcode 通過其受管理引擎返回標準的 12 位 UPC-A 值。PDF417 是支持的格式。 生成方面也通過IronBarcode的 API提供：

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

對於條碼資料精確性直接影響庫存查閱、銷售點交易或供應鏈整合的應用程式，IronBarcode 的一致格式處理減少了平臺特定標準化的需求。 IronBarcode 條碼讀取文件 詳細介紹了具體格式行為。

跨平臺引擎的一致性變成需求

當使用 BarcodeScanning.Native.Maui 時，目標 iOS、Android、Windows 和 macOS 的 MAUI 應用程式拾取三個不同的識別引擎：Apple Vision（iOS/macOS）、Google ML Kit（Android）和 ZXingCpp（Windows）。 每個引擎有自己符號學覆蓋和解碼行為，因此相同條碼可能在各平臺上解碼不同——而應用程式通常會新增標準化層來隱藏差異。 當這一維護工作量增長，或當 QA 報告與引擎差異相關的跨平臺回歸時，團隊有時會將條碼層遷移到在每個目標上都行為一致的單一受管理引擎。

文件上傳或 PDF 處理要求新增

移動應用程式通常以實時相機掃描作為唯一輸入方法開始，然後擴展至接受上傳圖像或文件。 當使用者需要從照片集中掃描條碼，從電子郵件收到的圖像中掃描條碼，或者從包含運送單或登機牌的 PDF 中掃描條碼時，BarcodeScanning.Native.Maui 沒有這些輸入的程式碼路徑。 達到這一需求邊界的團隊面臨一個選擇：在 BarcodeScanning.Native.Maui 旁邊新增第二個條碼庫用於文件和 PDF 輸入，或者遷移到能處理所有輸入型別的單一庫。管理具有不同 API 和結果型別的兩個條碼包增加的長期複雜性是單一包解決方案所避免的。

伺服器端條碼處理已被引入

在移動上掃描條碼的應用程式常常開發一個伺服器端組件——一個驗證條碼的 ASP.NET API 端點、處理 PDFs 的背景作業，或是從上傳文件中提取追蹤號的雲功能。 BarcodeScanning.Native.Maui 是一個 MAUI UI 控制庫； 它沒有伺服器端實現。 在移動和伺服器上需要相同條碼讀取邏輯的團隊必須在伺服器端使用不同的庫。當伺服器端需求來臨時，團隊經常評估將移動和伺服器都涵蓋的單一庫是否比維護兩個獨立的實現更可取。

UPC-A 資料標準化成為關注焦點

iOS 的 UPC-A 13 位行為並不總是在開發時被捕獲。 開發中掃描的 UPC-A 條碼可能看似工作正常，但 Visions 框架中缺少標準化的前導零可能會在資料庫中顯示。 發現庫存記錄、銷售點系統或供應鏈整合中的 13 位 UPC-A 值的團隊可能需要程式碼修正和資料糾正步驟。加入文件化的標準化後處理新的掃描； 有時候偏愛通過一致的 UPC-A 輸出的庫進行長期補救。

PDF417 文件掃瞄需求

PDF417 是北美運送標籤、駕駛執照和登機牌使用的條碼格式。 這些是物流、身份驗證和旅遊應用程式的常見掃描物件。 BarcodeScanning.Native.Maui 的 GitHub 問題跟蹤記錄 PDF417 作為"非常有問題——大多數掃描從未發生"在 iOS/Android 引擎上。 用於 PDF417 可靠性是功能需求的應用程式，團隊通常會評估其他庫。

相機事件轉換為 MediaPicker 和靜態讀取

遷移中的核心結構更改是用 MediaPicker 捕捉後的 BarcodeReader.Read() 取代連續的相機事件模式。 OnDetectionFinished 事件處理器、CameraView XAML 控制項和 scanner: XML 命名空間聲明全部被移除。 取而代之的是一個按鈕觸發 MediaPicker.CapturePhotoAsync()，並將結果照片位元組傳遞給 BarcodeReader.Read()。 這將使用者體驗從實時連續的取景器改為系統相機畫面——適用於大多數商務應用程式。

執行緒編織的變化

BarcodeScanning.Native.Maui在背景執行緒上觸發MainThread.BeginInvokeOnMainThread() 封裝其更新。IronBarcode所使用的 MediaPicker + async 模式中，await 之後的繼續回到呼叫上下文，通常是主執行緒。 在大多數情況下，MainThread.BeginInvokeOnMainThread() 封裝可被移除，簡化事件處理程式程式碼。

UPC-A 標準化移除

任何處理 BarcodeScanning.Native.Maui 的 iOS UPC-A 13 位行為的程式碼基礎將具有檢查 BarcodeFormats.Upca 和調用 Substring(1) 的程式碼，以去除前導零。 這一程式碼應於遷移後被移除——IronBarcode 返回標準的12位值，保持標準化將錯誤地從有效的UPC-A讀取中去掉第一位。

MAUI 許可權限

BarcodeScanning.Native.Maui 在其套件設置中自動將相機許可新增到 Android 和 iOS 應用程式。使用IronBarcode最優化 AndroidManifest.xml 和 Info.plist 中的標準 MAUI 相機許可權都需要有——任何 MAUI 應用需要的相同許可。 這些許可是通常已經存在於任何使用相機的 MAUI 項目中。