巴科德建筑的外观

SDK 的 C/C++ 核心负责处理图像处理。 iOS和Android的包通过平台原生API公开该核心。在.NET上，MAUI和Xamarin插件包装了相同的原生SDK，并公开了BarkoderView控件：

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

这在 MAUI 移动应用程序内工作，与实时摄像头一起。 没有文件重载，没有流重载，没有 PDF 重载，也没有 ASP.NET Core、控制台或桌面项目的等效接口。 本地 iOS 和 Android 代码路径在 Swift、Objective-C、Kotlin 或 Java 中使用相同的组件模型。

使 Barkoder 在信息汇总中占有一席之地的功能是真实的能力。 MatrixSight 和 DeBlur Mode提供专有的损坏恢复技术，可以读取物理损坏、印刷质量差或在光线不足的情况下拍摄的条形码。 多条形码检测功能可同时解码单个摄像头画面中的多个条形码，使仓库工人能够一次扫描整个货架。 DPM（直接零件标记）扫描支持 DataMatrix 和其他格式，包括激光蚀刻和点阵喷丸配置，而大多数通用库都无法很好地处理这些配置。 高密度格式支持包括 PDF417、Aztec 和其他 2D 格式，在移动相机上具有很高的精度。

详细功能对比

条形码 SDK 方法

Barkoder 发布的平台列表包括 iOS 原生 (Swift / Objective-C)、Android 原生 (Kotlin / Java)、React Native、Flutter、Cordova、Capacitor、.NET MAUI、Xamarin 和 Web (WASM)。 专门在.NET上，这映射到Barkoder.Xamarin。 ASP.NET Core、Azure Functions、AWS Lambda、Docker、Linux 服务器、WPF、WinForms、Avalonia 和 Blazor 均不存在。 该SDK的架构是围绕移动设备上的实时摄像头管道构建的。它没有基于文件的输入模式、没有流媒体API、没有批处理路径，也没有服务器端执行模型。

对于 MAUI 或 Xamarin 移动应用程序之外的 .NET 工作 —— 后端 API、工作服务、桌面工具、PDF 文档流水线 —— Barkoder 不提供解决方案。 没有用于服务器使用的异步 API 界面，没有依赖注入集成，没有 Azure 或AWS Lambda支持，也没有 PDF 处理功能。

IronBarcode方法

IronBarcode可通过NuGet使用单个命令进行安装，并在启动时使用许可证密钥进行初始化：

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

该库完全在本地运行——没有网络调用，没有数据传输，没有外部依赖。 它与ASP.NET Core依赖注入集成，支持 async/await，无需修改即可部署到 Docker、Azure Functions 和 AWS Lambda。 有关生产级ASP.NET Core集成，请参阅IronBarcode文档。

条形码 SDK 方法

Barkoder 的 DeBlur 模式会在解码尝试之前应用图像预处理——对比度增强、锐化、旋转校正。 此功能仅在移动摄像头处理流程中运行。该模式在扫描开始前于 SDK 层进行配置，摄像头视频流将持续处理。 没有等效的基于文件的路径。

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

IronBarcode通过ReadingSpeed.ExtremeDetail解决了同样的问题，在尝试解码之前激活了多遍图像分析管道——应用基于ML的损坏恢复、对比度增强、锐化和旋转校正。 这适用于任何文件、流或字节数组输入：

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能处理绝大多数干净或轻微损坏的条码，而且速度更快。 为Balanced失败的情况下——它非常彻底但速度显著较慢。 有关读取复杂条形码的更多指导，请参阅IronBarcode读取文档。

条形码 SDK 方法

Barkoder 的多条形码模式可以从单个相机帧中同时检测和解码多个条形码。 在仓库环境中，一名工人将手机举过货架，一次性接收所有条形码的值。 这是在扫描开始前在 SDK 级别配置的：

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

在.NET服务器端应用程序中，多条形码场景通常涉及一个文档——带有发货跟踪条形码和产品条形码的发票，或者每页包含多个项目的发货清单。 IronBarcode通过ExpectMultipleBarcodes = true处理此问题，并且相同的选项在图像和PDF上效果相同：

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

无需页面提取，无需多次请求，无需每个条形码的网络开销。 PDF 文件可通过一次调用直接读取。 有关多条形码和 PDF 读取的更多信息，请参阅IronBarcode文档。

条形码 SDK 方法

Barkoder 支持对激光蚀刻和点阵标记进行 DPM 配置的 DataMatrix 读取。 该 SDK 还支持 PDF417、Aztec 和其他高密度 2D 格式，在移动摄像头上具有很高的精度。 所有这些操作都在 iOS 或 Android 的相机处理流程中进行：

// 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 不生成 DataMatrix 或任何其他格式的条形码。 这是一个只读 SDK。

IronBarcode方法

IronBarcode可原生读取和生成 DataMatrix 数据。 在读取方面，ReadingSpeed.ExtremeDetail处理激光蚀刻DPM标记的低对比度和粗糙边缘。 在生成方面，BarcodeWriter.CreateBarcode()生成用于零件标签创建的DataMatrix：

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

有关支持的格式和生成选项的完整列表，请参阅IronBarcode条形码生成指南。

MAUI 外的 .NET 项目要求

最常见的场景很简单：开发人员或团队正在构建.NET应用程序（ ASP.NET Core、Windows 服务、控制台工具、桌面应用程序），并在研究过程中遇到了 Barkoder。 他们阅读了MatrixSight、DeBlur和多条码检测，发现这些功能很吸引人，然后发现.NET界面是Barkoder.Xamarin——均仅用于移动摄像头UI。 在这种情况下，各团队并没有放弃 Barkoder； 他们从一开始就为自己的平台找到了合适的工具。 IronBarcode是针对 Barkoder 在移动端所提出的需求而开发的 .NET解决方案。

服务器端条形码处理工作流程

有些团队最初会使用移动扫描应用（例如 Barkoder 或其他移动 SDK）来构建条形码处理工作流程原型，之后需要在服务器端复制或扩展该工作流程。常见的例子包括通过 API 接口处理上传的条形码图像、从文档管理系统中的 PDF 文档读取条形码，或者批量处理扫描的标签存档。 Barkoder 没有服务器端部署模型，因此这些工作流程都无法实现。 IronBarcode使用相同的静态 API 在ASP.NET Core、Azure Functions、Docker 和AWS Lambda中处理所有这些问题。

条形码生成要求

为物流、库存或合规性构建.NET应用程序的团队经常发现，读取条形码只是工作流程的一半。 生成条形码——打印标签、在文档中嵌入二维码、生成运输清单——同样重要。 Barkoder 的设计是只读的； 它没有发电能力。 当项目范围扩展到纯粹的阅读之外时，一个涵盖工作流程两端的库就无需集成第二个依赖项。 IronBarcode通过统一的 API 提供 50 多种格式的读取和生成功能。

PDF文档处理

在.NETEnterprise应用程序中，条形码经常出现在 PDF 文档中——例如发票、装运清单、医疗记录、合规文件等。 Barkoder 对这种工作流程毫无概念； 它专为移动设备上的摄像头输入而设计。需要读取传入 PDF 文档中的条形码、提取条形码数据以用于业务逻辑或验证文档存档中是否存在条形码的团队，需要一个具有原生 PDF 支持的库。 IronBarcode直接从 PDF 读取条形码，无需中间图像提取。

定价和部署可预测性

Barkoder 的移动 SDK 定价围绕移动应用程序和分发模型结构设计 —— 订阅制、每应用程序和每设备层与移动部署相关。 对于其 .NET 工作在 MAUI 或 Xamarin 之外的团队，该定价模型不适用，因为 SDK 不在那里运行。 当IronBarcode是合适的工具时，定价模型是简单明了的：永久许可证，没有每次请求的费用，也没有处理的条形码数量的体积限制。

从移动摄像头输入到基于文件的输入

已经实现了基于 Barkoder 的移动扫描原型，并且需要在.NET中复制该功能的团队会发现，输入模型从相机帧变为文件、流或字节数组。 IronBarcode接受多种形式的数据——文件路径字符串、System.Drawing.Image。 条形码处理逻辑的其他部分都相同：

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

速度与准确性的权衡

当配置时，Barkoder的DeBlur模式始终在移动摄像头循环中运行。IronBarcode通过ReadingSpeed明确地暴露精度与速度的权衡。 对于大多数文件，ReadingSpeed.Balanced是合适的。 对于ExtremeDetail的情况下构建批量处理，以实现性能敏感的工作流。

ASP.NET Core中的异步集成

IronBarcode的BarcodeReader.Read()方法是同步的。 在处理并发请求的ASP.NET Core端点中，将调用包装在Task.Run()中以避免阻塞请求线程：

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

性能格式规范

IronBarcode默认自动检测条形码格式。 对于已知预期格式的高吞吐量场景，指定格式可以减少处理时间，因为它可以消除不匹配的格式测试。 使用BarcodeReaderOptions.ExpectBarcodeTypes在格式预先已知时限制搜索。