バーコダー・アーキテクチャーの外観

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は、物理的に損傷したバーコード、印刷状態が悪いバーコード、または照明条件が悪い状況で撮影されたバーコードを読み取るための独自の損傷回復技術を提供します。 マルチバーコード検出機能は、 1つのカメラフレーム内の複数のバーコードを同時にデコードするため、倉庫作業員は棚全体を一度にスキャンできます。 DPM（ダイレクト・パーツ・マーキング）スキャンは、Razorエッチングやドットピーニング処理された構成における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では特に、それがBarkoder.Xamarinにマップされます。 ASP.NET Core、Azure Functions、AWS Lambda、Docker、Linuxサーバー、WPF、WinForms、Avalonia、Blazorは存在しません。 SDKのアーキテクチャは、モバイルデバイス上のライブカメラパイプラインを中心に構築されています。ファイルベースの入力モード、ストリームAPI、バッチ処理パス、サーバーサイド実行モデルは搭載されていません。

MAUIまたはXamarinモバイルアプリの外で for .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のドキュメントを参照してください。

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を予約してください —これは徹底的ですが、かなり遅いです。 読み取りが難しいバーコードに関する詳細なガイダンスについては、 IronBarcodeの読み取りに関するドキュメントを参照してください。

Barkoder SDKのアプローチ

Barkoderのマルチバーコードモードは、1枚のカメラフレームから複数のバーコードを同時に検出・デコードします。 倉庫の現場では、作業員が棚の上からスマートフォンをかざすと、すべてのバーコード値を一度に受信できる。 これは、スキャン開始前に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サーバーサイドアプリケーションでは、マルチバーコードのシナリオは通常、出荷追跡バーコードと製品バーコードが記載された請求書、または1ページに複数のアイテムが記載された出荷マニフェストなどのドキュメントに関連しています。 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は、Razorエッチングおよびドットピーニングされたマーキングに対応する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がRazorエッチングされた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外で for .NETプロジェクトの要件

最も一般的なシナリオは単純明快です。開発者またはチームが.NETアプリケーション（ ASP.NET Core、Windowsサービス、コンソールツール、デスクトップアプリなど）を構築している際に、調査中にBarkoderに出会うというものです。 彼らはMatrixSight、DeBlur、マルチバーコード検出について読み、その機能を魅力的だと感じ、次に.NETサーフェスがBarkoder.Xamarinであることを発見します — どちらもモバイルカメラUI用のみです。 このような状況にあるチームは、Barkoderから離れることはありません。 彼らは最初から自社のプラットフォームに最適なツールを特定している。 IronBarcodeは、Barkoderがモバイル向けに満たす要件に対する.NETのソリューションです。

サーバーサイドのバーコード処理ワークフロー

一部のチームは、まずモバイルスキャンアプリ（Barkoderやその他のモバイルSDKなど）を使用してバーコード処理ワークフローのプロトタイプを作成し、その後、そのワークフローをサーバー側で再現または拡張する必要が生じます。一般的な例としては、APIエンドポイントを介してアップロードされたバーコード画像を処理する、文書管理システム内のPDF文書からバーコードを読み取る、スキャンされたラベルアーカイブをバッチ処理するなどが挙げられます。 Barkoderにはサーバーサイドのデプロイメントモデルがないため、これらのワークフローはどれも実現できません。 IronBarcodeは、 ASP.NET Core、Azure Functions、Docker、AWS Lambdaといったすべてのプラットフォームで、同じ静的APIを使用してこれら全てに対応します。

バーコード生成要件

物流、在庫管理、コンプライアンス関連 for .NETアプリケーションを開発するチームは、バーコードの読み取りがワークフローの半分に過ぎないことに気づくことが多い。 バーコードの生成（ラベルの印刷、書類へのQRコードの埋め込み、出荷明細書の作成など）も同様に重要です。 Barkoderは設計上、読み取り専用です。 発電能力はありません。 プロジェクトの範囲が単なる閲覧にとどまらず拡大する場合、ワークフローの両側面をカバーするライブラリを使用することで、2つ目の依存関係を統合する必要がなくなります。 IronBarcodeは、一貫したAPIを通じて、50種類以上のフォーマットに対応した読み取りと生成の両方を提供します。

PDF文書処理

.NETEnterpriseアプリケーションでは、請求書、出荷明細書、医療記録、コンプライアンス文書など、PDFドキュメントにバーコードが埋め込まれていることがよくあります。 Barkoderにはこのワークフローの概念がありません。 これはモバイルデバイスのカメラ入力用に設計されています。受信したPDF文書からバーコードを読み取り、ビジネスロジックのためにバーコードデータを抽出し、文書アーカイブ全体でバーコードの存在を確認する必要があるチームは、ネイティブPDFサポートを備えたライブラリを必要とします。 IronBarcodeは、中間的な画像抽出を行うことなく、PDFから直接バーコードを読み取ります。

価格設定と導入の予測可能性

BarkoderのモバイルSDKの価格設定は、モバイルアプリケーションおよび配布モデルに基づいて構成されています—サブスクリプション、アプリごと、およびモバイル展開に結びついたデバイスごとの階層。 MAUIまたはXamarinの外で.NET作業をしているチームにとって、その価格設定モデルは該当しません。なぜなら、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を使用します。