DataCaptureContext管道

每一次Scandit整合都從相機初始化序列開始，然後才能讀取條碼：

// Scandit SDK: full camera pipeline setup
// NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});

var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;

// Scandit SDK: full camera pipeline setup
// NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});

var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;

Imports Scandit.DataCapture.Core.Maui
Imports Scandit.DataCapture.Barcode.Maui

' Scandit SDK: full camera pipeline setup
' NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

Dim dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE")

Dim settings = BarcodeCaptureSettings.Create()
settings.EnableSymbologies(New HashSet(Of Symbology) From {
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
})

Dim barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings)
Dim camera = Camera.GetDefaultCamera()
Await dataCaptureContext.SetFrameSourceAsync(camera)
Await camera.SwitchToDesiredStateAsync(FrameSourceState.On)
barcodeCapture.IsEnabled = True

這個模塊中每一行都用於配置相機基礎設施。 API在這個入口點不暴露文件路徑、PDF或流參數——假設在條碼工作開始前有一台運行的相機。

詳細特性比較

Scandit SDK方法

Scandit實時處理相機幀。BarcodeCapture會監聽每個進入的幀中的條碼。 條碼結果通過BarcodeScanned事件異步交付。 用Scandit讀取靜態圖像文件需要調整相機管道，以將文件視為幀源——這是一個在本地不支援的工作流程，需要相當的工程努力近似。

// Scandit SDK: event-callback result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();
        ProcessBarcode(value, symbology);
    }
};

// Scandit SDK: event-callback result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();
        ProcessBarcode(value, symbology);
    }
};

Imports System

' Scandit SDK: event-callback result delivery
AddHandler barcodeCapture.BarcodeScanned, Sub(sender, args)
    For Each barcode In args.Session.NewlyRecognizedBarcodes
        Dim value As String = barcode.Data
        Dim symbology As String = barcode.Symbology.ToString()
        ProcessBarcode(value, symbology)
    Next
End Sub

事件驅動模型適合於連續即時掃描，條碼在影片流中不可預測地到達。 對於基於文件的處理來說，該模型引入了不必要的複雜性：輸入具有已知的完成界限，相機會話從不自然而然地終止，異步回調模式無法與請求-響應伺服器架構很好地組合。

IronBarcode方法

IronBarcode將每個輸入視為一個獨立的文件，擁有確定的結果。 BarcodeReader.Read方法接受文件路徑、流或位元組陣列，進行同步檢測，並返回結果的集合。 沒有會話要打開，沒有幀源要配置，沒有事件要訂閱。

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

Imports IronBarCode

' IronBarcode: direct file reading
' NuGet: dotnet add package IronBarcode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

對於從圖像讀取條碼，這個無狀態的API除了授權金鑰外不需要初始化。 格式檢測是自動的。 上面的完整程式以三行運行程式碼從圖像文件中讀取任何支援的條碼格式。

Scandit SDK方法

Scandit的架構要求有相機硬體和可以通過本地相機API曝光的移動平台。 iOS和Android是主要的支援目標。 Windows桌面是次要目標。 ASP.NET Core、Azure Functions、Docker容器和Linux伺服器不在程式庫的設計範疇內。 DataCaptureContext假設一個運行的相機會話，這在無伺服器計算環境、容器化部署或背景處理服務中均無對應。

IronBarcode方法

IronBarcode為伺服器、雲端和容器化環境構建。 其無狀態API無需硬體依賴和平台特定的初始化要求。 將Azure Functions用於條碼處理是支援的、有文件路徑的部署方法。 Linux上docker是標準的部署目標。 ASP.NET Core端點從上傳的文件中讀取條碼表示一個核心水支撐的場景而無需架構性變通。

Scandit SDK方法

Scandit的相機管道是為一個單一相機會話服務一個單一使用者或裝置設計的。FrameSourceState模型假設一個持續的相機會話，而不是排隊等待的文件在吞吐量中處理。 將程式庫適應於處理批次文件需要為每個文件模擬一個相機會話或通過共享管道串行化文件處理，這兩者都不是支援或有效的模式。

IronBarcode方法

由於IronBarcode的BarcodeReader.Read方法是無狀態的，它本質上可安全地從多個執行緒同時調用。 併發批次處理無需特殊配置，只需定義BarcodeReaderOptions：

// IronBarcode: concurrent batch processing
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var files = Directory.GetFiles("./incoming/", "*.pdf");
var allResults = new ConcurrentBag<BarcodeResult>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var r in results)
        allResults.Add(r);
});

// IronBarcode: concurrent batch processing
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var files = Directory.GetFiles("./incoming/", "*.pdf");
var allResults = new ConcurrentBag<BarcodeResult>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var r in results)
        allResults.Add(r);
});

Imports System.IO
Imports System.Collections.Concurrent
Imports System.Threading.Tasks

' IronBarcode: concurrent batch processing
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim files = Directory.GetFiles("./incoming/", "*.pdf")
Dim allResults As New ConcurrentBag(Of BarcodeResult)()

Parallel.ForEach(files, Sub(file)
    Dim results = BarcodeReader.Read(file, options)
    For Each r In results
        allResults.Add(r)
    Next
End Sub)

有關異步多執行緒條碼讀取的詳細模式，IronBarcode文件涵盖了執行緒安全模式和吞吐量調整選項。

Scandit SDK方法

Scandit不支持本地PDF。 使用Scandit從PDF中提取條碼需要使用單獨的PDF渲染程式庫將每個PDF頁面渲染為光柵圖像，然後將這些圖像通過相機模擬管道。這種方法增加了額外的依賴性、額外的許可是和對於例行文件處理工作流程的顯著工程努力。 對於多頁文件，需要迭代頁面、為渲染的圖像管理記憶體，並手動協調跨頁面的結果。

IronBarcode方法

IronBarcode本地讀取來自PDF文件的條碼。 帶有PDF文件路徑的參數對於PageNumber屬性，指示文件中的每條條碼所在的頁面：

// IronBarcode: extract barcodes from every page of a PDF
var results = BarcodeReader.Read("shipping-manifest.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

// IronBarcode: extract barcodes from every page of a PDF
var results = BarcodeReader.Read("shipping-manifest.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

Imports IronBarcode

' IronBarcode: extract barcodes from every page of a PDF
Dim results = BarcodeReader.Read("shipping-manifest.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})")
Next

有關從PDFs讀取條碼的完整指南，包括頁範圍選擇和多條碼提取選項，IronBarcode文件涵盖了PDF處理場景的全範圍。

Scandit方法

Scandit不公佈清單價格。 產品頁列出了功能和產品名稱——SparkScan、MatrixScan、ID Scanning、AR Overlays、Parser——並通過銷售會話引導價格查詢。 報價過程通常包括描述使用情景、估計掃描量、指定裝置、討論支援層和選擇合同期限，然後才提供費用數字。 每條Scandit產品線的單獨定價和合同，因此擴展功能存取可能需要額外的銷售周期。

IronBarcode方法

IronBarcode在其產品頁上公佈了許可層級，不需要提交表格或查詢銷售：

許可是永久的。 沒有每次掃描費用，沒有每個裝置的費用，沒有觸發層級變更的數量閾值。 年度續訂是可選的，只有原始成本的一半，但已購買的許可是無需續訂即可保持有效。 單一IronBarcode包中涵盖的所有功能——讀取、生成、PDF支持、多條碼檢測——在每一層中都是可用的。

伺服器端處理要求

建立ASP.NET Core API、背景處理服務或Azure Functions的團隊發現Scandit的架構是圍繞不在伺服器環境中成立的假設構建的。 DataCaptureContext和相機管道需要相機硬體和實時幀源。 當專案的條碼需求完全是伺服器端——從上傳的文件中讀取，處理文件排隊，從傳入的PDF中提取條碼資料——相機管道增加了初始化步驟和平台約束，這與工作負載無關。

批次文件處理

處理大量條碼承載文件的組織——航運清單、發票、庫存記錄、醫療表格——發現Scandit的幀源模型更傾向於連續相機會話，而不是具有確定起點和終點的獨立文件。 當文件體量增長並且併行處理成為必要時，相機管道的有狀態設計需要額外的工程來適應。

定價透明度

工作在預算建議書、供應商比較或新專案成本效益分析上的開發團隊需要銷售會話才能確定Scandit許可是費用。當專案有已定義的預算和已定義的時間表時，需要銷售會話以獲取價格報價增加了評估和計劃的步驟。 同時評估多個程式庫選項的團隊可能會發現缺乏已發佈的定價使得結構化的並排比較變得困難。

減少管道複雜性

即使當Scandit已經部署使用於移動相機掃描時，同一應用中的伺服器端條碼需求可能需要不同的工具。 當應用於靜態文件處理時，針對即時移動掃描的相機管道增加了複雜性。 在達到這一步的團隊通常在現有的Scandit部署旁邊採用IronBarcode進行伺服器端處理，而不是擴展相機管道以涵蓋文件工作流程。

相機管道無文件對應

整個DataCaptureContext初始化塊——上下文建立、設置配置、條碼格式啟用、相機收購、幀源分配和狀態轉換——在IronBarcode的文件導向API中無對應。 在遷移伺服器端整合程式碼時，這個塊被完全刪除。 它不是翻譯； 它是被刪除。 IronBarcode替換是授權金鑰分配後的BarcodeReader.Read調用。

事件回調到直接返回

因為即時相機掃描本質上是異步的，Scandit通過BarcodeScanned事件交付條碼結果。 IronBarcode同步返回結果為類別化集合，因為基於文件的讀取有已知的完成界限。 遷移涉及將事件處理邏輯轉換為標准迭代：

// Scandit callback pattern (removed during migration)
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString());
};

//IronBarcodedirect return (replacement)
foreach (var result in BarcodeReader.Read("document.png"))
    ProcessBarcode(result.Value, result.Format.ToString());

// Scandit callback pattern (removed during migration)
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString());
};

//IronBarcodedirect return (replacement)
foreach (var result in BarcodeReader.Read("document.png"))
    ProcessBarcode(result.Value, result.Format.ToString());

Imports System

' Scandit callback pattern (removed during migration)
AddHandler barcodeCapture.BarcodeScanned, Sub(sender, args)
    For Each barcode In args.Session.NewlyRecognizedBarcodes
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString())
    Next
End Sub

' IronBarcodedirect return (replacement)
For Each result In BarcodeReader.Read("document.png")
    ProcessBarcode(result.Value, result.Format.ToString())
Next

移除條碼格式聲明

Scandit需要在掃描開始前顯式地EnableSymbologies調用。 IronBarcode不需要條碼格式提前聲明——所有格式都是自動檢測的。 在遷移過程中，所有settings.EnableSymbologies(...)調用都被移除。 如果原始的Scandit程式碼是出於性能原因限制條碼格式，相同的優化IronBarcode通過BarcodeReaderOptions.ExpectBarcodeTypes可用，但開始使用它不是必需的。