Canlı Kamera Tarama Deseni

Tüm BarcodeScanning.Native.Maui API deseni, bir XAML kontrolü ile eşleşen bir C# olay işleyicisidir:

<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

Bu kontrol, kullanıcıların MAUI sayfasına gömülü gerçek zamanlı bir vizör görüntülemesini sağlar. Barkod algılama, kamera akışı aktifken sürekli olarak tetiklenir. UX, "işaretle ve tara" birincil etkileşim olduğu tüketici uygulamaları için uygun. Kısıtlama, kitaplığın desteklediği tek etkileşimin bu olmasıdır — MAUI bağlamında canlı kamera algılamanın ötesine geçen gereksinimler kapsamı dışında kalır.

Ayrıntılı Özellik Karşılaştırması

BarcodeScanning.MAUI Yaklaşımı

BarcodeScanning.Native.Maui, her platformda yerel kamera algılama hattını sarar. Android'de, ML Kit çerçeveleri işler; iOS ve macOS'ta, Apple'ın Vision çerçevesi çerçeveleri işler; Windows'da, ZXingCpp çerçeveleri işler. Kütüphane bunu bir MAUI CameraView kontrolü ve bir OnDetectionFinished olayı olarak sunar. Uygulama kodu asla doğrudan görüntü baytlarını işlemez — yalnızca olaydan çıkan algılanan barkod değerlerini işler.

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

Bu tasarımın sonucu, başka bir giriş noktası olmadığıdır. Kamera isteğe bağlı değildir — kütüphanenin bildiği tek girdidir. Bir sunucu, bir dosya, bir PDF veya herhangi bir MAUI dışı host, kütüphaneye bir yolu yoktur.

IronBarcode Yaklaşımı

IronBarcode, görüntü verilerini BarcodeReader.Read() statik metodu üzerinden alır. Çağıran, veriyi — herhangi bir kaynaktan — sağlar ve kütüphane bunu kodlar. MAUI'de, veriler MediaPicker'dan gelir; bir sunucuda, bir form yüklemesinden gelir; bir masaüstü uygulamasında, bir dosya dialog'undan gelir.

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

Bu kod, bir görüntüyü yakalayabilen MAUI hedeflerinde aynı şekilde çalışır. Sunucu tarafı kullanım için, aynı BarcodeReader.Read() metodu, bir yüklenen dosyanın bayt dizisini ya da bir PDF yolunu kabul eder. IronBarcode dokümantasyonu tüm desteklenen giriş türlerini kapsar.

BarcodeScanning.MAUI Yaklaşımı

BarcodeScanning.Native.Maui, dört MAUI hedefine (iOS, Android, Windows 3.0.1 sonrası, ve macOS Catalyst) destek sağlar, fakat her hedef farklı bir tanıma motoru kullanır: iOS ve macOS için Apple Vision, Android için Google ML Kit ve Windows için ZXingCpp. Semboloji kapsamı ve kod çözme davranışları üç motor arasında farklılık gösterir, bu yüzden bir platformda güvenilir bir şekilde çözülen bir barkod, diğerinde farklı davranabilir. MAUI dışındaki — ASP.NET, konsol, WPF, WinForms, Blazor Server, Azure Functions — kütüphanenin bir uygulaması yoktur. Hem MAUI uygulamasında hem de bir arka uç hizmetinde barkod mantığına ihtiyacı olan ekipler, MAUI dışı kod için farklı bir kütüphane kullanmalıdır.

IronBarcode Yaklaşımı

IronBarcode'un BarcodeReader.Read() çağrısı, desteklenen her hedefte aynı yönetilen motoru kullanır, bu nedenle davranışı Windows, Linux, macOS, ASP.NET ve bir görüntü yakalayıp okuyucuya iletebilen herhangi bir MAUI hedefinde tutarlıdır. Hiçbir #if WINDOWS blokları, şartlı bağımlılık yüklemesi ve yer tutucu uygulamalara gerek yoktur. Dosya ve PDF girdileri için, desen de tutarlıdır:

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 entegrasyon rehberi tüm MAUI hedefleri için tam kurulum talimatları sağlar.IronBarcode ayrıca, BarcodeScanning.Native.Maui'nin hiçbir yol sunmadığı ASP.NET, Docker, Azure Functions ve AWS Lambda ortamlarında sunucu-tarafı dağıtımı destekler.

BarcodeScanning.MAUI Yaklaşımı

iOS'ta, BarcodeScanning.Native.Maui'nin temel algılaması (Apple Vision), UPC-A barkodları için 13 hane döndürebilir. UPC-A 12 basamaklı bir formattır; fazladan baştaki sıfır EAN-13 kodlamasını eşleştirir. Kütüphane bu ham değeri geçirir ve uygulamalar gerektiği gibi normalleştirir. Veritabanına normalizasyon olmadan UPC-A değerlerini kaydeden uygulamalar, başta sıfır olan kayıtlar biriktirebilir.

Belgelenmiş geçici çözüm, formatı kontrol eder ve değeri kırpar:

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

Format kontrolü, EAN-13 değerlerinin baştan 0 ile başlayanların yanlışlıkla kırpılmaması için gereklidir. PDF417, GitHub sorunları içinde, iOS/Android motorlarında 'çok problemli — çoğu tarama asla gerçekleşmez' olarak ayrı ayrı belgelenmiştir, bu da gönderi etiketleri, ehliyetler ve biniş kartları için alakalıdır.

IronBarcode Yaklaşımı

IronBarcode, yönetilen motoru aracılığıyla standart 12 haneli UPC-A değerini döndürür. PDF417, desteklenen bir formattır. Üretim tarafı da IronBarcode'un API'si aracılığıyla kullanılabilir:

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

Barkod verisi doğruluğu stok sorgulamaları, satış noktası işlemleri veya tedarik zinciri entegrasyonlarını doğrudan etkilediğinde, IronBarcode'un tutarlı format işlemesi, platforma özgü normalizasyon ihtiyacını azaltır. IronBarcode barkod okuma dokümantasyonu format-spesifik davranışı ayrıntılı olarak ele alır.

Platformlar Arası Motor Tutarlılığı Gereklilik Haline Geliyor

iOS, Android, Windows ve macOS'u hedefleyen MAUI uygulamaları, BarcodeScanning.Native.Maui kullandıklarında üç farklı tanıma motoru alır: Apple Vision (iOS/macOS), Google ML Kit (Android), ve ZXingCpp (Windows). Her motorun kendi semboloji kapsamı ve kod çözme davranışı vardır, bu nedenle aynı barkod platformlar arasında farklı çözülebilir — ve uygulamalar genellikle farkları gidermek için normalizasyon katmanları ekler. Bu bakım yükü artarsa veya QA platformlar arası gerilemeleri motor farklarına bağlı olarak bildirirse, ekipler bazen barkod katmanını her hedefte aynı şekilde davranan tek bir yönetilen motora göç ettirir.

Dosya Yükleme veya PDF İşleme Gereksinimleri Eklendiğinde

Mobil uygulamalar genellikle tek giriş yöntemi olarak canlı kamera taramasıyla başlar ve daha sonra yüklenmiş görüntüleri veya belgeleri kabul etmeye genişler. Kullanıcının galerisindeki bir fotoğraftan, e-posta yoluyla alınan bir görüntüden veya gönderi manifestleri veya biniş kartları içeren bir PDF'den barkod taraması yapması gerektiğinde, BarcodeScanning.Native.Maui bu girişler için bir kod yolu yoktur. Bu gereklilik sınırına ulaşan ekipler bir seçimle karşı karşıya: dosya ve PDF girişleri için BarcodeScanning.Native.Maui'nin yanına ikinci bir barkod kütüphanesi eklemek veya tüm giriş türlerini işleyen tek bir kütüphaneye göç etmek. Farklı API'ler ve sonuç türleri olan iki barkod paketini yönetmek, tek paket çözümünün kaçındığı uzun vadeli bir karmaşıklık ekler.

Sunucu-Tarafı Barkod İşleme Başlatıldı

Mobilde barkod tarayan uygulamalar genellikle bir sunucu-tarafı bileşeni geliştirir — barkodları doğrulayan bir ASP.NET API uç noktası, PDF'leri işleyen bir arka plan işi veya yüklenmiş belgelerden izleme numaralarını çıkaran bir bulut fonksiyonu. BarcodeScanning.Native.Maui, bir MAUI UI kontrol kütüphanesidir; Sunucu tarafında bir uygulaması yoktur. Hem mobilde hem de sunucuda aynı barkod okuma mantığına ihtiyaç duyan bir ekip, sunucu tarafı için farklı bir kütüphane kullanmalıdır. Sunucu-tarafı gereksinimi geldiğinde, ekipler sıklıkla, hem mobil hem de sunucuya hitap eden tek bir kütüphaneye toparlamanın, iki ayrı uygulamayı sürdürmekten daha tercih edilir olup olmadığını değerlendirirler.

UPC-A Veri Normalizasyonu Kaygı Haline Geliyor

iOS UPC-A 13 basamaklı davranışı her zaman geliştirme aşamasında fark edilmez. Geliştirme aşamasında taranan UPC-A barkodları doğru çalışıyor gibi görünebilir, ancak Apple'ın Vision çerçevesinden gelen öncül sıfır, normalizasyon eksikliğinde veritabanında görünebilir. İnventör kayıtlarında, satış noktası sistemlerinde veya tedarik zinciri entegrasyonlarında 13 haneli UPC-A değerleri keşfeden ekipler hem bir kod düzeltmesine hem de bir veri düzeltme adımına ihtiyaç duyabilir. Belgelenmiş normalizasyon yeni taramaları ele alır; tutarlı UPC-A çıkısı olan bir kütüphaneye geçmek bazen uzun vadeli bir çözüm olarak tercih edilir.

PDF417 Belge Taraması Gerekli Olduğunda

PDF417, Kuzey Amerika'da sevkiyat etiketleri, ehliyetler ve biniş kartlarında kullanılan barkod formatıdır. Bunlar, lojistik, kimlik doğrulama ve seyahat uygulamaları için yaygın tarama hedefleridir. BarcodeScanning.Native.Maui'nin GitHub sorun izleyici PDF417'yi 'çok problemli — çoğu tarama asla gerçekleşmez' olarak iOS/Android motorlarında belgeler. PDF417 güvenilirliğinin işlevsel bir gereklilik olduğu uygulamalar için, ekipler genellikle alternatif kütüphaneleri değerlendirir.

Kamera Olayından Medya Seçici ve Statik Okuya Geçiş

Göçteki temel yapısal değişiklik, sürekli kamera olay deseninin yerine bir MediaPicker görüntü ile ardından BarcodeReader.Read() gelmesidir. OnDetectionFinished olay işleyicisi, CameraView XAML kontrolü ve scanner: XML ad alanı bildirimi kaldırılır. Yerine bir düğme MediaPicker.CapturePhotoAsync()'i tetikler ve sonuçta ortaya çıkan fotoğraf baytları BarcodeReader.Read()'ya iletilir. Bu, kullanıcı deneyimini canlı sürekli vizörden sistem kamera ekranına dönüştürür — çoğu iş uygulaması için uygundur.

İş Parçacığı Aktarma Değişiklikleri

BarcodeScanning.Native.Maui, OnDetectionFinished'i bir arka plan iş parçacığı üzerinde tetikler, bu nedenle UI öğelerini güncelleyen mevcut işleyicilerin tümü güncellemelerini MainThread.BeginInvokeOnMainThread() içinde sararlar.IronBarcode tarafından kullanılan MediaPicker + async deseni ile, await döndüğünde devam etme, çoğunlukla ana iş parçacığı olan çağıran bağlamda olur. Çoğu durumda, MainThread.BeginInvokeOnMainThread() sarmalayıcılar kaldırılabilir, olay işleyici kodunu basitleştirir.

UPC-A Normalizasyonunun Kaldırılması

BarcodeScanning.Native.Maui'nin iOS için UPC-A 13 haneli davranışını ele alan herhangi bir kod tabanı, BarcodeFormats.Upca kontrol eden ve önceden sıfırı çıkarmak için Substring(1) çağıran koda sahip olacaktır. Göçten sonra bu kod kaldırılmalıdır —IronBarcode standart 12 haneli değeri döndürür ve normalizasyon yerinde bırakılırsa geçerli UPC-A okumalarından ilk hane yanlışlıkla kaldırılır.

MAUI İzinleri

BarcodeScanning.Native.Maui, paket kurulumu sırasında Android ve iOS manifestlerine kamera izinleri ekler. IronBarcode, MediaPicker kullandığında, AndroidManifest.xml ve Info.plist'deki standart MAUI kamera izinleri gereklidir — herhangi bir MAUI uygulamasının MediaPicker.CapturePhotoAsync() için ihtiyaç duyduğu aynı izinler. Bu izinler, genellikle kamerayı herhangi bir amaç için kullanan MAUI projelerinde zaten mevcuttur.