数据捕获上下文管道

所有 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

有关从 PDF 中读取条形码的完整指南，包括页面范围选择和多条形码提取选项， IronBarcode文档涵盖了 PDF 处理场景的全部内容。

斯堪迪特方法

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代码出于性能原因限制符号系统，可以通过BarcodeReaderOptions.ExpectBarcodeTypes在IronBarcode中实现相应优化，但这不需要作为起始条件。