Jak korzystać z SDK skanera dokumentów w aplikacji .NET MAUI

Jak korzystać z zestawu SDK skanera dokumentów w aplikacji .NET MAUI

1. Zainstaluj bibliotekę IronOCR C#, aby korzystać z zestawu SDK skanera dokumentów.
2. Zaprojektuj formularz .NET MAUI z niezbędnymi kontrolkami.
3. Zrób zdjęcie za pomocą metody MediaPicker.CapturePhotoAsync.
4. Przekonwertuj zrobione zdjęcie na strumień.
5. Przekaz strumien do metody OcrInput LoadImage.
6. Wykonaj OCR uzywajac metody IronTesseract Read.
7. Wyswietl tekst dokumentu, korzystajac z wlasciwosci OcrResult Text.

IronOCR - Biblioteka OCR C#

IronOCR to nowoczesne oprogramowanie do rozpoznawania znakow (OCR) opracowane przez Iron Software, LLC, zaprojektowane do dokladnego i wydajnego konwertowania obrazow oraz zeskanowanych dokumentow na edytowalny tekst. Technologia OCR zrewolucjonizowala, jak firmy zajmuja sie przetwarzaniem dokumentow, ulatwiajac wydobycie wartosciowych informacji z roznych zrodel, takich jak zeskanowane dokumenty, PDFy i obrazy.

IronOCR wyróznia sie sposród rozwiazan OCR, dzieki zaawansowanym funkcjom, niezawodnej wydajnosci i latwosci integracji. Czy jestes deweloperem szukajacym integracji funkcji OCR do swoich aplikacji, czy firma poszukujaca sposobow na optymalizacje zarzadzania dokumentami, IronOCR oferuje kompleksowe rozwiazanie.

Wymagania wstępne

• Podstawowa znajomosc programowania w języku C#.
• Zainstalowany Visual Studio 2022 z obciazeniem .NET MAUI.
• Zainstalowana biblioteka IronOCR poprzez menedżer pakietow NuGet.

1. Ustawienie projektu .NET MAUI

• Otworz Visual Studio 2022 i utworz nowy projekt .NET MAUI App.

• Wybierz odpowiednia nazwe projektu i skonfiguruj ustawienia projektu.

• Upewnij sie, ze masz zainstalowane wymagane SDK Android i iOS dla rozwoju urzadzen docelowych.

2. Instalowanie biblioteki IronOCR

• Kliknij prawym przyciskiem myszy na swoje Rozwiazanie w Visual Studio.
  • Wybierz "Zarzadzaj pakietami NuGet dla rozwiazania" i w zakladce Przegladanie, wyszukaj "IronOCR".

• Zainstaluj biblioteke IronOCR do swojego projektu.

3. Projektowanie UI

Zaczniemy od zaprojektowania ukladu naszej MainPage.xaml. Utworzymy prosty uklad z kontrolka obrazu do wyswietlania uchwyconego zdjecia, przyciskiem Capture do robienia zdjec oraz etykieta do wyswietlania wyodrebnionego tekstu.

Oto kod XAML dla 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>

W tym ukladem:

• Uzywamy VerticalStackLayout do ukladu pionowego.
• Kontrolka Image o nazwie cameraPreview jest uzywana do wyswietlania uchwyconego zdjecia.
• Kontrolka Button wywoluje obsluge zdarzenia OnCaptureClicked po kliknieciu.
• Kontrolka Label o nazwie textLabel jest uzywana do wyswietlania wyodrebnionego tekstu.

4. Implementacja funkcjonalnosci skanowania dokumentow

Aby zintegrowac funkcjonalnosc ekstrakcji tekstu do naszej aplikacji do skanowania dokumentow .NET MAUI, postepujemy zgodnie z tymi krokami:

1. Wykorzystaj API Kamery: Wykorzystaj API kamery udostepnione przez .NET MAUI do uchwycenia plikow obrazow bezposrednio w aplikacji.
2. Przekaz obraz do IronOCR: Po uchwyceniu obrazu, przekaz go do IronOCR do ekstrakcji tekstu, wykorzystujac jego solidna funkcjonalnosc.
3. Wyswietl wyodrebniony tekst: Wyswietl wyodrebniony tekst w wyznaczonym miejscu na interfejsie uzytkownika aplikacji, aby uzytkownik mogl go zobaczyc.

Oto odpowiadajacy fragment kodu implementujacy te kroki:

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. Testowanie aplikacji skanujacej dokumenty

• Uruchom aplikacje na roznych platformach (Android, iOS i Windows), aby zapewnic kompatybilnosc miedzyplatformowa.
• Przetestuj rozne scenariusze, takie jak skanowanie dokumentow z roznych czcionek, rozmiarow i orientacji.
• Zweryfikuj, czy wyodrebniony tekst jest dokladny i prawidlowo wyswietlany na interfejsie uzytkownika.

Wnioski

Podazajac za tym tutorialem, nauczyliscie sie, jak uzywac SDK skanera dokumentow IronOCR w obrebie .NET MAUI. Aplikacje skanujace dokumenty maja wiele praktycznych zastosowan, od digitalizacji dokumentow papierowych po wydobywanie informacji przechowywanych na paragonach i fakturach. Wykorzystujac potezne mozliwosci IronOCR i elastycznosc .NET MAUI, mozecie budowac bogate w funkcje aplikacje skanujace dokumenty, ktore spełniają rozne przypadki uzycia. Eksperymentuj z roznymi funkcjonalnosciami, eksploruj dodatkowe biblioteki i nadal udoskonalaj swoje umiejetnosci, aby tworzyc jeszcze bardziej imponujace aplikacje.

Dla bardziej szczegolowych informacji na temat mozliwosci IronOCR, odwiedz te strone dokumentacja.

IronOCR zapewnia darmowa wersje probna, aby przetestowac jego pelna funkcjonalnosc w trybie komercyjnym. Jej wieczysta licencja lite zaczyna się od $999. Pobierz biblioteke z strony pobierania i wyproboj.