ライブカメラのスキャンパターン

BarcodeScanning.Native.Maui API パターン全体は、XAML コントロールと C# イベント ハンドラーの組み合わせで構成されています。

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

このコントロールにより、ユーザーはMAUIページに埋め込まれたリアルタイムのビューファインダーを利用できるようになります。 カメラフィードがアクティブな限り、バーコード検出は継続的に発生します。このユーザーエクスペリエンスは、"ポイントしてスキャン"が主なインタラクションである消費者向けアプリに適しています。 このライブラリがサポートする唯一のインタラクションが制約条件です。MAUIコンテキストでのライブカメラ検出を超える要件は、範囲外となります。

詳細な機能比較

バーコードスキャン。MAUIアプローチ

BarcodeScanning.Native.Mauiは、各プラットフォームのネイティブカメラ検出パイプラインをラップします。 Androidでは、MLキットがフレームを処理します; iOSとmacOSでは、AppleのVisionフレームワークがフレームを処理します; Windowsでは、ZXingCppがフレームを処理します。 ライブラリは、MAUI OnDetectionFinishedイベントと共にこれを表面化します。 アプリケーションコードは画像バイトを直接処理することはなく、イベントから得られる検出されたバーコード値のみを処理します。

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

この設計の結果、他に侵入経路は存在しない。 カメラは必須です。図書館が認識する唯一の入力機器です。 サーバー、ファイル、PDF、または任意の非MAUIホストはライブラリに移行するパスがありません。

IronBarcodeのアプローチ

IronBarcodeは、BarcodeReader.Read()静的メソッドを通じて画像データを受け取ります。 呼び出し元はあらゆるソースからデータを提供し、ライブラリがそれをデコードする。 MAUIでは、データはMediaPickerから来ます； サーバー上では、フォームアップロードによって取得されます。 デスクトップアプリケーションでは、ファイルダイアログから取得されます。

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

// IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_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)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO

Private Async Sub ScanBarcodeButton_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
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

このコードは、画像をキャプチャできるMAUIターゲット全体で同じように動作します。 サーバー側で使用する場合、同じBarcodeReader.Read()メソッドはアップロードされたファイルのバイト配列またはPDFパスを受け入れます。 IronBarcodeのドキュメントには、サポートされているすべての入力タイプが記載されています。

バーコードスキャン。MAUIアプローチ

BarcodeScanning.Native.MauiはMAUIターゲットの4つすべて（iOS、Android、Windowsバージョン3.0.1以降、macOS Catalyst）をサポートしていますが、ターゲットごとに異なる認識エンジンを使用します：iOSとmacOSではApple Vision、AndroidではGoogle ML Kit、WindowsではZXingCpp。 3つのエンジン間でシンボロジーカバレッジとデコードの動作が異なるため、あるプラットフォームで信頼性高くデコードされるバーコードが他のプラットフォームで異なる動作をすることがあります。 MAUI以外の環境—ASP.NET、コンソール、WPF、WinForms、Blazorサーバー、Azure Functions—では、ライブラリの実装がありません。 MAUIアプリとバックエンドサービスの両方でバーコードロジックが必要なチームは、非MAUIコード用に異なるライブラリを使用する必要があります。

IronBarcodeのアプローチ

IronBarcodeのBarcodeReader.Read()呼び出しは、すべてサポートされているターゲットで同じマネージドエンジンを使用するため、動作はWindows、Linux、macOS、ASP.NET、そして画像をキャプチャしてリーダーに渡せる任意のMAUIターゲットで一貫しています。 条件付き依存関係の読み込みやスタブ実装は必要なく、#if WINDOWSブロックはありません。 ファイル入力とPDF入力についても、パターンは一貫しています。

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

IronBarcodeのMAUI統合ガイドには、すべてのMAUIターゲットに対する完全なセットアップ手順が記載されています。 IronBarcodeは、BarcodeScanning.Native.MauiにパスがまったくないASP.NET、Docker、Azure Functions、およびAWS Lambda環境でのサーバーサイドデプロイメントもサポートしています。

バーコードスキャン。MAUIアプローチ

iOSでは、BarcodeScanning.Native.Mauiの基盤検出（Apple Vision）はUPC-Aバーコードの13桁を返すことがあります。 UPC-Aは12桁の形式です。 先頭の余分なゼロはEAN-13エンコーディングと一致します。 ライブラリはこの生データをそのまま通し、アプリケーションが必要に応じて正規化します。 データベースで標準化されていない状態でUPC-A値を保存するアプリケーションは、先頭のゼロを含むレコードを蓄積する可能性があります。

ドキュメント化された回避策は、形式をチェックして値をトリムします：

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

' Normalize iOS UPC-A — strip the leading zero when present
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormats.Upca AndAlso value.Length = 13 Then
        value = value.Substring(1)
    End If

    ProcessBarcode(value)
End Sub

形式チェックが必要ですので、0で始まるEAN-13値を誤ってトリムしないようにします。 PDF417はGitHubの問題として"非常に問題が多い－ほとんどのスキャンが発生しない"とiOS/Androidエンジンで分かれて記録されています。これは、出荷ラベル、運転免許証、搭乗券に関連しています。

IronBarcodeのアプローチ

IronBarcodeはその管理エンジンを通じて標準の12桁のUPC-A値を返します。PDF417はサポートされた形式です。 生成側はIronBarcodeのAPIを通じても利用可能です。

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

バーコードデータの正確性が在庫照会、POS取引またはサプライチェーンの統合に直接影響するアプリケーションでは、IronBarcodeの一貫した形式処理により、プラットフォーム固有の標準化が減少します。 IronBarcodeのバーコード読み取りに関するドキュメントでは、フォーマット固有の動作について詳細に解説しています。

クロスプラットフォームエンジンの一貫性が要件となる

iOS、Android、Windows、macOSをターゲットとするMAUIアプリケーションがBarcodeScanning.Native.Mauiを使用する場合、3つの異なる認識エンジンをピックアップします：Apple Vision (iOS/macOS), Google ML Kit (Android), ZXingCpp (Windows)。 各エンジンは独自のシンボロジーカバレッジとデコード動作を持っているので、同じバーコードがプラットフォーム間で異なるデコードを行う可能性があります。そして、アプリケーションはしばしば違いを覆い隠そうと、標準化レイヤーを追加します。 メンテナンスのオーバーヘッドが増えたり、QAがエンジンの違いに結びつけられたクロスプラットフォームの退行を報告したりする場合、チームはバーコードレイヤーを単一の管理されたエンジンに移行して、すべてのターゲットで同じように動作させることがあります。

ファイルアップロードまたはPDF処理の要件が追加されました

モバイルアプリケーションは、多くの場合、入力方法としてライブカメラによるスキャンのみから始まり、後にアップロードされた画像やドキュメントを受け入れるように拡張される。 ギャラリーにある写真から、メールで受け取った画像から、または出荷マニフェストや搭乗券を含むPDFからバーコードをスキャンする必要があるユーザーの場合、BarcodeScanning.Native.Mauiにはこれらの入力のコードパスがありません。 この要件の境界に達したチームは選択を迫られます: ファイルとPDF入力用にBarcodeScanning.Native.Mauiと共に別のバーコードライブラリを追加するか、すべての入力タイプを処理する単一のライブラリに移行するかです。異なるAPIと結果型を持つ2つのバーコードパッケージを管理することは、1つのパッケージソリューションを避ける長期的な複雑性を追加します。

サーバーサイドでのバーコード処理が導入されました

モバイル端末でバーコードをスキャンするアプリケーションは、多くの場合、サーバー側のコンポーネントを開発します。これは、バーコードを検証するASP.NET APIエンドポイント、PDFを処理するバックグラウンドジョブ、またはアップロードされたドキュメントから追跡番号を抽出するクラウド関数などです。 BarcodeScanning.Native.MauiはMAUI UIコントロールライブラリです; サーバーサイドの実装はありません。 モバイルとサーバーの両方で同じバーコード読み取りロジックが必要なチームは、サーバー側で別のライブラリを使用する必要があります。サーバー側の要件が発生すると、チームはモバイルとサーバーの両方をカバーする単一のライブラリに統合する方が、2つの別々の実装を維持するよりも望ましいかどうかを検討することがよくあります。

UPC-Aデータ標準化が関心の対象となる

iOSのUPC-A 13桁の動作は、開発段階で必ずしも検出されるとは限りません。 開発中にスキャンされたUPC-Aバーコードは正常に機能しているように見えるかもしれませんが、AppleのVisionフレームワークからの先頭のゼロが標準化がない場合、データベースに表示されることがあります。 13桁のUPC-A値を在庫記録、POSシステム、またはサプライチェーン統合で発見したチームは、コード修正とデータ修正ステップの両方が必要かもしれません。記録された標準化を追加すると新しいスキャンを処理します; 一貫したUPC-A出力を持つライブラリへの移行は時に長期解決策として好まれます。

PDF417文書のスキャンが必要です

PDF417は、北米において配送ラベル、運転免許証、搭乗券などに使用されているバーコード形式です。 これらは、物流、本人確認、旅行関連のアプリケーションでよくスキャンされる対象です。 BarcodeScanning.Native.MauiのGitHubの問題トラッカーには、PDF417がiOS/Androidエンジンで"非常に問題が多い－ほとんどのスキャンが発生しない"として記録されています。 PDF417の信頼性が機能要件であるアプリケーションの場合、チームはしばしば代替ライブラリを評価します。

カメライベントをMediaPickerと静的読み取りに転送

移行のコアな構造変化は、連続したカメライベントパターンをBarcodeReader.Read()を行うことです。 CameraView XAMLコントロール、およびscanner: XMLネームスペース宣言はすべて削除されます。 それらの代わりに、ボタンがBarcodeReader.Read()に渡されます。 これにより、ユーザーエクスペリエンスはライブビューファインダーからシステムカメラの画面へと変化し、ほとんどのビジネスアプリケーションに適したものとなる。

スレッドマーシャリングの変更点

BarcodeScanning.Native.MauiはバックグラウンドスレッドでMainThread.BeginInvokeOnMainThread()で更新をラップします。 IronBarcodeが使用するMediaPicker + 非同期パターンでは、awaitの後の継続処理が呼び出しコンテキストに戻ります。通常、これはメインスレッドです。 ほとんどの場合、MainThread.BeginInvokeOnMainThread()ラッパーは削除でき、イベントハンドラーコードはシンプルになります。

UPC-A標準化の削除

BarcodeScanning.Native.MauiのiOS UPC-A 13桁の動作を処理したコードベースは、Substring(1)を呼び出して先頭のゼロを削除するコードを持っています。 このコードは移行後に削除する必要があります - IronBarcodeは標準の12桁の値を返し、標準化を保持すると、有効なUPC-A読みの最初の桁を誤って削除することになります。

マウイ島の許可

BarcodeScanning.Native.Mauiはパッケージ設定の一部としてAndroidおよびiOSのマニフェストにカメラの許可を自動的に追加します。IronBarcodeはMediaPicker.CapturePhotoAsync()のために任意のMAUIアプリが必要とするものです。 これらの権限は、カメラを何らかの目的で使用するMAUIプロジェクトには通常既に含まれています。