移植のコンテキスト

ML KitからIronBarcodeに移植する際には、構文だけでなく構造的にもいくつかの点が変わります。

コールバックが戻り値になります。 ML KitはAndroidのTask APIをaddOnFailureListenerと共に使用します。 IronBarcodeのBarcodeReader.Read()はコレクションを同期的に返します。 直接反復処理します。 コールバック登録なし、スレッド調整なし。

スキャナーオブジェクトなし。 ML Kitではscanner.process(inputImage)を呼び出す必要があります。 IronBarcodeは静的メソッドを使用します—BarcodeReader.Read()がエントリーポイントです。 管理または処分すべきインスタンスは存在しません。

InputImageの構築なし。 ML KitのInputImageはAndroid固有のソースから構築する必要があります: InputImage.fromFilePath(context, uri), InputImage.fromBitmap(bitmap, rotation), またはInputImage.fromMediaImage(image, rotation)。 IronBarcodeはファイルパス文字列、Stream, byte[], またはSystem.Drawing.Bitmapを受け入れます。 Androidコンテキストも、URIも、回転メタデータもありません。

Google Playサービスなし。 バンドルされていないML KitモデルはGoogle Playサービスを通じて実行されます。 バンドルされたバリアントは、モデルをAPK内に配信し（約2.4 MB追加）、Playサービスチェックを回避しますが、どちらのバリアントも.NETターゲットでは使用できません。 IronBarcodeにはそのような依存関係はなく、 .NETがサポートするあらゆるプラットフォームで同じように動作します。

.NETでのクイックセットアップ

プロジェクト内にXamarin/MAUI ML Kitのバインディングパッケージが存在する場合はすべて削除してから、 IronBarcodeをインストールしてください。

dotnet add package BarCode

アプリケーション起動時にライセンスキーを追加してください—Program.cs, MauiProgram.cs, またはStartup.csにおいて、アプリタイプに応じて。

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// NuGet: dotnet add package BarCode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

ライセンスは最初のBarcodeWriter.CreateBarcode()呼び出しの前のいつでも設定できます。 無料トライアルをご利用いただけます。 トライアルモードでは透かしによってバーコードが生成されますが、読み取りには影響しません。

バーコードの読み取り：KotlinからC#へ

// Android Kotlin — ML Kit
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_QR_CODE)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        val barcode = barcodes.firstOrNull()
        if (barcode != null) {
            Log.d("MLKit", "Value: ${barcode.rawValue}")
            Log.d("MLKit", "Format: ${barcode.format}")
        }
    }
    .addOnFailureListener { e ->
        Log.e("MLKit", "Scan failed: ${e.message}")
    }

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

using IronBarCode;

try
{
    var results = BarcodeReader.Read("captured-image.jpg");
    var barcode = results.FirstOrDefault();
    if (barcode != null)
    {
        Console.WriteLine($"Value: {barcode.Value}");
        Console.WriteLine($"Format: {barcode.Format}");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Scan failed: {ex.Message}");
}

Imports IronBarCode

Try
    Dim results = BarcodeReader.Read("captured-image.jpg")
    Dim barcode = results.FirstOrDefault()
    If barcode IsNot Nothing Then
        Console.WriteLine($"Value: {barcode.Value}")
        Console.WriteLine($"Format: {barcode.Format}")
    End If
Catch ex As Exception
    Console.WriteLine($"Scan failed: {ex.Message}")
End Try

// Android Kotlin — ML Kit, multiple barcodes
val options = BarcodeScannerOptions.Builder()
    .setBarcodeFormats(Barcode.FORMAT_ALL_FORMATS)
    .build()
val scanner = BarcodeScanning.getClient(options)
val inputImage = InputImage.fromFilePath(context, imageUri)

scanner.process(inputImage)
    .addOnSuccessListener { barcodes ->
        for (barcode in barcodes) {
            val rawValue = barcode.rawValue
            val format = barcode.format
            processBarcode(rawValue, format)
        }
    }
    .addOnFailureListener { e -> Log.e("MLKit", e.message ?: "Unknown error") }

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("warehouse-shelf.jpg", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}");
    ProcessBarcode(barcode.Value, barcode.Format);
}

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("warehouse-shelf.jpg", options)
For Each barcode In results
    Console.WriteLine($"Format: {barcode.Format}, Value: {barcode.Value}")
    ProcessBarcode(barcode.Value, barcode.Format)
Next

フォーマット指定: setBarcodeFormats を BarcodeReaderOptions に設定

ML Kitでは、setBarcodeFormats()を介してどのフォーマットを探すか指定する必要があります。 省略した場合、ML Kitはすべてのフォーマットを検索します。 IronBarcode同様の仕組みで動作します。フォーマット制約を省略するとすべてが検索されますが、想定される型を指定するとパフォーマンスが向上します。

IronBarcodeでフォーマットフラグを使用する方法：

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

using IronBarCode;

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.EAN13
};

var results = BarcodeReader.Read("product-image.jpg", options);

Imports IronBarCode

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128 Or BarcodeEncoding.EAN13
}

Dim results = BarcodeReader.Read("product-image.jpg", options)

ビットごとのOR演算は、ML Kitの可変長引数フォーマットリストと同じように機能します。

結果へのアクセス: rawValue とフォーマット

ML Kitの結果オブジェクトは、Int定数）を公開します。 IronBarcodeの結果は、BarcodeEncoding列挙値）を公開します。

// MLキット Kotlin — result fields
val rawValue: String? = barcode.rawValue
val format: Int = barcode.format
val boundingBox: Rect? = barcode.boundingBox
val displayValue: String? = barcode.displayValue

//IronBarcode C# (IronBarcodeC#)— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

//IronBarcode C# (IronBarcodeC#)— result fields
string value = barcode.Value;
BarcodeEncoding format = barcode.Format;
int page = barcode.PageNumber; // populated for PDF / multi-page input

'IronBarcode VB.NET (IronBarcodeVB.NET)— result fields
Dim value As String = barcode.Value
Dim format As BarcodeEncoding = barcode.Format
Dim page As Integer = barcode.PageNumber ' populated for PDF / multi-page input

IronBarcodeではbarcode.Valueは常にnullでない文字列です—読み取りが成功した場合、値が存在します。 BarcodeEncoding列挙メンバであり、直接比較できます: if (barcode.Format == BarcodeEncoding.QRCode)。

.NETで何が変わったのか

コールバックではなく同期APIを採用。これが最も重要な構造変更点です。 ML KitのTask<List<Barcode>>を返します—リスナーをチェーンします。 IronBarcodeのTask.Run()でラップしてください:

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

using IronBarCode;

// In a MAUI ViewModel or page code-behind
var results = await Task.Run(() => BarcodeReader.Read(imagePath));
foreach (var barcode in results)
{
    // update UI on main thread
    MainThread.BeginInvokeOnMainThread(() =>
    {
        ResultLabel.Text = barcode.Value;
    });
}

Imports IronBarCode
Imports System.Threading.Tasks
Imports Microsoft.Maui.Dispatching

' In a MAUI ViewModel or page code-behind
Dim results = Await Task.Run(Function() BarcodeReader.Read(imagePath))
For Each barcode In results
    ' update UI on main thread
    MainThread.BeginInvokeOnMainThread(Sub()
                                           ResultLabel.Text = barcode.Value
                                       End Sub)
Next

コンテキストパラメータなし。 ML Kitのすべての呼び出しでInputImageを構築するにはAndroid Contextが必要です。 IronBarcodeに必要なのは、ファイルパスまたはストリームのみです。 バーコードロジックからコンテキストスレッド処理を排除することで、コードが大幅に簡素化されます。

Google Play Servicesなし。 標準のML Kitモデルは、Play Servicesを介して実行されます—BarcodeScanning.getClient()は実行時にPlay Servicesの可用性を確認し、利用できない場合はスローします。 IronBarcodeには実行時サービスチェック機能はありません。 画像を読み込むか、標準例外をスローするかのどちらかです。

標準例外処理。 ML KitのExceptionサブクラスを受け取ります。 .NETでは、失敗は標準のSystem.Exceptionスローとして表面化し、通常の方法でtry/catchでキャッチできます。

PDF文書の読み込み

ML KitはPDFをサポートしていません。 URI InputImage.fromFilePath() の場合、Androidのバージョンによっては失敗するか、ラスター画像として最初のページのみを読むかのいずれかです。 文書（請求書処理、物流マニフェスト、フォームスキャンなど）を扱う場合、 IronBarcodeはPDFをネイティブに処理できます。

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

using IronBarCode;

// Read all barcodes from all pages of a PDF
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true
};

var results = BarcodeReader.Read("invoice-batch.pdf", options);
foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}");
}

Imports IronBarCode

' Read all barcodes from all pages of a PDF
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True
}

Dim results = BarcodeReader.Read("invoice-batch.pdf", options)
For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} — {barcode.Value}")
Next

画像抽出ステップなし、サードパーティ製PDFライブラリなし、ページ反復ループと個別レンダリングなし。 PDFファイルのパスを渡すと、すべてのバーコード値とそのページ番号が返されます。

新しい機能：生成

ML Kitはバーコードを生成するのではなく、読み取るだけです。 移植後のアプリケーションでラベル、チケット、またはQRコードを作成する必要がある場合、 IronBarcodeは同じパッケージでそれらの機能も提供します。

配送ラベル用コード128：

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

using IronBarCode;

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128)
    .ResizeTo(400, 120)
    .SaveAsPng("shipping-label.png");

Imports IronBarCode

BarcodeWriter.CreateBarcode("SHIP-2024-98341", BarcodeEncoding.Code128) _
    .ResizeTo(400, 120) _
    .SaveAsPng("shipping-label.png")

QRコード生成：

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500)
    .SaveAsPng("tracking-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/track/98341", 500) _
    .SaveAsPng("tracking-qr.png")

ロゴとカラー入りのQRコード：

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

using IronBarCode;

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500)
    .AddBrandLogo("company-logo.png")
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue)
    .SaveAsPng("product-qr.png");

Imports IronBarCode

QRCodeWriter.CreateQrCode("https://example.com/product/4821", 500) _
    .AddBrandLogo("company-logo.png") _
    .ChangeBarCodeColor(System.Drawing.Color.DarkBlue) _
    .SaveAsPng("product-qr.png")

HTTPレスポンスのバーコードをバイト配列として返します。

using IronBarCode;

// In an.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

using IronBarCode;

// In an.NET Corecontroller action
byte[] barcodeBytes = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode)
    .ToPngBinaryData();

return File(barcodeBytes, "image/png");

Imports IronBarCode

' In a .NET Core controller action
Dim barcodeBytes As Byte() = BarcodeWriter.CreateBarcode("ORDER-7734", BarcodeEncoding.QRCode).ToPngBinaryData()

Return File(barcodeBytes, "image/png")

これらのパターンには、ML Kitに相当するものはありません。 これらは、モバイル専用スキャナーではなく、完全な.NETバーコードライブラリを使用しているため利用できる新しい機能です。

サーバーサイドバッチ処理

ML Kitは呼び出しごとに1枚の画像を処理し、Android/iOSランタイムを必要とし、サーバーサイド実行の概念はありません。 IronBarcodeはファイルをループ処理し、 ASP.NET Core上で動作し、通常通りスケーリングします。

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

using IronBarCode;

// Process a folder of scanned document images
var imageFiles = Directory.GetFiles("/data/scans", "*.jpg");
var allResults = new List<(string File, string Value, BarcodeEncoding Format)>();

foreach (var file in imageFiles)
{
    var options = new BarcodeReaderOptions
    {
        Speed = ReadingSpeed.Faster,
        ExpectMultipleBarcodes = false
    };

    var results = BarcodeReader.Read(file, options);
    foreach (var barcode in results)
    {
        allResults.Add((file, barcode.Value, barcode.Format));
    }
}

// Write results to CSV, database, etc.
foreach (var (file, value, format) in allResults)
{
    Console.WriteLine($"{file}: [{format}] {value}");
}

Imports IronBarCode
Imports System.IO

' Process a folder of scanned document images
Dim imageFiles = Directory.GetFiles("/data/scans", "*.jpg")
Dim allResults = New List(Of (File As String, Value As String, Format As BarcodeEncoding))()

For Each file In imageFiles
    Dim options = New BarcodeReaderOptions With {
        .Speed = ReadingSpeed.Faster,
        .ExpectMultipleBarcodes = False
    }

    Dim results = BarcodeReader.Read(file, options)
    For Each barcode In results
        allResults.Add((file, barcode.Value, barcode.Format))
    Next
Next

' Write results to CSV, database, etc.
For Each result In allResults
    Console.WriteLine($"{result.File}: [{result.Format}] {result.Value}")
Next

画像フォルダを読み込み、バーコードを抽出し、結果を集計するという一連の処理は、ML Kitでは実行できません。 これは標準的なIronBarcodeのワークフローです。

機能比較

移行チェックリスト

Androidのコードベースを移植する場合、または非公式のXamarin ML Kitバインディングを置き換える場合は、プロジェクト内でこれらのパターンを検索し、上記の翻訳を適用してください。

• Gradleファイルのcom.google.mlkit:barcode-scanning →削除、BarCode NuGet追加
• BarcodeScannerOptions.Builder() → new BarcodeReaderOptions { }
• BarcodeScanning.getClient(options) →削除（IronBarcodeにスキャナーインスタンスなし）
• InputImage.fromFilePath(context, uri) →ファイルパス文字列引数
• InputImage.fromBitmap(bitmap, rotation) →BarcodeReader.Read(stream)またはバイト配列オーバーロード
• scanner.process(inputImage) →BarcodeReader.Read(path, options)
• .addOnSuccessListener { barcodes -> } →Read()の戻り値を反復
• .addOnFailureListener { e -> } →Read()周囲にtry/catch
• barcode.rawValue →barcode.Value
• barcode.format →barcode.Format
• Barcode.FORMAT_QR_CODE →BarcodeEncoding.QRCode
• Barcode.FORMAT_CODE_128 →BarcodeEncoding.Code128
• Barcode.FORMAT_ALL_FORMATS →ExpectBarcodeTypes 省略
• using Google.MLKit.BarcodeScanning; (Xamarinバインディング) →using IronBarCode;
• MauiProgram.cs, Program.cs, またはStartup.csに設定する必要があります

コールバックベースのコードから同期コードへの構造的な変更が主な作業内容です。 書式定数と結果フィールド名は直接対応しています。 PDFおよび生成機能のサポートは完全に付加的な機能であり、移行作業は不要で、新しいコードを追加するだけで済みます。