.NET MAUIアプリケーションでのドキュメントスキャナーSDKの使用方法

.NET MAUIアプリケーションでのドキュメントスキャナーSDKの使用方法

1. ドキュメントスキャナーSDKを使用するために、IronOCR C#ライブラリをインストールします。
2. 必要なコントロールを備えた.NET MAUIフォームを設計します。
3. MediaPicker.CapturePhotoAsyncメソッドを使用して写真を撮影します。
4. 撮影された写真をStreamに変換します。
5. ストリームをOcrInputのLoadImageメソッドに渡します。
6. IronTesseractのReadメソッドを使用してOCRを実行します。
7. OcrResultのTextプロパティを使用してドキュメントテキストを表示します。

IronOCR - C# OCR ライブラリ

IronOCRは、Iron Software, LLCによって開発された最先端の光学文字認識（OCR）ソフトウェアで、画像やスキャンドキュメントを正確かつ効率的に編集可能なテキストに変換するように設計されています。 OCR技術は、スキャンドキュメント、PDF、画像などのさまざまな情報源から貴重な情報を抽出するのを容易にし、企業がドキュメントを処理する方法を革命的に変えました。

IronOCRは、その高度な機能、堅牢なパフォーマンス、簡単な統合によってOCRソリューションの中で注目を集めています。 アプリケーションにOCR機能を組み込みたい開発者やドキュメント管理プロセスを効率化したい企業にとって、IronOCRは包括的なソリューションを提供します。

前提条件

• 基本的なC#プログラミングの知識。
• .NET MAUIワークロードをインストールしたVisual Studio 2022。
• NuGetパッケージマネージャを介してインストールされたIronOCRパッケージライブラリ。

1. .NET MAUIプロジェクトのセットアップ

• Visual Studio 2022を開き、新しい.NET MAUIアプリプロジェクトを作成します。

• 適切なプロジェクト名を選択し、プロジェクト設定を構成します。

• ターゲットプラットフォームデバイス開発用に必要なAndroidおよびiOS SDKをインストールしていることを確認します。

2. IronOCRライブラリのインストール

• Visual Studioでソリューションを右クリックします。
  • "Manage NuGet Packages for Solution"を選択し、ブラウズタブで"IronOCR"を検索します。

• プロジェクトにIronOCRライブラリをインストールします。

3. UIの設計

まず、MainPage.xamlのレイアウトを設計することから始めます。 キャプチャされた写真を表示するためのイメージコントロール、写真を撮るためのキャプチャボタン、抽出されたテキストを表示するためのラベルを備えた簡単なレイアウトを作成します。

MainPage.xamlの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"
             xmlns:d="http://schemas.microsoft.com/dotnet/2021/maui/design"
             x:Class="DocumentScanner.MainPage">
    <ScrollView>
        <VerticalStackLayout Padding="30,0" Spacing="25">
            <Image Source="dotnet_bot.png"
                   HeightRequest="185"
                   Aspect="AspectFit"
                   SemanticProperties.Description="dot net bot in a race car number eight" />
            <Label Text="Welcome to .NET MAUI Document Scanner SDK"
                   Style="{StaticResource Headline}"
                   SemanticProperties.HeadingLevel="Level1" />
            <Label Text="Using IronOCR"
                   Style="{StaticResource SubHeadline}"
                   SemanticProperties.HeadingLevel="Level2"
                   SemanticProperties.Description="Welcome to .NET MAUI Document Scanner SDK" />
            <!-- Camera preview -->
            <Image x:Name="cameraPreview" />
            <!-- Capture button -->
            <Button Text="Capture" Clicked="OnCaptureClicked" />
            <!-- Text display area -->
            <Label x:Name="textLabel" Text="Recognized Text:"/>
        </VerticalStackLayout>
    </ScrollView>
</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"
             xmlns:d="http://schemas.microsoft.com/dotnet/2021/maui/design"
             x:Class="DocumentScanner.MainPage">
    <ScrollView>
        <VerticalStackLayout Padding="30,0" Spacing="25">
            <Image Source="dotnet_bot.png"
                   HeightRequest="185"
                   Aspect="AspectFit"
                   SemanticProperties.Description="dot net bot in a race car number eight" />
            <Label Text="Welcome to .NET MAUI Document Scanner SDK"
                   Style="{StaticResource Headline}"
                   SemanticProperties.HeadingLevel="Level1" />
            <Label Text="Using IronOCR"
                   Style="{StaticResource SubHeadline}"
                   SemanticProperties.HeadingLevel="Level2"
                   SemanticProperties.Description="Welcome to .NET MAUI Document Scanner SDK" />
            <!-- Camera preview -->
            <Image x:Name="cameraPreview" />
            <!-- Capture button -->
            <Button Text="Capture" Clicked="OnCaptureClicked" />
            <!-- Text display area -->
            <Label x:Name="textLabel" Text="Recognized Text:"/>
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

このレイアウトでは：

• コントロールを垂直にスタックさせるためにVerticalStackLayoutを使用します。
• cameraPreviewという名前のImageコントロールは、キャプチャされた写真を表示するために使用されます。
• ButtonコントロールはクリックされるとOnCaptureClickedイベントハンドラをトリガーします。
• textLabelという名前のLabelコントロールは、抽出されたテキストを表示するために使用されます。

4. ドキュメントスキャン機能の実装

.NET MAUIドキュメントスキャンアプリにテキスト抽出機能を統合するために、次のステップに従います：

1. カメラAPIを利用: アプリケーション内で直接画像ファイルをキャプチャするために、.NET MAUIが提供するカメラAPIを活用します。
2. 画像をIronOCRに渡します: 画像がキャプチャされたら、IronOCRに渡してその強力な機能を利用してテキスト抽出を行います。
3. 抽出されたテキストを表示: 抽出されたテキストをユーザーインターフェイス上の指定されたエリアに表示し、ユーザーに閲覧させます。

これらのステップを実装する対応するコードスニペットはこちらです：

using IronOcr;

namespace DocumentScanner
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            InitializeComponent();
        }

        private async void OnCaptureClicked(object sender, EventArgs e)
        {
            License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
            try
            {
                // Request camera permissions
                var status = await Permissions.RequestAsync<Permissions.Camera>();
                if (status == PermissionStatus.Granted)
                {
                    // Take photo
                    var photo = await MediaPicker.CapturePhotoAsync();
                    if (photo != null)
                    {
                        // Display captured photo in Image
                        cameraPreview.Source = ImageSource.FromStream(() => photo.OpenReadAsync().Result);
                        using (var stream = await photo.OpenReadAsync())
                        {
                            // Use a stream from the captured photo for OCR
                            var ocr = new IronTesseract();
                            using var ocrInput = new OcrInput();
                            ocrInput.LoadImage(stream);
                            var ocrResult = ocr.Read(ocrInput);
                            if (string.IsNullOrEmpty(ocrResult.Text))
                            {
                                await DisplayAlert("Error", "No Text Detected!", "OK");
                            }
                            else
                            {
                                await DisplayAlert("Text Detected!", ocrResult.Text, "OK");
                                // Display extracted text
                                textLabel.Text = ocrResult.Text;
                            }
                        }
                    }
                }
                else
                {
                    // Camera permission denied
                    await DisplayAlert("Permission Denied", "Camera permission is required to capture photos.", "OK");
                }
            }
            catch (Exception ex)
            {
                // Handle exception
                await DisplayAlert("Error", ex.Message, "OK");
            }
        }
    }
}

using IronOcr;

namespace DocumentScanner
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            InitializeComponent();
        }

        private async void OnCaptureClicked(object sender, EventArgs e)
        {
            License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
            try
            {
                // Request camera permissions
                var status = await Permissions.RequestAsync<Permissions.Camera>();
                if (status == PermissionStatus.Granted)
                {
                    // Take photo
                    var photo = await MediaPicker.CapturePhotoAsync();
                    if (photo != null)
                    {
                        // Display captured photo in Image
                        cameraPreview.Source = ImageSource.FromStream(() => photo.OpenReadAsync().Result);
                        using (var stream = await photo.OpenReadAsync())
                        {
                            // Use a stream from the captured photo for OCR
                            var ocr = new IronTesseract();
                            using var ocrInput = new OcrInput();
                            ocrInput.LoadImage(stream);
                            var ocrResult = ocr.Read(ocrInput);
                            if (string.IsNullOrEmpty(ocrResult.Text))
                            {
                                await DisplayAlert("Error", "No Text Detected!", "OK");
                            }
                            else
                            {
                                await DisplayAlert("Text Detected!", ocrResult.Text, "OK");
                                // Display extracted text
                                textLabel.Text = ocrResult.Text;
                            }
                        }
                    }
                }
                else
                {
                    // Camera permission denied
                    await DisplayAlert("Permission Denied", "Camera permission is required to capture photos.", "OK");
                }
            }
            catch (Exception ex)
            {
                // Handle exception
                await DisplayAlert("Error", ex.Message, "OK");
            }
        }
    }
}

Imports IronOcr

Namespace DocumentScanner
	Partial Public Class MainPage
		Inherits ContentPage

		Public Sub New()
			InitializeComponent()
		End Sub

		Private Async Sub OnCaptureClicked(ByVal sender As Object, ByVal e As EventArgs)
			License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
			Try
				' Request camera permissions
				Dim status = Await Permissions.RequestAsync(Of Permissions.Camera)()
				If status = PermissionStatus.Granted Then
					' Take photo
					Dim photo = Await MediaPicker.CapturePhotoAsync()
					If photo IsNot Nothing Then
						' Display captured photo in Image
						cameraPreview.Source = ImageSource.FromStream(Function() photo.OpenReadAsync().Result)
						Using stream = Await photo.OpenReadAsync()
							' Use a stream from the captured photo for OCR
							Dim ocr = New IronTesseract()
							Dim ocrInput As New OcrInput()
							ocrInput.LoadImage(stream)
							Dim ocrResult = ocr.Read(ocrInput)
							If String.IsNullOrEmpty(ocrResult.Text) Then
								Await DisplayAlert("Error", "No Text Detected!", "OK")
							Else
								Await DisplayAlert("Text Detected!", ocrResult.Text, "OK")
								' Display extracted text
								textLabel.Text = ocrResult.Text
							End If
						End Using
					End If
				Else
					' Camera permission denied
					Await DisplayAlert("Permission Denied", "Camera permission is required to capture photos.", "OK")
				End If
			Catch ex As Exception
				' Handle exception
				Await DisplayAlert("Error", ex.Message, "OK")
			End Try
		End Sub
	End Class
End Namespace

5. ドキュメントスキャナーアプリのテスト

• 各プラットフォーム（Android、iOS、Windows）上でアプリを実行し、クロスプラットフォーム互換性を確認します。
• さまざまなフォント、サイズ、向きのドキュメントをスキャンするなど、異なるシナリオをテストします。
• 抽出されたテキストが正確で、UI上に正しく表示されていることを確認します。

結論

このチュートリアルに従うことで、.NET MAUI内でIronOCRドキュメントスキャナーSDKを使用する方法を学びました。 ドキュメントスキャンアプリは、紙のドキュメントをデジタル化することから、受領書や請求書から保存された情報を抽出することまで、多くの実用的な応用を持っています。 IronOCRの強力な機能と.NET MAUIの柔軟性を活用して、さまざまな使用ケースに対応する機能豊富なドキュメントスキャナーアプリを構築できます。 さまざまな機能を試し、追加のライブラリを探求し、さらなる印象的なアプリを作成するためにスキルを磨き続けてください。

IronOCRの機能についての詳細情報は、このドキュメントページをご覧ください。

IronOCRは、商業モードで完全な機能をテストできる無料の試用版を提供しています。 その永続的なライトライセンスは$799から始まります。 ライブラリをダウンロードページからダウンロードして試してみてください。