실시간 카메라 스캔 패턴

BarcodeScanning.Native.Maui API 패턴 전체는 XAML 컨트롤과 C# 이벤트 핸들러로 구성됩니다.

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

<scanner:CameraView x:Name="CameraView"
                    OnDetectionFinished="OnBarcodeDetected"
                    CameraEnabled="True"
                    BarcodeFormats="All" />

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

이 컨트롤을 통해 사용자는 MAUI 페이지에 내장된 실시간 뷰파인더를 사용할 수 있습니다. 바코드 감지는 카메라 피드가 활성화되는 동안 지속적으로 발생합니다. UX는 '지정하고 스캔하는' 것이 주요 상호작용인 소비자 애플리케이션에 잘 맞습니다. 제약은 이 라이브러리가 지원하는 유일한 상호작용이며, MAUI 컨텍스트에서 라이브 카메라 감지를 넘어 확장된 요구사항은 그 범위를 넘어섭니다.

상세 기능 비교

바코드 스캐닝.MAUI 접근 방식

BarcodeScanning.Native.Maui는 각 플랫폼의 네이티브 카메라 감지 파이프라인을 래핑합니다. Android에서는 ML Kit가 프레임을 처리합니다; iOS 및 macOS에서는 Apple의 Vision 프레임워크가 프레임을 처리합니다; Windows에서는 ZXingCpp가 프레임을 처리합니다. 라이브러리는 이것을 CameraView MAUI 컨트롤과 OnDetectionFinished 이벤트로 노출합니다. 애플리케이션 코드는 이미지 바이트를 직접 처리하지 않고, 이벤트에서 나오는 감지된 바코드 값만 처리합니다.

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode != null)
        ResultLabel.Text = barcode.DisplayValue;
}

Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode IsNot Nothing Then
        ResultLabel.Text = barcode.DisplayValue
    End If
End Sub

이러한 설계의 결과로 다른 진입로는 없습니다. 카메라는 선택 사항이 아닙니다. 라이브러리가 알고 있는 유일한 입력 장치입니다. 서버, 파일, PDF, 또는 MAUI가 아닌 호스트는 라이브러리에 액세스할 경로가 없습니다.

IronBarcode 접근법

IronBarcode는 BarcodeReader.Read() 정적 메서드를 통해 이미지 데이터를 수신합니다. 호출자는 어떤 출처에서든 데이터를 제공하고, 라이브러리는 이를 디코딩합니다. MAUI에서 데이터는 MediaPicker에서 가져옵니다; 서버에서는 폼 업로드를 통해 데이터가 생성됩니다. 데스크톱 애플리케이션에서는 파일 대화 상자에서 나옵니다.

//IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

//IronBarcode in MAUI: capture a photo, then read barcodes from it
// NuGet: dotnet add package IronBarcode
using IronBarCode;

private async void ScanBarcodeButton_Clicked(object sender, EventArgs e)
{
    var photo = await MediaPicker.CapturePhotoAsync();
    if (photo == null) return;

    using var stream = await photo.OpenReadAsync();
    using var ms = new MemoryStream();
    await stream.CopyToAsync(ms);

    var results = BarcodeReader.Read(ms.ToArray());
    foreach (var result in results)
        ResultLabel.Text = result.Value;
}

Imports IronBarCode
Imports System.IO
Imports Microsoft.Maui.Media

Private Async Sub ScanBarcodeButton_Clicked(sender As Object, e As EventArgs)
    Dim photo = Await MediaPicker.CapturePhotoAsync()
    If photo Is Nothing Then Return

    Using stream = Await photo.OpenReadAsync()
        Using ms As New MemoryStream()
            Await stream.CopyToAsync(ms)

            Dim results = BarcodeReader.Read(ms.ToArray())
            For Each result In results
                ResultLabel.Text = result.Value
            Next
        End Using
    End Using
End Sub

이 코드는 이미지를 캡처할 수 있는 MAUI 타겟에서 동일하게 실행됩니다. 서버 측 사용을 위해 동일한 BarcodeReader.Read() 메서드가 업로드된 파일의 바이트 배열이나 PDF 경로를 허용합니다. IronBarcode 설명서에는 지원되는 모든 입력 유형이 나와 있습니다.

바코드 스캐닝.MAUI 접근 방식

BarcodeScanning.Native.Maui는 모든 네 가지 MAUI 타겟(iOS, Android, Windows, 3.0.1 이후, 및 macOS Catalyst)을 지원하지만, 각 타겟은 다른 인식 엔진을 사용합니다: iOS 및 macOS에서는 Apple Vision, Android에서는 Google ML Kit, Windows에서 ZXingCpp. 각 엔진에서 기호학 범위와 디코딩 동작이 다르기 때문에, 한 플랫폼에서 신뢰할 수 있게 디코딩되는 바코드는 다른 플랫폼에서는 다르게 동작할 수 있습니다. MAUI가 아닌 — ASP.NET, 콘솔, WPF, WinForms, Blazor 서버, Azure Functions인 경우 라이브러리에는 구현이 없습니다. MAUI 앱과 백엔드 서비스 둘 다에서 바코드 로직이 필요한 팀은 MAUI가 아닌 코드에는 다른 라이브러리를 사용해야 합니다.

IronBarcode 접근법

IronBarcode의 BarcodeReader.Read() 호출은 모든 지원 대상에서 동일한 관리 엔진을 사용하므로, Windows, Linux, macOS, ASP.NET 및 이미지를 캡처하여 리더에 전달할 수 있는 모든 MAUI 대상에서 동작이 일관됩니다. 여기에는 #if WINDOWS 블록이 없고, 조건부 의존성 로드가 없으며, 스텁 구현이 필요하지 않습니다. 파일 및 PDF 입력의 경우에도 패턴은 일관적입니다.

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

using IronBarCode;

// Read barcodes from a file the user selected
var file = await FilePicker.PickAsync();
if (file != null)
{
    var results = BarcodeReader.Read(file.FullPath);
    foreach (var result in results)
        Console.WriteLine($"{result.Format}: {result.Value}");
}

// Read barcodes directly from a PDF — no image extraction step needed
var pdfResults = BarcodeReader.Read("shipment-manifest.pdf");

Imports IronBarCode

' Read barcodes from a file the user selected
Dim file = Await FilePicker.PickAsync()
If file IsNot Nothing Then
    Dim results = BarcodeReader.Read(file.FullPath)
    For Each result In results
        Console.WriteLine($"{result.Format}: {result.Value}")
    Next
End If

' Read barcodes directly from a PDF — no image extraction step needed
Dim pdfResults = BarcodeReader.Read("shipment-manifest.pdf")

IronBarcode MAUI 통합 가이드는 모든 MAUI 타겟에 대한 완벽한 설정 지침을 제공합니다.IronBarcode BarcodeScanning.Native.Maui에 경로가 전혀 없는 ASP.NET, Docker, Azure Functions 및 AWS Lambda 환경에서 서버 측 배포도 지원합니다.

바코드 스캐닝.MAUI 접근 방식

iOS에서, BarcodeScanning.Native.Maui의 기본 감지(Apple Vision)는 UPC-A 바코드에 대해 13자리 숫자를 반환할 수 있습니다. UPC-A는 12자리 형식입니다. 앞에 추가된 0은 EAN-13 인코딩과 일치합니다. 라이브러리는 이 원시 값을 통과시키며, 애플리케이션은 필요에 따라 정상화합니다. UPC-A 값을 데이터베이스에 정상화하지 않고 저장하는 애플리케이션은 선행 0이 있는 레코드를 누적할 수 있습니다.

문서화된 해석은 형식을 확인하고 값을 잘라내는 것입니다:

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

// Normalize iOS UPC-A — strip the leading zero when present
private void OnBarcodeDetected(object sender, OnDetectionFinishedEventArg e)
{
    var barcode = e.BarcodeResults.FirstOrDefault();
    if (barcode == null) return;

    var value = barcode.DisplayValue;
    if (barcode.BarcodeFormat == BarcodeFormats.Upca && value.Length == 13)
        value = value.Substring(1);

    ProcessBarcode(value);
}

' Normalize iOS UPC-A — strip the leading zero when present
Private Sub OnBarcodeDetected(sender As Object, e As OnDetectionFinishedEventArg)
    Dim barcode = e.BarcodeResults.FirstOrDefault()
    If barcode Is Nothing Then Return

    Dim value = barcode.DisplayValue
    If barcode.BarcodeFormat = BarcodeFormats.Upca AndAlso value.Length = 13 Then
        value = value.Substring(1)
    End If

    ProcessBarcode(value)
End Sub

0으로 시작하는 EAN-13 값이 실수로 잘리지 않도록 형식 확인이 필요합니다. PDF417은 GitHub 문제에서 '매우 문제가 많음 — 대부분의 스캔이 발생하지 않음'으로 별도로 문서화되어 있으며 이는 배송 라벨, 운전면허증, 탑승권과 관련이 있습니다.

IronBarcode 접근법

IronBarcode는 관리 엔진을 통해 표준 12자리 UPC-A 값을 반환합니다. PDF417은 지원되는 형식입니다. 생성 기능 또한 IronBarcode의 API를 통해 이용할 수 있습니다.

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

using IronBarCode;

// Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500)
    .SaveAsPng("qr.png");

// Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' Generate a QR code
QRCodeWriter.CreateQrCode("https://example.com", 500) _
    .SaveAsPng("qr.png")

' Generate a Code128 barcode
BarcodeWriter.CreateBarcode("ITEM-12345", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

바코드 데이터 정확도가 직접적으로 재고 조회, 판매 시점 거래, 공급망 통합에 영향을 미치는 애플리케이션의 경우, IronBarcode의 일관된 형식 처리가 플랫폼별 정상화 필요성을 줄입니다. IronBarcode 바코드 판독 설명서 에는 형식별 동작 방식이 자세히 설명되어 있습니다.

플랫폼 간 엔진 일관성이 필수가 됩니다

MAUI 애플리케이션이 iOS, Android, Windows, macOS를 타겟으로 할 때, BarcodeScanning.Native.Maui를 사용할 때, 세 가지 인식 엔진을 픽업합니다: Apple Vision(iOS/macOS), Google ML Kit(Android), ZXingCpp(Windows). 각 엔진은 고유의 기호학 범위 및 디코딩 동작을 가지므로, 동일한 바코드는 플랫폼 간에 다르게 디코딩될 수 있으며 — 애플리케이션은 종종 차이를 덮는 정상화 레이어를 추가합니다. 그 유지보수 오버헤드가 증가하거나, 품질 보증에서 엔진 차이에 대한 플랫폼 간 회귀를 보고할 때, 팀은 종종 모든 타겟에서 동일하게 행동하는 단일 관리 엔진으로 바코드 레이어를 이동합니다.

파일 업로드 또는 PDF 처리 요구 사항이 추가되었습니다.

모바일 애플리케이션은 처음에는 카메라 실시간 스캔을 유일한 입력 방식으로 사용하다가 나중에는 업로드된 이미지나 문서를 입력받는 기능으로 확장되는 경우가 많습니다. 사용자가 갤러리의 사진, 이메일로 받은 이미지, 혹은 배송 목록이나 탑승권이 포함된 PDF에서 바코드를 스캔해야 할 때, BarcodeScanning.Native.Maui에는 해당 입력에 대한 코드 경로가 없습니다. 이 요구사항 경계를 넘어서게 되면, 팀은 파일 및 PDF 입력을 위해 BarcodeScanning.Native.Maui와 함께 두 번째 바코드 라이브러리를 추가하거나 모든 입력 유형을 처리하는 단일 라이브러리로 마이그레이션할 수 있는 선택에 직면합니다. 다른 API와 결과 유형을 가진 두 개의 바코드 패키지를 관리하는 것은 장기적으로 복잡성을 더하며, 단일 패키지 솔루션이 이를 피할 수 있습니다.

서버 측 바코드 처리 기능 도입

모바일 기기에서 바코드를 스캔하는 애플리케이션은 종종 서버 측 구성 요소를 개발합니다. 예를 들어 바코드를 검증하는 ASP.NET API 엔드포인트, PDF를 처리하는 백그라운드 작업 또는 업로드된 문서에서 추적 번호를 추출하는 클라우드 함수 등이 있습니다. BarcodeScanning.Native.Maui는 MAUI UI 제어 라이브러리입니다; 서버 측 구현이 없습니다. 모바일과 서버 모두에서 동일한 바코드 인식 로직이 필요한 팀은 서버 측에 서로 다른 라이브러리를 사용해야 합니다. 서버 측 요구 사항이 발생하면 팀은 모바일과 서버를 모두 지원하는 단일 라이브러리로 통합하는 것이 두 개의 별도 구현을 유지하는 것보다 나은지 여부를 자주 평가합니다.

UPC-A 데이터 정상화가 우려가 됩니다

iOS UPC-A 13자리 표기법의 특성은 개발 과정에서 항상 포착되는 것은 아닙니다. 개발 중에 스캔된 UPC-A 바코드는 올바르게 작동하는 것처럼 보일 수 있지만, Apple의 Vision 프레임워크의 선행 0은 정상화가 누락될 때 데이터베이스에 나타날 수 있습니다. 인벤토리 레코드, 판매 시점 시스템, 공급망 통합에서 13자리 UPC-A 값을 발견하는 팀은 코드 수정과 데이터 수정 단계가 모두 필요할 수 있습니다. 문서화된 정상화를 추가하면 새로운 스캔을 처리합니다; 일관된 UPC-A 출력을 제공하는 라이브러리로 마이그레이션하는 것이 장기적인 해결책으로 선호되는 경우가 있습니다.

PDF417 문서 스캔 필요

PDF417은 북미 지역에서 배송 라벨, 운전면허증, 탑승권 등에 사용되는 바코드 형식입니다. 이것들은 물류, 신원 확인 및 여행 애플리케이션에서 흔히 사용되는 스캔 대상입니다. BarcodeScanning.Native.Maui의 GitHub 문제 트래커는 PDF417을 '매우 문제가 많음 — 대부분의 스캔이 발생하지 않음'으로 문서화합니다. PDF417의 신뢰성이 기능적 필요조건인 애플리케이션의 경우, 팀은 종종 대체 라이브러리를 평가합니다.

카메라 이벤트에서 MediaPicker 및 정적 읽기로의 전환

마이그레이션의 핵심 구조 변경은 MediaPicker 캡처 및 BarcodeReader.Read()로 이어지는 연속 카메라 이벤트 패턴을 대체하는 것입니다. OnDetectionFinished 이벤트 핸들러, CameraView XAML 컨트롤 및 scanner: XML 네임스페이스 선언이 모두 제거됩니다. 대신 버튼이 MediaPicker.CapturePhotoAsync()를 트리거하고 결과 사진 바이트가 BarcodeReader.Read()로 전달됩니다. 이를 통해 사용자 경험이 실시간 연속 뷰파인더에서 시스템 카메라 화면으로 변경되며, 이는 대부분의 비즈니스 애플리케이션에 적합합니다.

스레드 마샬링 변경 사항

BarcodeScanning.Native.Maui는 백그라운드 스레드에서 OnDetectionFinished를 발사하므로 UI 요소를 업데이트하는 기존 핸들러는 모두 MainThread.BeginInvokeOnMainThread()로 업데이트를 감쌉니다. IronBarcode의 MediaPicker + 비동기 패턴을 사용하면 호출 컨텍스트, 일반적으로 메인 스레드에서 await 뒤의 계속이 반환됩니다. 대부분의 경우 MainThread.BeginInvokeOnMainThread() 래퍼를 제거할 수 있어 이벤트 핸들러 코드를 단순화합니다.

UPC-A 문제 제거

BarcodeScanning.Native.Maui의 iOS UPC-A 13자릿수 동작을 처리하는 모든 코드베이스는 BarcodeFormats.Upca을 검사하고 선행 0을 제거하기 위해 Substring(1)을 호출하는 코드를 포함합니다. 이 코드는 마이그레이션 후 제거되어야 합니다 — IronBarcode는 표준 12자리 값을 반환하며, 정상화를 남겨 두면 유효한 UPC-A 읽기에서 처음 숫자를 잘못 제거할 수 있습니다.

MAUI 허가

BarcodeScanning.Native.Maui는 패키지 설정의 일환으로 Android 및 iOS 매니페스트에 카메라 권한을 자동으로 추가합니다. IronBarcode는 MediaPicker을 사용하므로 AndroidManifest.xml 및 Info.plist의 표준 MAUI 카메라 권한이 필요하며, 이는 어떤 MAUI 앱이 MediaPicker.CapturePhotoAsync()에 필요로 하는 동일한 권한입니다. 이러한 권한은 일반적으로 카메라를 어떤 용도로든 사용하는 MAUI 프로젝트에 이미 존재합니다.