Cómo Usar un SDK de Escáner de Documentos en una Aplicación .NET MAUI

Cómo utilizar un SDK de escáner de documentos en una aplicación .NET MAUI

1. Instala la biblioteca C# IronOCR para usar el SDK de escáner de documentos.
2. Diseña un formulario .NET MAUI con los controles necesarios.
3. Captura una foto utilizando el método MediaPicker.CapturePhotoAsync.
4. Convierte la foto capturada a un Stream.
5. Pasa el stream al método OcrInput LoadImage.
6. Realiza OCR usando el método IronTesseract Read.
7. Muestra el texto del documento utilizando la propiedad Text de OcrResult.

IronOCR - La biblioteca de OCR de C#

IronOCR es un software de Reconocimiento Óptico de Caracteres (OCR) de última generación desarrollado por Iron Software, LLC, diseñado para convertir imágenes y documentos escaneados en texto editable de manera precisa y eficiente. La tecnología OCR ha revolucionado cómo las empresas manejan el procesamiento de documentos, facilitando la extracción de información valiosa de varias fuentes como documentos escaneados, PDFs e imágenes.

IronOCR se destaca entre las soluciones OCR debido a sus características avanzadas, rendimiento robusto y facilidad de integración. Ya sea que seas un desarrollador buscando incorporar características OCR en tus aplicaciones o una empresa que busca optimizar los procesos de gestión documental, IronOCR ofrece una solución completa.

Requisitos previos

• Conocimientos básicos de programación en C#.
• Visual Studio 2022 instalado con la carga de trabajo de .NET MAUI.
• Biblioteca de paquetes IronOCR instalada a través del Administrador de Paquetes NuGet.

1. Configuración de su proyecto .NET MAUI

• Abre Visual Studio 2022 y crea un nuevo proyecto de aplicación .NET MAUI.

• Elige un nombre de proyecto adecuado y configura las opciones de tu proyecto.

• Asegúrate de tener instalados los SDKs necesarios de Android y iOS para el desarrollo de dispositivos en plataformas objetivo.

2. Instalación de la biblioteca IronOCR

• Haz clic derecho en tu Solución en Visual Studio.
  • Selecciona 'Administrar paquetes NuGet para la solución' y en la pestaña Explorar, busca 'IronOCR'.

• Instala la biblioteca IronOCR en tu proyecto.

3. Diseño de la interfaz de usuario

Empecemos diseñando el diseño de nuestro MainPage.xaml. Crearemos un diseño simple con un control de imagen para mostrar la foto capturada, un botón de captura para tomar fotos y un Label para mostrar el texto extraído.

Aquí está el código XAML para 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"
             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>

En este diseño:

• Usamos un VerticalStackLayout para apilar los controles verticalmente.
• El control Image llamado cameraPreview se usa para mostrar la foto capturada.
• El control Button desencadena el controlador de eventos OnCaptureClicked cuando se hace clic.
• El control Label llamado textLabel se utiliza para mostrar el texto extraído.

4. Implementación de la funcionalidad de escaneo de documentos

Para integrar la funcionalidad de extracción de texto en nuestra aplicación de escaneo de documentos .NET MAUI, seguiremos estos pasos:

1. Utilizar la API de Cámara: Aprovechar la API de cámara proporcionada por .NET MAUI para capturar archivos de imagen directamente dentro de tu aplicación.
2. Pasar Imagen a IronOCR: Una vez que se captura una imagen, pásala a IronOCR para la extracción de texto, aprovechando su robusta funcionalidad.
3. Mostrar Texto Extraído: Muestra el texto extraído en el área designada en la interfaz de usuario de tu aplicación para su visualización por el usuario.

Aquí está el fragmento de código correspondiente que implementa estos pasos:

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. Prueba de la aplicación del escáner de documentos

• Ejecuta la aplicación en varias plataformas (Android, iOS y Windows) para garantizar la compatibilidad multiplataforma.
• Prueba diferentes escenarios, como escanear documentos con diversas fuentes, tamaños y orientaciones.
• Verifica que el texto extraído sea preciso y se muestre correctamente en la interfaz de usuario.

Conclusión

Al seguir este tutorial, has aprendido cómo usar el SDK de escáner de documentos de IronOCR dentro de .NET MAUI. Las aplicaciones de escaneo de documentos tienen numerosas aplicaciones prácticas, desde digitalizar documentos en papel hasta extraer información almacenada en recibos y facturas. Utilizando las poderosas capacidades de IronOCR y la flexibilidad de .NET MAUI, puedes construir aplicaciones de escaneo de documentos ricas en funciones que se adapten a varios casos de uso. Experimenta con diferentes funcionalidades, explora bibliotecas adicionales y continúa perfeccionando tus habilidades para crear aplicaciones aún más impresionantes.

Para obtener información más detallada sobre las capacidades de IronOCR, por favor visita esta página de documentación.

IronOCR ofrece una prueba gratuita para probar su funcionalidad completa en modo comercial. Su licencia perpetua lite comienza a partir de $799. Descarga la biblioteca desde la página de descarga y pruébala.