.NET MAUIでiOSのOCRを実行する方法

IronOCR iOS パッケージ

IronOcr.iOS パッケージは、.NET クロスプラットフォーム プロジェクトを介して iOS デバイスで OCR 機能を有効にします。 標準の IronOCR パッケージは必要ありません。

インストールパッケージ IronOcr.iOS

Install with NuGet

インストールパッケージ IronOcr.iOS

nuget.org/packages/IronOcr.iOS/

.NET MAUIプロジェクトの作成

マルチプラットフォームセクションで、.NET MAUI App を選択して続行します。

! .NET MAUI アプリプロジェクトを作成する

IronOCR.iOSライブラリを組み込む

ライブラリを追加する方法はいくつかあります。 最も簡単なのは、おそらくNuGetを使用することです。

1. Visual Studio 内で、"Dependencies > Nuget" を右クリックし、"Manage NuGet Packages ..." を選択します。 2."参照"タブを選択し、"IronOcr.iOS"を検索します。
2. "IronOcr.iOS"パッケージを選択し、"パッケージの追加"をクリックします。

! IronOCR.iOS パッケージをダウンロード

他のプラットフォームで問題が発生しないようにするには、iOS プラットフォームを対象とする場合にのみパッケージを含めるようにcsprojファイルを変更します。 これを行うには：

1. プロジェクトの*.csprojファイルを右クリックして"プロジェクトファイルを編集"を選択します。

2. 次のように新しいItemGroup要素を作成します。

   <ItemGroup Condition="$(TargetFramework.Contains('ios')) == true">
       <PackageReference Include="IronOcr.iOS" Version="YOUR_PACKAGE_VERSION" />
   </ItemGroup>

   <ItemGroup Condition="$(TargetFramework.Contains('ios')) == true">
       <PackageReference Include="IronOcr.iOS" Version="YOUR_PACKAGE_VERSION" />
   </ItemGroup>

   XML
3. "IronOcr.iOS"PackageReference を、先ほど作成したItemGroup内に移動します。

上記の手順により、"IronOCR.iOS"パッケージが Android プラットフォームなどで使用されなくなります (そのためには、代わりにIronOCR.Androidをインストールしてください)。

"MainPage.xaml"を編集する

XAML ファイルを編集して、OCR の結果を表示するボタンとラベルを表示します。 例えば：

<?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="MAUIIronOCRiOSSample.MainPage">

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <Button
            Text="Import File"
            Clicked="ReadFileOnImport"
            Grid.Row="0"
            HorizontalOptions="Center"
            Margin="20, 20, 20, 10"/>

        <ScrollView
            Grid.Row="1"
            BackgroundColor="LightGray"
            Padding="10"
            Margin="10, 10, 10, 30">
            <Label x:Name="OutputText"/>
        </ScrollView>
    </Grid>

</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="MAUIIronOCRiOSSample.MainPage">

    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
        </Grid.RowDefinitions>
        <Button
            Text="Import File"
            Clicked="ReadFileOnImport"
            Grid.Row="0"
            HorizontalOptions="Center"
            Margin="20, 20, 20, 10"/>

        <ScrollView
            Grid.Row="1"
            BackgroundColor="LightGray"
            Padding="10"
            Margin="10, 10, 10, 30">
            <Label x:Name="OutputText"/>
        </ScrollView>
    </Grid>

</ContentPage>

"MainPage.xaml.cs"を編集する

まず、 IronTesseractオブジェクトをインスタンス化します。 以下のコードに示すように、クラス内でIronTesseract 1 回初期化するようにしてください。 メソッド内で直接インスタンス化することは効果的ではなく、予期しないエラーが発生する可能性があります。 次に、FilePicker.PickAsyncメソッドを使用してファイルを選択します。FileResultから、読み取り用のストリームを開きます。 新しいOcrInputオブジェクトを作成し、このオブジェクトを使用して画像を読み込みます。 tesseract インスタンスを使用して画像に対して OCR を実行し、テキストを返します。 最後に、結果のテキストをラベルに表示します。

現在の実装は画像ファイルのみに制限されています。 パッケージはまだ PDF ドキュメントでは動作しません。 これを念頭に置いて、PDF ドキュメントに関連するすべての構成は非アクティブのままにしておく必要があります。

using System;
using IronOcr;
using Microsoft.Maui.Controls;

namespace MAUIIronOCRiOSSample;

public partial class MainPage : ContentPage
{
    // Initialize IronTesseract once in a class
    private IronTesseract ocrTesseract = new IronTesseract();

    public MainPage()
    {
        InitializeComponent();
        // Apply license key
        IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01";
    }

    private async void ReadFileOnImport(object sender, EventArgs e)
    {
        try
        {
            var options = new PickOptions
            {
                PickerTitle = "Please select a file"
            };

            var result = await FilePicker.PickAsync(options);
            if (result != null)
            {
                using var stream = await result.OpenReadAsync();

                // Instantiate OcrInput
                using var ocrInput = new OcrInput();

                // Load image stream
                ocrInput.LoadImage(stream);

                // Perform OCR
                var ocrResult = ocrTesseract.Read(ocrInput);
                OutputText.Text = ocrResult.Text;
            }
        }
        catch (Exception ex)
        {
            // Handle exceptions
            System.Diagnostics.Debug.WriteLine(ex);
        }
    }
}

using System;
using IronOcr;
using Microsoft.Maui.Controls;

namespace MAUIIronOCRiOSSample;

public partial class MainPage : ContentPage
{
    // Initialize IronTesseract once in a class
    private IronTesseract ocrTesseract = new IronTesseract();

    public MainPage()
    {
        InitializeComponent();
        // Apply license key
        IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01";
    }

    private async void ReadFileOnImport(object sender, EventArgs e)
    {
        try
        {
            var options = new PickOptions
            {
                PickerTitle = "Please select a file"
            };

            var result = await FilePicker.PickAsync(options);
            if (result != null)
            {
                using var stream = await result.OpenReadAsync();

                // Instantiate OcrInput
                using var ocrInput = new OcrInput();

                // Load image stream
                ocrInput.LoadImage(stream);

                // Perform OCR
                var ocrResult = ocrTesseract.Read(ocrInput);
                OutputText.Text = ocrResult.Text;
            }
        }
        catch (Exception ex)
        {
            // Handle exceptions
            System.Diagnostics.Debug.WriteLine(ex);
        }
    }
}

Imports System
Imports IronOcr
Imports Microsoft.Maui.Controls

Namespace MAUIIronOCRiOSSample

	Partial Public Class MainPage
		Inherits ContentPage

		' Initialize IronTesseract once in a class
		Private ocrTesseract As New IronTesseract()

		Public Sub New()
			InitializeComponent()
			' Apply license key
			IronOcr.License.LicenseKey = "IRONOCR-MYLICENSE-KEY-1EF01"
		End Sub

		Private Async Sub ReadFileOnImport(ByVal sender As Object, ByVal e As EventArgs)
			Try
				Dim options = New PickOptions With {.PickerTitle = "Please select a file"}

				Dim result = Await FilePicker.PickAsync(options)
				If result IsNot Nothing Then
					Dim stream = Await result.OpenReadAsync()

					' Instantiate OcrInput
					Dim ocrInput As New OcrInput()

					' Load image stream
					ocrInput.LoadImage(stream)

					' Perform OCR
					Dim ocrResult = ocrTesseract.Read(ocrInput)
					OutputText.Text = ocrResult.Text
				End If
			Catch ex As Exception
				' Handle exceptions
				System.Diagnostics.Debug.WriteLine(ex)
			End Try
		End Sub
	End Class
End Namespace

$vbLabelText   $csharpLabel

最後に、ビルドターゲットをiOSシミュレーターに切り替えてプロジェクトを実行します。

プロジェクトを実行する

ここでは、プロジェクトを実行して OCR を実行する方法を説明します。

.NET MAUIアプリプロジェクトをダウンロードする

このガイドの完全なコードをダウンロードできます。これは.zipファイルとして提供され、Visual Studioで.NET MAUIアプリプロジェクトとして開くことができます。

プロジェクトをダウンロードするにはここをクリックしてください。

AvaloniaでIronOcr.iOSを使用する

Avalonia での IronOCR.iOS のセットアップは MAUI と似ていますが、重要な違いが 1 つあります。IronOCR.iOS を正常に実行するには、最新の .NET SDK バージョンに加えて、 .NET SDK 8.0.101もインストールされている必要があります。 その後、IronOcr.iOS は上記と同じ設定で Avalonia プロジェクトで使用できるようになります。

Android で OCR を実行する場合は、次の記事を参照して詳細を確認してください: " .NET MAUI で Android で OCR を実行する方法"