.NET MAUI Uygulamasında Bir Belge Tarayıcı SDK Nasıl Kullanılır

.NET MAUI Uygulamasında Belge Tarayıcı SDK'yi Nasıl Kullanılır

1. Belge Tarayıcı SDK'sını kullanmak için IronOCR C# Kütüphanesini yükleyin.
2. Gerekli kontrol elemanlarıyla bir .NET MAUI Form tasarlayın.
3. MediaPicker.CapturePhotoAsync yöntemi ile bir fotoğraf çekin.
4. Çekilen fotoğrafı bir Akış (Stream) olarak dönüştürün.
5. Akışı OcrInput LoadImage yöntemine geçirin.
6. IronTesseract Read yöntemiyle OCR gerçekleştirin.
7. Belge metnini OcrResult Text özelliği ile görüntüleyin.

IronOCR - C# OCR Kütüphanesi

IronOCR, görüntüleri ve taranmış belgeleri düzenlenebilir metne doğru ve verimli bir şekilde dönüştürmek için Iron Software, LLC tarafından geliştirilen son teknoloji bir Optik Karakter Tanıma (OCR) yazılımıdır. OCR teknolojisi, işletmelerin belge işlemesini kolaylaştırarak taranmış belgeler, PDF'ler ve görüntüler gibi çeşitli kaynaklardan değerli bilgileri çıkarmasını kolaylaştırmıştır.

IronOCR, gelişmiş özellikleri, sağlam performansı ve entegrasyon kolaylığı nedeniyle OCR çözümleri arasında öne çıkmaktadır. Geliştirici olup uygulamalarınıza OCR özelliklerini dahil etmek için ya da belgelerin yönetim süreçlerini kolaylaştırmak isteyen bir işletme olsun, IronOCR kapsamlı bir çözüm sunar.

Ön Koşullar

• Temel C# programlama bilgisi.
• .NET MAUI iş yükü ile kurulu Visual Studio 2022.
• NuGet Paket Yöneticisi aracılığıyla kurulmuş IronOCR paket kitaplığı.

1. .NET MAUI Projenizi Ayarlama

• Visual Studio 2022'yi açın ve yeni bir .NET MAUI Uygulama projesi oluşturun.

• Uygun bir proje adı seçin ve proje ayarlarınızı yapılandırın.

• Hedef platform cihaz geliştirmesi için gerekli Android ve iOS SDK'lerinin kurulu olduğundan emin olun.

2. IronOCR Kütüphanesinin Kurulması

• Visual Studio'da Çözümünüze sağ tıklayın.
  • "Çözümler İçin NuGet Paketlerini Yönet" öğesini seçin ve Gözat sekmesinde 'IronOCR' arayın.

• IronOCR kütüphanesini projenize yükleyin.

3. UI Tasarımı

Ana sayfamızın görünümünü tasarlayarak başlayalım. Çekilen fotoğrafı göstermek için bir resim kontrolü, fotoğraf çekmek için bir Yakalama düğmesi ve çıkarılan metni göstermek için bir Etiket ile basit bir düzen oluşturacağız.

İşte MainPage.xaml için XAML kodu:

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

Bu düzen içinde:

• Kontrolleri dikey olarak yığmak için bir VerticalStackLayout kullanıyoruz.
• cameraPreview adlı Image kontrolü, çekilen fotoğrafı göstermek için kullanılır.
• Button kontrolü tıklandığında OnCaptureClicked olay işleyicisini tetikler.
• textLabel adlı Label kontrolü, çıkarılan metni göstermek için kullanılır.

4. Belge Tarama İşlevselliğini Uygulama

.NET MAUI Belge Tarama uygulamamıza metin çıkarma işlevselliğini entegre etmek için şu adımları takip edeceğiz:

1. Kamera API'sini Kullanma: Uygulamanız içinde doğrudan görüntü dosyaları yakalamak için .NET MAUI tarafından sağlanan kamera API'sini kullanın.
2. Görüntüyü IronOCR'a Geçin: Bir görüntü çekildiğinde, metin çıkarımı için IronOCR'a geçirerek onun sağlam işlevselliğini kullanın.
3. Çıkarılan Metni Gösterin: Çıkarılan metni, kullanıcı incelemesi için uygulamanızın kullanıcı arayüzünde belirlenen alanda gösterin.

İşte bu adımları uygulayan ilgili kod parçacığı:

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. Belge Tarayıcı Uygulamasını Test Etme

• Çapraz platform uyumluluğu sağlamak için uygulamayı çeşitli platformlarda (Android, iOS ve Windows) çalıştırın.
• Çeşitli yazı tipleri, boyutları ve yönleriyle belgeleri tarama gibi farklı senaryoları test edin.
• Çıkartılan metnin doğru ve arayüzde doğru bir şekilde gösterildiğini doğrulayın.

Sonuç

Bu eğitici kılavuzu takip ederek, IronOCR belge tarayıcı SDK'sını .NET MAUI içinde nasıl kullanacağınızı öğrendiniz. Belge tarama uygulamaları, kağıt belgeleri dijitalleştirmekten makbuzlar ve faturalar gibi saklanan bilgileri çıkarmaya kadar birçok pratik uygulamaya sahiptir. IronOCR'nin güçlü yeteneklerini ve .NET MAUI'nin esnekliğini kullanarak, farklı kullanım senaryolarına hitap eden özellik açısından zengin belge tarayıcı uygulamaları oluşturabilirsiniz. Farklı işlevleri deneyin, ek kütüphaneleri keşfedin ve daha etkileyici uygulamalar oluşturmak için becerilerinizi geliştirmeye devam edin.

IronOCR yetenekleri hakkında daha ayrıntılı bilgi için, lütfen şu dokümantasyon sayfasını ziyaret edin.

IronOCR, ticari modda tam işlevselliğini test etmek için ücretsiz deneme sağlar. Süresiz lite lisansı $799 ile başlar. Kütüphaneyi indirme sayfasından indirip deneyin.