使用IRONBARCODE

如何在 .NET MAUI 应用程序中使用文档扫描仪 SDK

Name: IronBarcode
Brand: Iron Software
Availability: InStock
Rating: 4.67 (175 reviews)

乔尔迪·巴尔迪亚

2024年四月29日

随着移动技术的兴起，像 Scanbot SDK 和 Native SDKs 这样的文档扫描应用程序已成为个人和企业专家不可或缺的工具。在本教程中，我们将探讨如何使用最新版本的 .NET 多平台应用程序界面 (MAUI) 和 IronOCR（一个功能强大的 .NET OCR（光学字符识别）库）创建文档扫描应用程序。 .NET MAUI 简化了跨平台移动应用程序（如 Android）的创建，确保在最终用户设备上的无缝部署。本指南结束时，您将能够开发自己的文档扫描仪 SDK 应用程序，轻松地从图像和扫描文件中提取文本。

如何在 .NET MAUI 应用程序中使用文档扫描仪 SDK

安装IronOCR C#库以使用文档扫描SDK。
使用必要的控件设计 .NET MAUI 表单。
使用 MediaPicker.CapturePhotoAsync 方法捕捉照片框。
将捕获的照片转换为流。
将流传递给 OcrInput 的 LoadImage 方法。
使用 IronTesseract 的Read方法执行 OCR。
使用 OcrResult 的Text 属性显示文档文本。

IronOCR - C# OCR库

IronOCR 是由 Iron Software, LLC 开发的尖端光学字符识别 (OCR) 软件，旨在准确高效地将图像和扫描文档转换为可编辑文本。 OCR 技术彻底改变了企业处理文档的方式，使从扫描文档、PDF 和图像等各种来源提取有价值信息变得更加容易。

IronOCR 凭借其先进的功能、强大的性能和易于集成的特点，在众多 OCR 解决方案中脱颖而出。无论您是希望将 OCR 功能纳入应用程序的开发人员，还是希望简化数据生成的文档管理流程的企业，IronOCR 都能为您提供全面的解决方案。

IronOCR 的主要功能

以下是 IronOCR 的一些重要关键功能：

高精度： IronOCR 使用最先进的算法和机器学习技术来实现卓越的文本识别精度。它可以从复杂的文档中准确提取文本，包括 QR 低分辨率或劣质扫描的图像。
多语言支持：IronOCR 的一大特点是其广泛的语言支持。它可以识别超过 127 种语言的文本，适合在不同语言环境下运营的企业。
图像预处理：为了提高准确性，IronOCR 提供了各种图像预处理功能，例如降噪、对比度调整和去偏斜。这些预处理技术有助于改善 OCR 结果，尤其是在处理扭曲或不完美的图像时。
支持各种文件格式：IronOCR 支持多种文件格式，包括 TIFF、JPEG、PNG 和 PDF。这种灵活性使用户可以处理不同来源的文档，而不必担心兼容性问题。
自定义选项：开发人员可以根据他们的特定需求自定义 IronOCR 的行为。无论是微调识别参数还是与现有工作流程整合，IronOCR 都能提供高度的灵活性和定制性。
快速且可扩展：IronOCR经过优化以提升性能，能够快速从大量文档中提取文本。无论是处理少量文档还是处理海量文档库，其可扩展的架构都能确保无缝操作。
与.NET应用程序集成：IronOCR无缝集成到.NET应用程序中，为开发人员提供易于使用的API和库，以便在他们的软件项目中加入OCR功能。这种紧密集成简化了开发过程，加快了 OCR 应用程序的上市速度。
文档分类和数据提取： 除了基本的文本识别，IronOCR 还提供用于文档分类和数据提取的高级功能。它可以识别文档中的特定数据字段，如姓名、地址或发票号码，从而实现自动数据提取和分析。

先决条件

具备 C# 编程的基础知识。
您的系统上必须安装 Visual Studio 2022 最新版本，并带有 .NET MAUI 工作负载。
通过 NuGet 软件包管理器安装 IronOCR 软件包库。

1.设置您的 .NET MAUI 项目

打开 Visual Studio 2022 并创建一个新的 .NET MAUI App 项目。
选择合适的项目名称并配置项目设置。

确保安装了必要的 Android 和 iOS SDK，以便进行目标平台设备开发。

2.安装 IronOCR 库

右键单击 Visual Studio 中的解决方案。
- 选择 "管理解决方案的 NuGet 包"，在 "浏览 "选项卡中搜索 "IronOCR"。
将 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" />
            <!-- 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>

XML

在此版面中：

我们使用VerticalStackLayout来垂直堆叠控件。
名为capturedImage的图像控件用于显示捕获的照片。
Button 控件在被点击时触发 OnCaptureClicked 事件处理程序。
Label 控件名为 textLabel ，用于显示提取的文本。

输出

如何在.NET MAUI应用程序中使用文档扫描SDK：图4 - MainPage.xaml输出

4.实现文档扫描功能

为了将文本提取功能集成到我们的 .NET MAUI 文档扫描应用程序中，我们将遵循以下步骤：

利用相机 API：首先通过 .NET MAUI 提供的相机 API 在应用程序中直接捕获图像文件。
传递图像到 IronOCR：一旦图像被捕获，就将其传递给 IronOCR，一个强大的 OCR 库，用于文本提取。 IronOCR 提供了强大的功能，可以高精度地从图像中提取文本。
显示提取文本：最后，在应用程序用户界面上的指定区域显示提取的文本。这样，用户就可以轻松查看从捕获的图像或 QR 码中提取的文本。
以下是实现这些步骤的相应代码片段：

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

$vbLabelText $csharpLabel

代码解释

让我们逐步分解代码：

在 MainPage.xaml.cs 文件中，我们定义了 OnCaptureClicked 方法，当用户点击 Capture 按钮时会触发该方法。
在OnCaptureClicked方法中，我们首先设置IronOCR许可证密钥。这是使用 IronOCR 库所必需的。将 "YOUR-LICENSE-KEY-HERE" 替换为您的实际许可证密钥。
然后，我们使用Permissions.RequestAsync<Permissions.Camera>()请求相机权限。这样可以确保应用程序拥有访问设备摄像头的必要权限。
我们使用MediaPicker.CapturePhotoAsync()通过设备的相机拍摄照片。如果照片成功捕获，我们会在名为cameraPreview的Image控件中显示它。
我们从拍摄的照片中打开一个数据流，并将其作为使用 IronOCR 进行 OCR 的输入。我们创建一个IronTesseract实例，将图像流加载到OcrInput对象中，然后调用Read方法执行OCR。
如果文本被成功提取，我们会在名为textLabel的Label控件中显示它。如果未检测到文本，我们将使用DisplayAlert显示错误消息。
如需更强大的 IronOCR 使用和代码详细信息，请访问此代码示例页面。

5.测试文档扫描仪应用程序

在各种平台（Android、iOS 和 Windows）上运行应用程序，以确保跨平台兼容性。
测试不同的场景，如扫描不同字体、大小和方向的文档。
验证提取文本的准确性，并在用户界面上正确显示。

输出 - 不含文本的扫描文档

如何在.NET MAUI应用中使用文档扫描器SDK：图5 - 扫描的PDF创建输出

输出 - 包含文本的扫描文档

如何在.NET MAUI应用程序中使用文档扫描仪SDK：图6 - 扫描的文档

结论

通过本教程，您已经学会了如何在 .NET MAUI 中使用 IronOCR 文档扫描仪 SDK。文档扫描应用程序有许多实际应用，从纸质文档数字化到从收据和发票中提取存储信息，不一而足。借助 IronOCR for .NET 的强大功能和 .NET MAUI 的灵活性，您可以构建功能丰富的文档扫描仪应用程序，满足各种使用情况。尝试不同的功能，探索更多的库，继续磨练自己的技能，创建更多令人印象深刻的应用程序。

有关IronOCR功能的详细信息，请访问此文档页面。

IronOCR提供免费试用，以商业模式测试其完整功能。其永久 Lite license 起价为 $749。从下载页面下载库并尝试一下。

乔尔迪·巴尔迪亚

立即与工程团队聊天

软件工程师

Jordi 最擅长 Python、C# 和 C++，当他不在 Iron Software 运用技能时，他会进行游戏编程。作为产品测试、产品开发和研究的负责人之一，Jordi 为持续的产品改进增添了极大的价值。多样化的经验让他充满挑战和参与感，他说这是他在 Iron Software 工作中最喜欢的方面之一。Jordi 在佛罗里达州迈阿密长大，并在佛罗里达大学学习计算机科学和统计学。

< 前一页
创建WEB应用程序的条码扫描器API步骤

下一步 >
创建一个Razor条码生成器Web应用程序