攝影管線架構

Scanbot 的架構需要在應用啟動時初始化，然後進行相機驅動的掃描調用。 掃描器方法需要一個 BarcodeScannerScreenConfiguration，因為整個操作是相機驅動的：

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

Imports ScanbotSDK.MAUI
Imports ScanbotSDK.MAUI.Barcode

' In MauiProgram.vb — initialization required before any scan
' ScanbotSDKMain.Initialize(New SdkConfiguration With {
'     .LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
'     .LoggingEnabled = False
' }, builder)

' Configure scanner appearance and behavior
Dim configuration As New BarcodeScannerScreenConfiguration With {
    .UseCase = New SingleScanningMode()
}

' Open full-screen camera scanner — UI takes over the entire screen
Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

If result.IsSuccess Then
    For Each item In result.Value.Items
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}")
    Next
End If

SDK 即時處理影片圖幀，突出顯示檢測到的取景器中的條碼，並在條碼確認或使用者取消時返回。 配置物件控制相機 UI 外觀，而非處理行為。 這就是完整的模式。

詳細特性比較

Scanbot SDK 方法

Scanbot 的架構圍繞原生相機管線構建。呼叫 ScanbotSDKMain.Barcode.StartScannerAsync(configuration) 時，程式庫將控制權交給由裝置的原生相機 API 支援的全螢幕相機體驗，適用於 iOS、Android 或 Windows。 程式庫不斷處理即時影片幀，對每幀進行條碼檢測，並在條碼確認或使用者撤銷掃描器時將控制權返回給呼叫應用程式。 在 Scanbot 模型中不存在靜態圖像的概念 — 輸入始終是來自裝置相機的即時影片幀流。

這種設計提供了一種掃描體驗，即時在取景器中突出顯示條碼、可配置掃描區域與比例控制、手電筒切換、音訊和觸覺反饋，以及方向鎖定。 這些是為相機使用情境設計的 UI 功能。 必要條件是程式庫無法與相機硬體和驅動其的作業系統分離。

IronBarcode方法

IronBarcode 接受包含條碼圖像的任何二進制表示，無論圖像是如何獲得的，均使用相同的靜態方法返回解碼結果：

// Install: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

// Install: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' From a file path — works in any project type
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

' From a PDF — reads all barcodes on all pages
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' From a stream — useful for HTTP file uploads
Using stream = File.OpenRead("document.pdf")
    Dim streamResults = BarcodeReader.Read(stream)
End Using

' With processing options
Dim options = New BarcodeReaderOptions With {.Speed = ReadingSpeed.Balanced}
Dim configuredResults = BarcodeReader.Read("image.png", options)

相同的呼叫可在控制台應用、ASP.NET Core 控制器、Azure 函式、WPF 表單或 MAUI 頁面運行。IronBarcode原生讀取 PDF 條碼 — 不是圖像從 PDF 提取出來的，而是直接解析 PDF 結構，並在每頁上尋找條碼。

Scanbot SDK 方法

Scanbot MAUI 套件目標 net9.0-android 和 net9.0-ios。 一個聲明僅這兩個目標的 .NET MAUI Application 專案將成功構建。 然而，當 net9.0-maccatalyst 或Windows MAUI目標新增到 TargetFrameworks 時，在這些目標上 Scanbot MAUI 套件引用無法解析。 這不是配置問題 — MAUI 套件不提供 Windows 或macOS MAUI的集合。 Windows 桌面由單獨的 Scanbot.BarcodeSDK.Windows 套件覆蓋，適用於帶有自動對焦相機的 UWP/WinUI 3 應用程式。

結果是 Scanbot 的 .NET 套件集針對 MAUI 移動和 UWP/WinUI 3 桌面，而不是伺服器或非相機桌面專案型別。

IronBarcode方法

IronBarcode 作為單一 NuGet 套件分發，可正確解析所有 .NET 專案型別和目標框架：

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

針對 Windows 或 macOS 桌面的 MAUI 應用程式，IronBarcode 支援所有四個 MAUI 目標，無需平台條件配寘 構建針對 iOS、Android 和 Windows 的 MAUI 專案的團隊可以一次新增IronBarcode並在所有三個平台上使用 BarcodeReader.Read() 而無需修改。

Scanbot SDK 方法

在針對 iOS 和 Android 的 MAUI 專案中，Scanbot 提供嵌入應用程式導航流中的原生相機取景器。 ScanbotSDKMain.Barcode.StartScannerAsync() 呼叫顯示全屏掃描器，當使用者完成或撤銷掃描時，結果返回到呼叫頁面。 這種整合使移動應用程式的掃描 UI 感覺與平台原生。

當專案擴展時會出現限制。 新增 macOS 目標或Windows MAUI目標將在這些平台上中斷構建（Windows 桌面由適用於 UWP/WinUI 3 應用程式的單獨 Scanbot.BarcodeSDK.Windows 套件處理）。 新增需要條碼處理的無頭伺服器端組件需要單獨的程式庫 — Scanbot 無法跟隨專案進入 ASP.NET Core、Azure 函式或 Docker。

IronBarcode方法

在 MAUI 專案中，IronBarcode 使用平台的 MediaPicker 來捕獲照片，並從生成的圖像中讀取條碼。 掃描工作流程使用系統相機而不是自訂取景器：

// Works on iOS, Android, Windows, andmacOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_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)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

// Works on iOS, Android, Windows, andmacOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_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)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks

Private Async Sub ScanButton_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
                Await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK")
            Next
        End Using
    End Using
End Sub

交易是即時取景器覆蓋。 使用者將看到系統相機 UI，而不是自訂掃描區域，這對於需要"指定並拍攝"即可的商務應用程式來說已經足夠。 .NET MAUI 條碼掃描器教程 涵蓋完整的 MAUI 整合模式，包括許可處理和專案配置，針對 iOS 和 Android 目標

Scanbot 方法

Scanbot 採用年費固定模式運行。 年度授權成本不按掃描量計量。 這為擁有穩定移動裝置部署的團隊提供了可預測的年度預算。 具體定價需聯繫 Scanbot 的銷售團隊； 無法獲取貼出的資料。 年度續約義務意味著該授權是持續的運營成本。

IronBarcode方法

IronBarcode 作為一次性永久購買，提供四個等級：Lite $749、Plus $1,499、Professional $2,999 和 Unlimited $5,999。購買的版本沒有年度續約要求。 授權期間的軟體更新包含在內。 在沒有要求銷售談話的情況下，Iron Software 網站上公佈了定價。

伺服器端和後端處理

using Scanbot 構建的移動應用通常存在於處理文件上傳、批量任務或 API 端點的伺服器端組件旁邊。 當該伺服器端組件需要條碼處理時 — 從上傳的 PDF 中提取條碼、驗證進入文件中的條碼值，或者從圖像附件處理條碼資料 — Scanbot 不可用。 該套件不能在 ASP.NET Core、Azure 函式、控制台應用或任何非 MAUI 專案中編譯。 深處於這種情況的團隊發現自己必須同時維護一個移動條碼依賴項和一個單獨的伺服器端條碼解決方案，或評估IronBarcode是否可以憑借單個包覆蓋兩者角色。

桌面應用要求

MAUI 的價值主張通常是跨平台覆蓋：一個單一程式碼庫，目標 iOS、Android 和 Windows。 當Windows MAUI成為路線圖中的目標 — 無論從初始要求來看，還是作為後期新增項 — ScanbotBarcodeSDK.MAUI 套件無法在該目標上解析，因為 Scanbot 通過一個單獨的 UWP/WinUI 3 套件覆蓋 Windows（Scanbot.BarcodeSDK.Windows），而不是通過 MAUI Windows。 需要一條單一 Windows 構建路徑的團隊，或需要一個無頭 Windows 組件（例如 Windows 服務）的團隊，無法從 Scanbot 的包覆套件中獲得。IronBarcode提供一個包覆，可以在Windows MAUI目標上解析，並在無頭桌面和伺服器環境中運行。

PDF 和文件工作流程

從現場掃描向文件自動化過渡的應用遇到與 Scanbot 的能力邊界。 從 PDF 發票讀取條碼，從掃描的運單標籤圖片中提取追蹤程式碼，或處理來自已存檔文件的條碼資料都超出了 Scanbot 的輸入模型範疇，其圍繞即時相機輸入模型構建。IronBarcode內建地處理所有這些基於文件的輸入。 同一個包載於 MAUI 移動應用程式中的可以在背景處理作業中從 PDF 文件中提取條碼，無需任何其它依賴項。

預測成本授權

每次續約週期會邀請重新評估年度續費成本。 由於小規模移動部署開始並擴展到更廣泛的部署範圍有更多使用者或平台的團隊可能會發現隨著範圍的增長，年度費用變得不再能接受。IronBarcode的一次性永久授權模式消除了續約義務。 進行授權續約評估的團隊通常考慮一次性購買是否與他們的長期預算規劃更匹配，尤其是當擴展的項目範圍包括伺服器端或桌面平台時，而不限於 Scanbot 的範圍。

沒有即時取景器等價

Scanbot 的即時相機取景器 — 帶有掃描區域覆蓋，連續檢測和觸覺回饋 — 在IronBarcode中沒有直接的等值。 替代模式使用 MAUI 的 MediaPicker.CapturePhotoAsync() 來開啟系統相機，拍攝照片並返回其供處理。 使用者體驗是一種照片捕獲流，而不是連續掃描流。 對於業務應用（庫存、物流、文件處理），這種區別很少是顯著的。 對於以即時覆蓋為產品體驗核心的消費者應用，這是一個真正應在加入前予以評估的使用者體驗差異。

事件回調模式到直接返回

Scanbot 的 ScanbotSDKMain.Barcode.StartScannerAsync() 是非同步的，返回一個帶有 IsSuccess 標誌和 Value.Items 集合的結果。IronBarcode的 BarcodeReader.Read() 直接返回一個集合 — 沒有帶有狀態域的包裝物件。 成功檢查從 result.IsSuccess 變為 results.Any() 或對 results.FirstOrDefault() 的 null 檢查。

格式枚舉命名空間更改

Scanbot 的 BarcodeFormat 枚舉（例如，BarcodeFormat.Code128）和IronBarcode的 BarcodeEncoding 枚舉（例如，BarcodeEncoding.Code128）包含類似的成員，但它們是不同名稱空間中的不同型別。 儲存或通過枚舉型別比較格式值的程式碼需要更新型別引用。 基於 .ToString() 輸出的字串比較通常是相容的，因為成員名稱是相似的，但明確的枚舉型別比較需要更新到 BarcodeEncoding 的值。

Windows 建立增強

如果 Scanbot 套件導致Windows MAUI建立失敗，在遷移前移除它可以解決這些故障。 在新增IronBarcode之後，確認 Windows 專用功能 — 文件選擇對話框，本地文件路徑，Windows 許可 — 在 MAUI 應用程式程式碼中得到妥善處理，因為這些與 iOS 和 Android 文件存取模式不同。