如何在 .NET MAUI 應用程式中使用文件掃描器 SDK

如何在 .NET MAUI 應用程式中使用文件掃描器 SDK

1. 安裝IronOCR C# 庫以使用文件掃描器 SDK。
2. 設計一個包含必要控制項的 .NET MAUI 表單。
3. 使用MediaPicker.CapturePhotoAsync方法拍照。
4. 將拍攝的照片轉換為串流。
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#程式設計基礎。
• 安裝了 Visual Studio 2022 和 .NET MAUI 工作負載。
• 透過 NuGet 套件管理器安裝 IronOCR 套件庫。

1. 設定您的 .NET MAUI 項目

• 開啟 Visual Studio 2022 並建立一個新的 .NET MAUI 應用程式專案。

如何在 .NET MAUI 應用程式中使用文件掃描器 SDK：圖 1 - .NET MAUI 應用程式項目

• 選擇合適的項目名稱並配置項目設定。

如何在 .NET MAUI 應用程式中使用文件掃描器 SDK：圖 2 - 專案配置

• 確保您已安裝目標平台裝置開發所需的 Android 和 iOS SDK。

2. 安裝 IronOCR 庫

• 在 Visual Studio 中右鍵點選您的解決方案。
  • 選擇"管理解決方案的 NuGet 套件"，然後在"瀏覽"標籤中搜尋"IronOCR"。

如何在 .NET MAUI 應用程式中使用文件掃描器 SDK：圖 3 - IronOCR NuGet 套件

• 將 IronOCR 庫安裝到您的專案中。

3. 設計使用者介面

讓我們先來設計 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" />

            <Image x:Name="cameraPreview" />

            <Button Text="Capture" Clicked="OnCaptureClicked" />

            <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" />

            <Image x:Name="cameraPreview" />

            <Button Text="Capture" Clicked="OnCaptureClicked" />

            <Label x:Name="textLabel" Text="Recognized Text:"/>
        </VerticalStackLayout>
    </ScrollView>
</ContentPage>

在這種佈局中：

• 我們使用VerticalStackLayout將控制項垂直堆疊起來。
• 名為cameraPreview 的**影像**控制項用於顯示拍攝的照片。
• 點選按鈕控制項時，會觸發OnCaptureClicked事件處理程序。
• 名為textLabel 的**標籤**控制項用於顯示擷取的文字。

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）上運行該應用程序，以確保跨平台相容性。
• 測試不同的場景，例如掃描不同字體、大小和方向的文件。
• 驗證擷取的文字是否準確，並在使用者介面上正確顯示。

結論

透過本教學課程，您已經學會如何在 .NET MAUI 中使用 IronOCR 文件掃描器 SDK。 文件掃描應用程式有許多實際應用，從將紙本文件數位化到從收據和發票中提取儲存的資訊。 利用 IronOCR 的強大功能和 .NET MAUI 的靈活性，您可以建立功能豐富的文件掃描應用程序，以滿足各種使用情境的需求。 嘗試不同的功能，探索其他庫，不斷磨練你的技能，從而創建更令人印象深刻的應用程式。

有關 IronOCR 功能的更多詳細信息，請訪問此文件頁面。

IronOCR 提供免費試用版，供用戶測試其商業模式下的全部功能。 其永久精簡版授權起價為$799 。 從下載頁面下載庫檔案並試用。