CameraBarcodeReaderViewアーキテクチャ

CameraBarcodeReaderViewコントロールはZXing.Net.MAUIの中心的なコンポーネントです。 それはXAMLで宣言され、BarcodeReaderOptionsバインディングを通じて構成されます。 それを使用するすべてのページは、IsDetecting状態を管理する必要があります。

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

<ContentPage xmlns:zxing="clr-namespace:ZXing.Net.Maui.Controls;assembly=ZXing.Net.MAUI.Controls">
    <zxing:CameraBarcodeReaderView
        x:Name="CameraView"
        Options="{Binding ReaderOptions}"
        BarcodesDetected="OnBarcodesDetected" />
</ContentPage>

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // なし IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

// Toggling IsDetecting in lifecycle overrides is the documented pattern
protected override void OnDisappearing()
{
    base.OnDisappearing();
    if (CameraView != null)
        CameraView.IsDetecting = false;  // なし IDisposable on the control
}

protected override void OnAppearing()
{
    base.OnAppearing();
    if (CameraView != null)
        CameraView.IsDetecting = true;
}

' Toggling IsDetecting in lifecycle overrides is the documented pattern
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = False ' なし IDisposable on the control
    End If
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    If CameraView IsNot Nothing Then
        CameraView.IsDetecting = True
    End If
End Sub

ZXing .NET.MAUI アプリケーションのすべてのスキャンページには、このライフサイクル定型文が含まれています。 IsDetectingフラグを通じて手動で管理する必要があることを意味します。

詳細な機能比較

ZXing .NET.MAUI アプローチ

ZXing.Net.MAUI は、iOS および Android のプラットフォームカメラAPIを中心に設計されています。Windows MAUIはバーコード生成のみをサポートしています - カメラスキャンは実装されておらず、公開されたロードマップにはありません。これは、モバイルオペレーティングシステム向けにのみ書かれたプラットフォーム実装のライブカメラビューコントロールを中心にライブラリを構築するというアーキテクチャ選択を反映しています。

net8.0-windows10.0.19041.0をターゲットとしたMAUIプロジェクトは、ZXing.Net.MAUIからバーコードスキャン機能を受け取りません。 Mac Catalyst はターゲットフレームワークリストに存在しますが、そのターゲットでのスキャンは公式には文書化されていません。 モバイル専用ターゲットからプロジェクトを開始し、その後に Windows または macOS の要件を追加するチームは、ZXing.Net.MAUI がそのターゲットでのスキャンをカバーできないことに気づくでしょう。 iOS のサポート自体には注意点があります：GitHub 問題 #260は、iPhone 15 Pro および Pro Max デバイスが、信頼できる検出を妨げるオートフォーカスの問題の影響を受けると文書化しています。

IronBarcodeのアプローチ

IronBarcodeは、同じパッケージとコードパターンで、MAUIのすべてのターゲットフレームワーク（iOS、Android、Windows、macOS）をサポートします。 MediaPicker + MediaPicker.CapturePhotoAsync()はデバイスカメラを呼び出します; Windowsでは、ファイルピッカーにマッピングされます。これはデスクトップ環境において適切な動作です。 プラットフォーム固有のコード、条件付きコンパイル、プラットフォームサービスの登録は一切不要です。

WindowsおよびmacOS向けのMAUIデスクトップバーコードパターンは、モバイルスキャンを処理するパッケージと同じものに含まれています。 Androidデバイスで動作する同じBarcodeReader.Read()呼び出しは、ASP.NET Coreエンドポイント、WinFormsデスクトップアプリケーション、またはAzure Functionでも動作し、APIはデプロイ対象に影響されません。

ZXing .NET.MAUI アプローチ

CameraBarcodeReaderViewはXAMLページに埋め込まれた持続的なカメラコントロールです。 falseに設定されると停止します。 IDisposableパターンを通じてカメラリソースが解放されないことを意味します。 文書化された緩和策として、OnAppearing()でそれを復元することが提案されています：

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

// ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
protected override void OnDisappearing()
{
    base.OnDisappearing();
    CameraView.IsDetecting = false;
}

protected override void OnAppearing()
{
    base.OnAppearing();
    CameraView.IsDetecting = true;
}

' ZXing.Net.MAUI: toggle IsDetecting in page lifecycle overrides
Protected Overrides Sub OnDisappearing()
    MyBase.OnDisappearing()
    CameraView.IsDetecting = False
End Sub

Protected Overrides Sub OnAppearing()
    MyBase.OnAppearing()
    CameraView.IsDetecting = True
End Sub

このパターンは、スキャナーが設置されているすべてのページで繰り返す必要があります。 スキャンページへの頻繁なナビゲーションを行うアプリケーションは、完全に解放されていないカメラリソースを蓄積する可能性があり、GitHub 問題 #164 ではメモリの増加と再び初期化されるカメラのレポートが追跡されています。 iPhone 15 Proのオートフォーカス問題（GitHub問題#260）は、カメラ統合レイヤー内の別の懸念事項であり、カメラビューはバーコードを明確にレンダリングしますが、オートフォーカスシステムがiPhone16,2ハードウェアで検出するのに十分にシャープにロックしません。 文書化された回避策は、ユーザーにデバイスとバーコードとの距離を手動で調整するように指示することです。

IronBarcodeのアプローチ

IronBarcodeは、XAMLレイアウトにカメラコントロールを埋め込んでいません。 代わりに、ユーザーがボタンをタップするとMediaPicker.CapturePhotoAsync()呼び出しがシステムカメラUIを開きます。 システムカメラは、フォーカス、露出、オートフォーカスをそれぞれ独立して処理します。 ユーザーがキャプチャを確認すると、結果として得られたイメージがバイト配列としてBarcodeReader.Read()へ渡されます：

// NuGet: dotnet add package IronBarcode
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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// なし OnAppearing or OnDisappearing needed — no camera state to manage

// NuGet: dotnet add package IronBarcode
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 barcode in results)
        Console.WriteLine($"{barcode.Format}: {barcode.Value}");
}

// なし OnAppearing or OnDisappearing needed — no camera state to manage

Imports IronBarCode
Imports System.IO

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 barcode In results
                Console.WriteLine($"{barcode.Format}: {barcode.Value}")
            Next
        End Using
    End Using
End Sub

' なし OnAppearing or OnDisappearing needed — no camera state to manage

.NET MAUIバーコードスキャナーのチュートリアルでは、 iOSとAndroidの両方の権限設定を含め、このパターンのプロジェクト設定全体を網羅しています。 永続的なカメラビューがないため、解放すべきリソースも、切り替えるべき状態も、ページ間で維持すべきライフサイクルの定型コードもありません。

ZXing .NET.MAUI アプローチ

ZXing .NET.MAUI は、ZXing .NETフォーマット仕様の要件を継承しています。 スキャンが開始される前に、開発者は、検出されるべきBarcodeReaderOptions.Formatsを埋める必要があります。 このリストに含まれていないフォーマットは検出されません。エラーや警告は一切表示されません。

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

// ZXing.Net.MAUI: formats must be declared explicitly
// Formats not listed here are not detected
ReaderOptions = new BarcodeReaderOptions
{
    Formats = BarcodeFormats.QRCode |
              BarcodeFormats.Code128 |
              BarcodeFormats.Ean13 |
              BarcodeFormats.UpcA,
    TryHarder = true,
    AutoRotate = true
};

' ZXing.Net.MAUI: formats must be declared explicitly
' Formats not listed here are not detected
ReaderOptions = New BarcodeReaderOptions With {
    .Formats = BarcodeFormats.QRCode Or
               BarcodeFormats.Code128 Or
               BarcodeFormats.Ean13 Or
               BarcodeFormats.UpcA,
    .TryHarder = True,
    .AutoRotate = True
}

ユーザーがカメラを GS1 データバー、Aztecコード、MaxiCode、またはオプションで宣言されていない形式に向けると、スキャンはエラーを発生することなく結果を返しません。 カメラはバーコードをレンダリングし、結果はアプリケーションに返されません。 管理された環境、つまりすべての商品にCode128ラベルが貼付されている倉庫であれば、これは管理可能である。 バーコード形式が外部サプライヤー、顧客、またはサードパーティシステムによって決定されるデプロイメントでは、フォールバックパスの欠如が繰り返されるサポート問題になります。

IronBarcodeのアプローチ

IronBarcodeは、事前設定なしで、サポートされているすべてのフォーマットを自動的に検出します。 BarcodeReader.Read()は画像を分析し、フォーマットにかかわらず、それが識別したすべてのバーコードの結果を返します。 BarcodeReaderOptionsリストは必要ありません：

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

// IronBarcode: no format specification needed
// All 50+ formats detected automatically
var results = BarcodeReader.Read(imageBytes);
foreach (var barcode in results)
    Console.WriteLine($"{barcode.Format}: {barcode.Value}");

Imports IronBarcode

' IronBarcode: no format specification needed
' All 50+ formats detected automatically
Dim results = BarcodeReader.Read(imageBytes)
For Each barcode In results
    Console.WriteLine($"{barcode.Format}: {barcode.Value}")
Next

単一のフォーマットのみが想定される制御されたシナリオでパフォーマンス調整が必要な場合は、フォーマットヒントをオプションで渡すことができますが、正しい検出のために必須となることはありません。 開発者が想定していなかった形式のバーコードでも、検出されて結果が返されます。

ZXing .NET.MAUI アプローチ

ZXing .NET.MAUIはカメラ制御ライブラリです。 ファイルパス、ストレージから直接渡されるバイト配列、またはPDFドキュメントからバーコードを読み取るためのAPIは提供されていません。 CameraBarcodeReaderViewコントロールはライブカメラフィードを必要とします； ファイルパスを受け取ってバーコードの結果を返す静的メソッドはありません。 アップロードされたPDF、文書管理システム、またはバッチ画像処理キューからバーコードを読み取る必要があるチームは、これらのシナリオでZXing .NET.MAUIを使用することはできず、別のライブラリを導入する必要があります。

IronBarcodeのアプローチ

IronBarcodeは同じBarcodeReader.Read()メソッドを通じて任意のソースからバーコードを読み込みます。 ファイルパス、バイト配列、ストリーム、およびPDFドキュメントを受け付けます。 PDF解析はネイティブ機能です。IronBarcodeは、中間的なラスタライズ処理を経ずにPDFページを直接処理します。

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// Read barcodes from a PDF file
var results = BarcodeReader.Read("invoice.pdf");
foreach (var barcode in results)
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");

// Read from a user-selected file using MAUI FilePicker
var file = await FilePicker.PickAsync();
if (file != null)
{
    var fileResults = BarcodeReader.Read(file.FullPath);
    foreach (var result in fileResults)
        ResultLabel.Text += $"\n{result.Format}: {result.Value}";
}

Imports IronBarCode
Imports Microsoft.Maui.Storage

' Read barcodes from a PDF file
Dim results = BarcodeReader.Read("invoice.pdf")
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

' Read from a user-selected file using MAUI FilePicker
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim fileResults = BarcodeReader.Read(file.FullPath)
    For Each result In fileResults
        ResultLabel.Text &= $"\n{result.Format}: {result.Value}"
    Next
End If

複数ページの文書やページ間で異なるバーコード形式が混在する場合を含む、PDFバーコード読み取りの完全なワークフローについては、 "PDFからバーコードを読み取る"ガイドに記載されています。 これは、ZXing .NET.MAUI のカメラのみのアーキテクチャでは対応できない、出荷請求書、デジタルチケット、文書管理ワークフロー、バッチ処理シナリオを網羅しています。

Windows MAUIの要件

再評価の最も一般的なきっかけは、当初iOSとAndroidのみを対象としていたプロジェクトに、Windows MAUIターゲットを追加することである。 MAUIチームは、モバイルファーストの構築から始め、要件の変化に応じてデスクトップ向けへと拡張していくことが多い。 その拡張が実現した場合、ZXing .NET.MAUIには先行きが全く見えません。Windowsプラットフォームは実装されておらず、公式ロードマップにも掲載されていないからです。開発チームは、Windows上でバーコードスキャンが利用できなくなることを受け入れるか、ライブラリを置き換えるかのどちらかを選択しなければなりません。 交換作業はスキャンパターンの構造的な変更を伴うため、通常、チームはすべてのプラットフォームで同時に変更を実施します。

現行世代ハードウェアとの互換性

iPhone 15 Pro オートフォーカス問題（GitHub 問題 #260）は、生産バーコードスキャナーをiOSユーザーに提供するチームにとって現実的な考慮事項です。 iPhone 15 Pro および Pro Max は、洗練されたアプリケーション体験を期待する消費者セグメントで一般的であり、ユーザーにバーコードからの距離を調整するように求める回避策は、古い iPhone ハードウェアと比較して顕著な UX の退行です。 QAでこの問題に直面するチームや、iPhone 15 Pro ユーザーからのサポート報告を受けるチームは、現在のライブラリにとどまるか、カメラビューフォーカスモデルに影響を受けないアプローチに移行するかの選択を迫られます。

ファイルおよび文書の処理

バーコードスキャンの要件は、ライブカメラによるキャプチャに限定されることはほとんどありません。 在庫スキャナーとして始まったアプリケーションは、アップロードされたPDFからバーコードを読み取ったり、出荷請求書を処理したり、メール添付ファイルからデジタルチケットを処理したりするなど、機能を拡大していくことがよくあります。 ZXing .NET.MAUIには、これらのシナリオに対応するAPIは存在しません。 ファイルやドキュメントからバーコードを読み取るという製品要件がバックログに登録された場合、ZXing .NET.MAUI を使用するチームは、それを処理するための別のライブラリを導入する必要があります。 チームが既にこれらのファイルベースのシナリオのいずれかでIronBarcodeを使用している場合、MAUIカメラのスキャン結果を同じライブラリに統合することは、自然な次のステップとなります。

生産安定性要件

v0.7.4 のプレ1.0 デザイン — パッケージ自体は安定した NuGet リリースである一方 — は、ソフトウェア構成解析、依存性監査、または社内承認プロセスに従っているチームに影響を与えます。 一部のエンタープライズ環境では、製品依存関係に1.0+安定リリース、商業的サポート契約、またはその両方が含まれる必要があります。 ZXing.Net.MAUI はコミュニティによって維持され、プレ1.0であり、内部ツールやプロトタイプに適合しますが、バーコードスキャナーが主要なワークフローであるカスタマーフェーシングアプリケーションではレビューのステップが追加されます。 有料サポート層がないため、重大なバグはコミュニティメンテナの可用性に依存します。

CameraBarcodeReaderView から MediaPicker へのパターン

CameraBarcodeReaderView XAMLコントロールとそのxmlns:zxing名前空間宣言は完全に削除されました。 スキャナービューを含む各XAMLファイルでは、置き換えとしてButtonコントロールが提供されます。 結果がBarcodeReader.Read()の戻り値を直接読み取りに置き換えられました。

ライフサイクル削除を検出しています

CameraView.IsDetectingをトグルするだけの存在意義を持つものはすべて削除できます。 それらのオーバーライドに他のページのライフサイクルロジックが含まれている場合、IsDetecting行が削除され、残りのロジックは維持されます。 IsDetectingに相当するIronBarcodeは存在しないため、ページナビゲーション間で管理する持続的なカメラ状態はありません。

UseBarcodeReader() 登録解除

ZXing.Net.MAUIはbuilder.UseBarcodeReader()呼び出しを必要とします。 IronBarcodeはMauiProgram.cs登録を必要としません。 using ZXing.Net.Maui;名前空間のインポートもパッケージのアンインストールとともに削除されます。