.NET MAUI 애플리케이션에서 문서 스캐너 SDK를 사용하는 방법

.NET MAUI 애플리케이션에서 문서 스캐너 SDK를 사용하는 방법

1. 문서 스캐너 SDK를 사용하기 위해 IronOCR C# 라이브러리를 설치합니다.
2. 필요한 컨트롤을 가지고 .NET MAUI 폼을 디자인합니다.
3. MediaPicker.CapturePhotoAsync 메서드를 사용하여 사진을 캡처합니다.
4. 캡처한 사진을 Stream으로 변환합니다.
5. 스트림을 OcrInput LoadImage 메서드에 전달합니다.
6. IronTesseract Read 메서드를 사용하여 OCR을 수행합니다.
7. OcrResult Text 속성을 사용하여 문서 텍스트를 표시합니다.

IronOCR - C# OCR 라이브러리

IronOCR는 Iron Software, LLC에서 개발한 최첨단 광학 문자 인식(OCR) 소프트웨어로, 이미지 및 스캔된 문서를 편집 가능한 텍스트로 정확하고 효율적으로 변환하도록 설계되었습니다. OCR 기술은 스캔한 문서, PDF, 이미지와 같은 다양한 소스에서 중요한 정보를 추출하는 것을 더 쉽게 만들어 주며, 기업들이 문서 처리 방식을 혁신적으로 변화시켰습니다.

IronOCR는 고급 기능, 강력한 성능, 통합의 용이성 때문에 OCR 솔루션 중에서 두드러집니다. 개발자가 애플리케이션에 OCR 기능을 통합하고자 하거나 문서 관리 프로세스를 간소화하고자 하는 기업이라면, IronOCR가 포괄적인 솔루션을 제공합니다.

필수 조건

• C# 프로그래밍의 기본 지식.
• .NET MAUI 워크로드가 설치된 Visual Studio 2022.
• NuGet 패키지 관리자 통해 설치된 IronOCR 패키지 라이브러리.

1. .NET MAUI 프로젝트 설정

• Visual Studio 2022를 열고 새 .NET MAUI 앱 프로젝트를 생성합니다.

• 적합한 프로젝트 이름을 선택하고 프로젝트 설정을 구성합니다.

• 대상 플랫폼 장치 개발을 위한 필수 Android 및 iOS SDK가 설치되어 있는지 확인합니다.

2. IronOCR 라이브러리 설치

• Visual Studio에서 솔루션을 마우스 오른쪽 버튼으로 클릭합니다.
  • "솔루션용 NuGet 패키지 관리"를 선택하고 브라우저 탭에서 "IronOCR"를 검색합니다.

• 프로젝트에 IronOCR 라이브러리를 설치합니다.

3. UI 설계

우리의 MainPage.xaml 레이아웃을 설계하는 것부터 시작합시다. 캡처한 사진을 표시할 이미지 컨트롤과 사진을 캡처할 Capture 버튼, 추출한 텍스트를 표시할 라벨로 간단한 레이아웃을 만듭니다.

여기에 대한 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" />

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

이 레이아웃에서:

• 컨트롤을 수직으로 쌓기 위해 VerticalStackLayout을 사용합니다.
• cameraPreview라는 이름의 Image 컨트롤은 캡처된 사진을 표시하는 데 사용됩니다.
• Button 컨트롤은 클릭 시 OnCaptureClicked 이벤트 핸들러를 트리거합니다.
• textLabel이라는 이름의 Label 컨트롤은 추출한 텍스트를 표시하는 데 사용됩니다.

4. 문서 스캐닝 기능 구현

.NET MAUI 문서 스캐닝 앱에 텍스트 추출 기능을 통합하려면 다음 단계를 수행합니다:

1. 카메라 API 활용: .NET MAUI가 제공하는 카메라 API를 활용하여 애플리케이션 내에서 직접 이미지 파일을 캡처합니다.
2. IronOCR에 이미지 전달: 이미지가 캡처되면, 이를 IronOCR에 전달하여 강력한 기능을 사용하여 텍스트를 추출합니다.
3. 추출된 텍스트 표시: 추출된 텍스트를 사용자가 볼 수 있도록 앱의 사용자 인터페이스의 지정된 영역에 표시합니다.

다음 단계들을 구현한 해당 코드 스니펫은 다음과 같습니다:

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. 문서 스캐너 앱 테스트하기

• 다양한 플랫폼(Android, iOS, Windows)에서 앱을 실행하여 크로스 플랫폼 호환성을 확인합니다.
• 다양한 글꼴, 크기 및 방향의 문서를 스캔하는 등의 다양한 시나리오를 테스트합니다.
• 추출된 텍스트가 정확하고 UI에 올바르게 표시되는지 확인합니다.

결론

이 튜토리얼을 따름으로써 .NET MAUI 내에서 IronOCR 문서 스캐너 SDK를 사용하는 방법을 배우셨습니다. 문서 스캐닝 앱은 종이 문서를 디지털화하거나 영수증 및 인보이스에서 저장된 정보를 추출하는 등 다양한 실용적인 애플리케이션을 가지고 있습니다. IronOCR의 강력한 기능과 .NET MAUI의 유연성을 통해 다양한 사용 사례에 맞는 기능이 풍부한 문서 스캐너 앱을 구축할 수 있습니다. 다양한 기능을 실험하고, 추가 라이브러리를 탐색하며, 더 인상적인 앱을 만들기 위해 스킬을 계속 향상시키십시오.

IronOCR 기능에 대한 보다 자세한 정보를 보려면 이 문서 페이지를 방문하십시오.

IronOCR는 상업 모드에서 완전한 기능을 테스트하기 위한 무료 체험판을 제공합니다. 그의 영구 lite 라이선스는 $799에서 시작합니다. 라이브러리를 다운로드 페이지에서 다운로드하고 시도해 보세요.