.NET MAUI BarCode Scanner SDK：クロスプラットフォームのスキャナを数分で構築

.NETのMAUIプロジェクトを作成する。

Visual Studioを開き、新しい.NET MAUI Appプロジェクトを作成します。 MAUIプロジェクトに"BarcodeScanner"のような分かりやすい名前を付け、ターゲットフレームワークとして.NET 8以降を選択してください。 Visual Studioは、AndroidとiOSのプラットフォーム固有のフォルダを含むデフォルトのプロジェクト構造を生成します。

IronBarcodeをインストールする

パッケージマネージャーコンソールを使用してIronBarcode NuGetパッケージをインストールしてください：

Install-Package BarCode

このコマンドは、.NET MAUIアプリケーションに必要なすべての依存関係とともに、BarCodeスキャナーSDKをダウンロードしてインストールします。

プラットフォーム権限の設定

ライブカメラではなく画像ファイルからスキャンする場合でも、.NET MAUIバーコードスキャナアプリに以下の権限を設定することは良い習慣です。

Androidの場合は、Platforms/Android/AndroidManifest.xmlに以下を追加してください：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.CAMERA" />

iOSの場合は、Platforms/iOS/Info.plistにこれらのエントリを追加してください：

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>Access needed to select barcode images for scanning.</string>
<key>NSCameraUsageDescription</key>
<string>Camera permission for barcode scanning.</string>

SDKを初期化します。

MauiProgram.csファイルにIronBarcodeを設定してください：

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder
            .UseMauiApp<App>()
            .ConfigureFonts(fonts =>
            {
                fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
            });
        return builder.Build();
    }
}

アプリの初期化コードにライセンスキーを設定することで、すべての機能を使用できるようになります。 IronBarcodeは開発とテスト用に無料トライアルライセンスを提供しています。

ユーザーインターフェイスのデザイン

ユーザーが画像ファイルを選択し、スキャンした BarCode データを表示できるように、MainPage.xaml でクリーンなインターフェイスを作成すること：

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="BarcodeScanner.MainPage">
    <VerticalStackLayout Padding="20" Spacing="15">
        <Label Text=".NET MAUI Barcode Scanner" FontSize="24" HorizontalOptions="Center"/>
        <Button Text="Select Image to Scan" Clicked="OnSelectImageClicked"/>
        <Image x:Name="SelectedImageView" HeightRequest="200"/>
        <Label x:Name="ResultLabel" FontSize="16"/>
    </VerticalStackLayout>
</ContentPage>

バーコード スキャンを実装する。

スキャン・ロジックをMainPage.xaml.csに追加する。 このコードは、画像選択とバーコード検出を処理します：

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

using IronBarCode;
public partial class MainPage : ContentPage
{
    public MainPage()
    {
        InitializeComponent();
    }
    private async void OnSelectImageClicked(object sender, EventArgs e)
    {
        var result = await FilePicker.PickAsync(new PickOptions
        {
            FileTypes = FilePickerFileType.Images,
            PickerTitle = "Select a barcode image"
        });
        if (result != null)
        {
            // Display the selected image
            SelectedImageView.Source = ImageSource.FromFile(result.FullPath);
            // Read barcodes from the image file
            var barcodes = BarcodeReader.Read(result.FullPath);
            if (barcodes.Any())
            {
                ResultLabel.Text = $"Found: {barcodes.First().Value}";
            }
            else
            {
                ResultLabel.Text = "No barcodes detected in selected image.";
            }
        }
    }
}

出力

.NET MAUIバーコードスキャナSDK：クロスプラットフォームスキャナを数分で構築：画像1 - スキャンされたバーコード出力。

BarCodeReader.Read()メソッドは、選択された画像を分析し、検出されたすべてのバーコードを返します。 IronBarcodeはQRコード、Code 128、Code 39、EAN-13、他の多くのフォーマットを含む複数のバーコードシンボロジーを自動的に認識します。

出力

.NET MAUIバーコードスキャナSDK：クロスプラットフォームスキャナを数分で構築：画像2 - QRコードを含むPDFをスキャンするための出力。

ReadPdf()メソッドは、PDFのすべてのページをスキャンし、ページ番号とともにバーコードデータを返すので、複数のバーコードを含む文書を簡単に処理できます。