实时摄像头扫描模式

整个 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 页面中的实时取景器。 条形码检测在相机供稿活动时持续触发。对用户体验很适合消费类应用"指向并扫描"为主要交互。 限制是这是库唯一支持的交互—所有在MAUI上下文中超出实时相机检测的需求都不在其范围内。

详细功能对比

条形码扫描.MAUI 方法

BarcodeScanning.Native.Maui 封装了每个平台上的原生摄像头检测流程。 在Android上，ML Kit处理框架； 在iOS和macOS上，Apple的Vision框架处理框架； 在Windows上，ZXingCpp处理框架。 该库将其作为一个MAUI 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 的文档涵盖了所有支持的输入类型。

条形码扫描.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功能—库没有实现。 需要在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 在这些环境中根本没有路径。

条形码扫描.MAUI 方法

在iOS上，BarcodeScanning.Native.Maui的底层检测（Apple Vision）可能会为UPC-A条形码返回13位数字。 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

格式检查是必要的，以便EAN-13以0开头的值不会被错误修剪 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条形码读取文档详细介绍了特定格式的行为。

跨平台引擎一致性成为需求

目标iOS，Android，Windows和macOS的MAUI应用在使用BarcodeScanning.Native.Maui时采用了三种不同的识别引擎：Apple Vision（iOS/macOS）、Google ML Kit（Android）和ZXingCpp（Windows）。 每个引擎都有其自己的符号覆盖和解码行为，因此相同的条形码可能在跨平台上解码不同—且应用常常添加标准化层以掩盖差异。 当维护负担增加时，或者当质量保证报告与引擎差异有关的跨平台回归时，团队有时会将条码层迁移到在每个目标上表现一致的单托管引擎。

新增文件上传或PDF处理要求

移动应用程序通常最初以实时摄像头扫描作为唯一的输入方式，之后才扩展到接受上传的图像或文档。 当用户需要从图库中的照片、通过电子邮件接收的图像或者包含装船单或登机牌的PDF中扫描条形码时，BarcodeScanning.Native.Maui没有针对这些输入的代码路径。 达到此需求边界的团队面临选择：在BarcodeScanning.Native.Maui旁添加第二个条形码库用于文件和PDF输入，或者迁移到处理所有输入类型的单库。管理两个具有不同API和结果类型的条形码包增加了长期复杂性，而单包解决方案则避免了这种情况。

服务器端条形码处理技术推出

在移动设备上扫描条形码的应用程序通常会开发一个服务器端组件——一个用于验证条形码的ASP.NET API 端点、一个用于处理 PDF 的后台作业，或者一个用于从上传的文档中提取跟踪号码的云函数。 BarcodeScanning.Native.Maui是一个MAUI UI控制库; 没有服务器端实现。 如果团队需要在移动端和服务器端使用相同的条形码读取逻辑，则服务器端必须使用不同的库。当出现服务器端需求时，团队通常会评估是使用一个同时涵盖移动端和服务器端的单一库，还是维护两个独立的实现更可取。

UPC-A数据标准化成为关注点

iOS UPC-A 13 位数字的行为并非总能在开发过程中被发现。 在开发中扫描的UPC-A条码可能看似工作正常，但当缺少正常化时，Apple视图框架的前导零可能会显示在数据库中。 发现库存记录、销售点系统或供应链集成中的13位UPC-A值的团队可能需要代码修复和数据更正步骤。添加记录的正常化处理新扫描； 有时更喜欢迁移到输出一致的UPC-A库，作为长期解决方案。

PDF417 文档扫描要求

PDF417 是北美地区用于货运标签、驾驶执照和登机牌的条形码格式。 这些是物流、身份验证和旅游应用中常见的扫描目标。 BarcodeScanning.Native.Maui的GitHub问题跟踪器记录PDF417在iOS/Android引擎上"非常有问题—大多数扫描永不发生"。 对于PDF417可靠性作为功能需求的应用，团队通常评估替代库。

相机事件到媒体选择器和静态读取

迁移中的核心结构变化是将持续的摄像头事件模式替换为BarcodeReader.Read()。 CameraView XAML 控件和scanner: XML 命名空间声明都被移除。 代之以按钮触发BarcodeReader.Read()。 这会将用户体验从实时连续取景器变为系统相机屏幕——适用于大多数商业应用。

线程编组变更

BarcodeScanning.Native.Maui在后台线程上触发MainThread.BeginInvokeOnMainThread()中。 使用IronBarcode的MediaPicker + async模式，await返回后的延续在调用上下文上进行，通常是主线程。 在大多数情况下，可以移除MainThread.BeginInvokeOnMainThread()包装器，简化事件处理程序代码。

UPC-A标准化移除

任何处理BarcodeScanning.Native.Maui的iOS UPC-A 13位行为的代码库都将有代码检查Substring(1)以去除前导零。 在迁移后应移除此代码—IronBarcode返回标准12位值，保留标准化将错误地从有效UPC-A读取中去除第一位。

MAUI权限

BarcodeScanning.Native.Maui在其包设置过程中自动向Android和iOS清单添加摄像头权限。使用IronBarcode采用MediaPicker.CapturePhotoAsync() 需要的权限相同。 在任何使用摄像头的 MAUI 项目中，这些权限通常都已经存在。