Como usar um SDK de scanner de documentos em um aplicativo .NET MAUI

Como usar um SDK de Scanner de Documentos em um Aplicativo .NET MAUI

1. Instale a Biblioteca C# IronOCR para usar o SDK de Scanner de Documentos.
2. Projete um Formulário .NET MAUI com os controles necessários.
3. Capture uma foto usando o método MediaPicker.CapturePhotoAsync.
4. Converta a foto capturada em um Stream.
5. Passe o stream para o método LoadImage do OcrInput.
6. Realize OCR usando o método Read do IronTesseract.
7. Exiba o texto do documento usando a propriedade Text do OcrResult.

IronOCR - A BibliotecaOCR C#

IronOCR é um software de Reconhecimento Óptico de Caracteres (OCR) de ponta desenvolvido pela Iron Software, LLC, projetado para converter imagens e documentos digitalizados em texto editável de maneira precisa e eficiente. A tecnologia OCR revolucionou a forma como as empresas lidam com o processamento de documentos, facilitando a extração de informações valiosas de diversas fontes, como documentos digitalizados, PDFs e imagens.

IronOCR se destaca entre as soluções de OCR devido a seus recursos avançados, desempenho robusto e facilidade de integração. Seja você um desenvolvedor buscando incorporar recursos de OCR em seus aplicativos ou uma empresa procurando otimizar processos de gerenciamento de documentos, o IronOCR oferece uma solução abrangente.

Pré-requisitos

• Conhecimento básico de programação C#.
• Visual Studio 2022 instalado com a carga de trabalho .NET MAUI.
• Biblioteca de pacotes IronOCR instalada via Gerenciador de Pacotes NuGet.

1. Configurando Seu Projeto .NET MAUI

• Abra o Visual Studio 2022 e crie um novo projeto App .NET MAUI.

• Escolha um nome de projeto adequado e configure as configurações do projeto.

• Certifique-se de ter os SDKs necessários para Android e iOS instalados para o desenvolvimento de dispositivos de plataforma alvo.

2. Instalando a Biblioteca IronOCR

• Clique com o botão direito na sua Solução no Visual Studio.
• Selecione "Gerenciar Pacotes NuGet para Solução" e na aba Procurar, procure por "IronOCR".

• Instale a biblioteca IronOCR em seu projeto.

3. Projetando a IU

Vamos começar projetando o layout do nosso MainPage.xaml. Vamos criar um layout simples com um controle de imagem para exibir a foto capturada, um botão Capturar para tirar fotos, e um Rótulo para exibir o texto extraído.

Aqui está o 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" />

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

Neste layout:

• Usamos um VerticalStackLayout para empilhar os controles verticalmente.
• O controle Image chamado cameraPreview é usado para exibir a foto capturada.
• O controle Button aciona o manipulador de eventos OnCaptureClicked quando clicado.
• O controle Label chamado textLabel é usado para exibir o texto extraído.

4. Implementando Funcionalidade de Digitalização de Documentos

Para integrar a funcionalidade de extração de texto em nosso aplicativo de Digitalização de Documentos .NET MAUI, seguiremos estas etapas:

1. Utilizar a API da Câmera: Aproveitar a API da câmera fornecida pelo .NET MAUI para capturar arquivos de imagem diretamente dentro do seu aplicativo.
2. Passar Imagem para o IronOCR: Uma vez capturada uma imagem, passá-la para o IronOCR para extração de texto, utilizando sua funcionalidade robusta.
3. Exibir Texto Extraído: Exibir o texto extraído na área designada na interface do usuário do seu aplicativo para visualização do usuário.

Aqui está o trecho de código correspondente implementando estas etapas:

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");
            }
        }
    }
}

5. Testando o Aplicativo de Scanner de Documentos

• Execute o aplicativo em várias plataformas (Android, iOS e Windows) para garantir a compatibilidade entre plataformas.
• Teste diferentes cenários, como digitalizar documentos com várias fontes, tamanhos e orientações.
• Verifique se o texto extraído está preciso e exibido corretamente na UI.

Conclusão

Ao seguir este tutorial, você aprendeu como usar o SDK de scanner de documentos do IronOCR dentro do .NET MAUI. Aplicativos de digitalização de documentos têm inúmeras aplicações práticas, desde digitalizar documentos em papel até extrair informações armazenadas em recibos e faturas. Usando as poderosas capacidades do IronOCR e a flexibilidade do .NET MAUI, você pode construir aplicativos de scanner de documentos ricos em recursos que atendem a vários casos de uso. Experimente diferentes funcionalidades, explore bibliotecas adicionais e continue aprimorando suas habilidades para criar aplicativos ainda mais impressionantes.

Para mais informações detalhadas sobre as capacidades do IronOCR, por favor, visite esta página de documentação.

IronOCR fornece uma avaliação gratuita para testar sua funcionalidade completa em modo comercial. Sua licença perpétua lite começa em $799. Baixe a biblioteca na página de download e experimente.