Barkoder 架構是什麼樣的

該 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 行動app 中針對即時攝影機運行。 沒有文件超載，沒有資料流超載，沒有PDF超載，也沒有針對ASP.NET Core、控制台或桌面專案的等價表面。 原生 iOS 和 Android 的程式碼路徑使用相同的 Swift、Objective-C、Kotlin 或 Java 組件模型。

那些使 Barkoder 在列表中佔有一席之地的功能是真正的能力。 MatrixSight 和 DeBlur 模式 提供專有的損壞恢復技術，可以讀取物理損壞、印刷不佳或在不良光照下捕獲的條碼。 多條碼檢測 能同時解碼單個攝影機畫面中的多個條碼，使倉庫工人能一次掃描整個貨架。 DPM (直接部分標記) 掃描 支持 DataMatrix 和其他格式的鐳雕和點鑽配置，這些配置大多數一般用途的程式庫處理不佳。 高密度格式支持 包括 PDF417、Aztec 和其他 2D 格式，具有強大的行動攝影機精確度。

詳細特性比較

Barkoder SDK 方法

Barkoder 公佈的平台列表包括 iOS 原生（Swift / Objective-C）、Android 原生（Kotlin / Java）、React Native、Flutter、Cordova、Capacitor、.NET MAUI、Xamarin 和 Web（WASM）。 在 .NET 上具體地映射到 Plugin.Maui.Barkoder 和 Barkoder.Xamarin。 ASP.NET Core、Azure Functions、AWS Lambda、Docker、Linux 伺服器、WPF、WinForms、Avalonia 和 Blazor 缺失。 SDK 的架構建立在移動裝置上的即時攝影機流水線上，沒有基於文件的輸入模式，沒有流 API，沒有批處理路徑，也沒有伺服器端執行模型。

對於不屬於 MAUI 或 Xamarin 行動 app 的 .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 的依賴注入，支持異步/等候，並且可以無修改地部署到 Docker、Azure 函式和 AWS Lambda。 要獲得生產級 ASP.NET Core 整合，請參閱 IronBarcode 文件。

Barkoder 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 處理大多數乾淨或輕微損壞的條碼，速度較快。 保留 ExtremeDetail 用於 Balanced 失敗的情況——它很徹底但顯著較慢。 欲獲得更多有關讀取困難條碼的指導，請參閱 IronBarcode 閱讀文件。

Barkoder 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 文件。

Barkoder SDK 方法

Barkoder 支持 DataMatrix 讀取，帶有鐳雕和點雕標記的 DPM 配置。 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 表面Plugin.Maui.Barkoder 和 Barkoder.Xamarin ——兩者僅適用於行動攝影機 UI。 這種情況下的團隊不是從 Barkoder 遷移； 他們從一開始就識別出適合他們平台的正確工具。IronBarcode是 .NET 回應 Barkoder 在行動裝置上處理需求的答案。

伺服器端條碼處理工作流

一些團隊最初使用行動掃描應用呈現條碼處理工作流原型——Barkoder 或其他移動 SDK——後來需要在伺服器端複製或擴展該工作流。常見的例子包括通過 API 端點處理上傳的條碼圖像，從文件管理系統中的 PDF 文件讀取條碼，或批處理掃描標籤檔案。 這些工作流在 Barkoder 中都無法實現，因為它沒有伺服器端部署模型。IronBarcode使用相同的靜態 API 處理它們，跨越在 ASP.NET Core、Azure 函式、Docker 和 AWS Lambda。

條碼生成需求

構建物流、庫存或合規性 .NET 應用程式的團隊經常發現，讀取條碼僅僅是工作流程的一部分。 生成條碼——列印標籤，在文件中嵌入 QR 程式碼，生成運輸清單——同樣重要。 Barkoder 基於設計是只讀的； 沒有生成能力。 當專案範圍超出純讀取時，一個涵蓋工作流程兩側的相關程式庫消除了整合第二個依賴的需求。IronBarcode通過一致的 API 提供超過50種格式的讀取和生成功能。

PDF 文件處理

在 .NET 企業應用程式中，條碼經常嵌入在 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 是合適的。 對於ReadingSpeed.ExtremeDetail應用完整的多通道 ML 管道。結構化批處理使用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 收窄搜尋。