Temel Sorun

Scandit, herhangi bir barkod çalışmalarına başlamadan önce çalışan bir kamera gerektirir.IronBarcode sadece bir dosya yolu gerektirir:

// Scandit SDK: mandatory camera pipeline before first barcode read
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");
var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});
var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;
// Results arrive later via BarcodeScanned event callback

// Scandit SDK: mandatory camera pipeline before first barcode read
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");
var settings = BarcodeCaptureSettings.Create();
settings.EnableSymbologies(new HashSet<Symbology>
{
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
});
var barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings);
var camera = Camera.GetDefaultCamera();
await dataCaptureContext.SetFrameSourceAsync(camera);
await camera.SwitchToDesiredStateAsync(FrameSourceState.On);
barcodeCapture.IsEnabled = true;
// Results arrive later via BarcodeScanned event callback

Imports Scandit.DataCapture.Core
Imports Scandit.DataCapture.Barcode
Imports System.Collections.Generic

' Scandit SDK: mandatory camera pipeline before first barcode read
Dim dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE")
Dim settings = BarcodeCaptureSettings.Create()
settings.EnableSymbologies(New HashSet(Of Symbology) From {
    Symbology.Ean13Upca,
    Symbology.Ean8,
    Symbology.Code128,
    Symbology.QrCode
})
Dim barcodeCapture = BarcodeCapture.Create(dataCaptureContext, settings)
Dim camera = Camera.GetDefaultCamera()
Await dataCaptureContext.SetFrameSourceAsync(camera)
Await camera.SwitchToDesiredStateAsync(FrameSourceState.On)
barcodeCapture.IsEnabled = True
' Results arrive later via BarcodeScanned event callback

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// IronBarcode: direct file reading
// NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

Imports IronBarCode

' IronBarcode: direct file reading
' NuGet: dotnet add package IronBarcode
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

Tüm kamera boru hattı bloğu - bağlam oluşturma, ayarlar, semboloji etkinleştirme, kamera edinme, çerçeve kaynağı atama, durum geçişi - bir lisans anahtarı atama ve tek bir yöntem çağrısı ile değiştirilir.

Adım 1: NuGet Paketini Değiştirin

Scandit paketlerini kaldırın:

dotnet remove package Scandit.BarcodePicker
dotnet remove package Scandit.DataCapture.Core
dotnet remove package Scandit.DataCapture.Barcode

dotnet remove package Scandit.BarcodePicker
dotnet remove package Scandit.DataCapture.Core
dotnet remove package Scandit.DataCapture.Barcode

IronBarcode'u kurun:

dotnet add package IronBarcode

dotnet add package IronBarcode

Adım 2: Ad Alanlarını Güncelleyin

Scandit ad alanı ithalatlarınıIronBarcode ad alanı ile değiştirin:

// Before (Scandit SDK)
using Scandit.DataCapture.Core;
using Scandit.DataCapture.Barcode;
using Scandit.DataCapture.Barcode.Data;

// After (IronBarcode)
using IronBarCode;

// Before (Scandit SDK)
using Scandit.DataCapture.Core;
using Scandit.DataCapture.Barcode;
using Scandit.DataCapture.Barcode.Data;

// After (IronBarcode)
using IronBarCode;

' Before (Scandit SDK)
Imports Scandit.DataCapture.Core
Imports Scandit.DataCapture.Barcode
Imports Scandit.DataCapture.Barcode.Data

' After (IronBarcode)
Imports IronBarCode

Adım 3: Lisansa İzin Verin

Uygulama başlangıcında lisans başlatmasını ekleyin, DataCaptureContext.ForLicenseKey çağrısını değiştirin:

// Before (Scandit SDK)
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

// After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Before (Scandit SDK)
var dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE");

// After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' Before (Scandit SDK)
Dim dataCaptureContext = DataCaptureContext.ForLicenseKey("YOUR-SCANDIT-LICENSE")

' After (IronBarcode)
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Bir Resim Dosyasından Barkodları Okuma

Statik bir görüntü dosyasını işleme, IronBarcode'da temel desteklenen bir senaryo olup, Scandit'te desteklenmeyen bir iş akışıdır. Scandit SDK, canlı kamera karelerini işler; bir dosyayı okumak, bir bitmap'i çerçeve kaynağı olarak tedavi etmek için yakalama hattını uyarlamayı gerektirir, bu da yerel bir uygulamaya sahip değildir.

Scandit SDK Yaklaşımı:

//Scandit SDKhas no direct file-read API.
// Reading a static image requires constructing a bitmap frame source
// and routing it through the capture pipeline — an unsupported workaround.
// The standard Scandit integration assumes a running camera at all times.

//Scandit SDKhas no direct file-read API.
// Reading a static image requires constructing a bitmap frame source
// and routing it through the capture pipeline — an unsupported workaround.
// The standard Scandit integration assumes a running camera at all times.

' Scandit SDK has no direct file-read API.
' Reading a static image requires constructing a bitmap frame source
' and routing it through the capture pipeline — an unsupported workaround.
' The standard Scandit integration assumes a running camera at all times.

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("product-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("product-label.png");
foreach (var result in results)
{
    Console.WriteLine($"Value: {result.Value}");
    Console.WriteLine($"Format: {result.Format}");
    Console.WriteLine($"Confidence: {result.Confidence}%");
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim results = BarcodeReader.Read("product-label.png")
For Each result In results
    Console.WriteLine($"Value: {result.Value}")
    Console.WriteLine($"Format: {result.Format}")
    Console.WriteLine($"Confidence: {result.Confidence}%")
Next

Görüntülerden barkod okuyunIronBarcode ile herhangi bir hat kurulumuna gerek yoktur. Sonuç koleksiyonu, yöntem döner dönmez kullanılabilir olup, hiçbir olay aboneliği gerektirmez.

Bir PDF Belgesinden Barkodları Çıkarmak

PDF barkod çıkarımı, Scandit'ten geçerken tamamen yeni bir alan olup, herhangi bir PDF desteğine sahip değildir. IronBarcode, PDF belgelerini doğrudan okur ve sonuçları sayfa numarası ile indeksleyerek döndürür.

Scandit SDK Yaklaşımı:

// Scandit SDK: no PDF support.
// Implementing PDF barcode extraction with Scandit requires:
// 1. A separate PDF rendering library to convert pages to raster images
// 2. Routing each rendered image through the camera simulation pipeline
// 3. Correlating results back to page numbers manually
// This is not a supported workflow and requires significant custom engineering.

// Scandit SDK: no PDF support.
// Implementing PDF barcode extraction with Scandit requires:
// 1. A separate PDF rendering library to convert pages to raster images
// 2. Routing each rendered image through the camera simulation pipeline
// 3. Correlating results back to page numbers manually
// This is not a supported workflow and requires significant custom engineering.

' Scandit SDK: no PDF support.
' Implementing PDF barcode extraction with Scandit requires:
' 1. A separate PDF rendering library to convert pages to raster images
' 2. Routing each rendered image through the camera simulation pipeline
' 3. Correlating results back to page numbers manually
' This is not a supported workflow and requires significant custom engineering.

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})");
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("shipping-manifest.pdf");
foreach (var result in results)
{
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})");
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim results = BarcodeReader.Read("shipping-manifest.pdf")
For Each result In results
    Console.WriteLine($"Page {result.PageNumber}: {result.Value} ({result.Format})")
Next

PDF belgelerinden barkod okuma, sayfa aralığı seçimi ve çoklu barkod işlemesini de içeren tam kılavuz IronBarcode belgelerinde tüm PDF işleme senaryolarını kapsar. Ek bir PDF kitaplık bağımlılığı gerekli değildir.

Olay Geri Çağırmalarını Doğrudan Dönüş Değerlerine Dönüştürme

Scandit, barkod sonuçlarını BarcodeScanned olayı aracılığıyla iletir çünkü canlı kamera taraması doğası gereği eşzamansızdır — kamera, geçerli karede bir barkod algıladığında sonuçlar ulaşır. IronBarcode, dosya tabanlı okuma belirli bir tamamlanma sınırına sahip olduğundan sonuçları bir türlendirilmiş koleksiyon olarak döndürür. Bu, geçişteki en yapısal olarak önemli değişikliklerden biridir.

Scandit SDK Yaklaşımı:

// Scandit SDK: event-driven result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();

        // Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology);
        UpdateInventory(value);
    }
};

// Scan continues indefinitely until camera session is terminated

// Scandit SDK: event-driven result delivery
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
    {
        string value = barcode.Data;
        string symbology = barcode.Symbology.ToString();

        // Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology);
        UpdateInventory(value);
    }
};

// Scan continues indefinitely until camera session is terminated

Imports System

' Scandit SDK: event-driven result delivery
AddHandler barcodeCapture.BarcodeScanned, Sub(sender, args)
    For Each barcode In args.Session.NewlyRecognizedBarcodes
        Dim value As String = barcode.Data
        Dim symbology As String = barcode.Symbology.ToString()

        ' Processing logic embedded inside event handler
        LogBarcodeResult(value, symbology)
        UpdateInventory(value)
    Next
End Sub

' Scan continues indefinitely until camera session is terminated

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("document.png");
foreach (var result in results)
{
    // Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString());
    UpdateInventory(result.Value);
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var results = BarcodeReader.Read("document.png");
foreach (var result in results)
{
    // Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString());
    UpdateInventory(result.Value);
}

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim results = BarcodeReader.Read("document.png")
For Each result In results
    ' Same processing logic, now in standard control flow
    LogBarcodeResult(result.Value, result.Format.ToString())
    UpdateInventory(result.Value)
Next

Olay işlemci geri çağrımlarına gömülen tüm işlem mantığı, standart sırayla çalıştırılacak olan koda taşınır. Hata ayıklama, günlükleme ve aşağı yönlü işlemler, olay yöneticisi desenleri yerine olağan kontrol akışını kullanarak yapılandırılabilir.

ASP.NET Core Dosya Yükleme Uç Noktası

Yüklenen bir dosyadan barkod okuyabilen durumdan bağımsız bir sunucu uç noktası,IronBarcode için birincil sunucu tarafı kullanım senaryosunu temsil eder. Bu desen, Scandit'in kamera hattı mimarisi tarafından desteklenmez.

Scandit SDK Yaklaşımı:

// Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
// The DataCaptureContext requires a camera hardware session.
// There is no mechanism to process an IFormFile through the Scandit pipeline
// without substantial custom camera-simulation infrastructure.

// Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
// The DataCaptureContext requires a camera hardware session.
// There is no mechanism to process an IFormFile through the Scandit pipeline
// without substantial custom camera-simulation infrastructure.

' Scandit SDK: not applicable to ASP.NET Core file upload scenarios.
' The DataCaptureContext requires a camera hardware session.
' There is no mechanism to process an IFormFile through the Scandit pipeline
' without substantial custom camera-simulation infrastructure.

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult ScanUploadedDocument(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("No file provided");

        using var stream = file.OpenReadStream();
        var results = BarcodeReader.Read(stream);

        if (!results.Any())
            return NotFound("No barcodes detected");

        return Ok(results.Select(r => new
        {
            r.Value,
            Format = r.Format.ToString(),
            r.PageNumber
        }));
    }
}

// NuGet: dotnet add package IronBarcode
using IronBarCode;

[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult ScanUploadedDocument(IFormFile file)
    {
        if (file == null || file.Length == 0)
            return BadRequest("No file provided");

        using var stream = file.OpenReadStream();
        var results = BarcodeReader.Read(stream);

        if (!results.Any())
            return NotFound("No barcodes detected");

        return Ok(results.Select(r => new
        {
            r.Value,
            Format = r.Format.ToString(),
            r.PageNumber
        }));
    }
}

Imports IronBarCode
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class BarcodeController
    Inherits ControllerBase

    <HttpPost("scan")>
    Public Function ScanUploadedDocument(file As IFormFile) As IActionResult
        If file Is Nothing OrElse file.Length = 0 Then
            Return BadRequest("No file provided")
        End If

        Using stream = file.OpenReadStream()
            Dim results = BarcodeReader.Read(stream)

            If Not results.Any() Then
                Return NotFound("No barcodes detected")
            End If

            Return Ok(results.Select(Function(r) New With {
                .Value = r.Value,
                .Format = r.Format.ToString(),
                .PageNumber = r.PageNumber
            }))
        End Using
    End Function
End Class

BarcodeReader.Read yöntemi, Stream doğrudan IFormFile.OpenReadStream()'dan kabul eder ve geçici dosya oluşturulması gerekmez. Sonuçlar, asenkron kamera yönetimi olmadan, istek-yanıt döngüsü içinde eşzamanlı olarak döndürülür.

Birden Çok Belge Arasında Eşzamanlı Toplu İşleme

Yüksek hacimli belge kuyrukları, birden fazla iş parçacığı arasında paralel işlemeye ihtiyaç duyar. IronBarcode'un API'si durumsuz olduğundan, doğası gereği thread-safe'dir ve doğrudan Parallel.ForEach ve eşzamansız görev desenleriyle uyum sağlar.

Scandit SDK Yaklaşımı:

// Scandit SDK: no supported batch file processing pattern.
// The FrameSourceState model assumes a continuous camera session,
// not a queue of discrete documents. Batch processing would require
// one camera simulation pipeline per document or serialized processing
// through a shared pipeline — neither is a supported workflow.

// Scandit SDK: no supported batch file processing pattern.
// The FrameSourceState model assumes a continuous camera session,
// not a queue of discrete documents. Batch processing would require
// one camera simulation pipeline per document or serialized processing
// through a shared pipeline — neither is a supported workflow.

' Scandit SDK: no supported batch file processing pattern.
' The FrameSourceState model assumes a continuous camera session,
' not a queue of discrete documents. Batch processing would require
' one camera simulation pipeline per document or serialized processing
' through a shared pipeline — neither is a supported workflow.

IronBarcode Yaklaşımı:

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Collections.Concurrent;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var files = Directory.GetFiles("./documents/", "*.pdf");
var allResults = new ConcurrentBag<(string File, BarcodeResult Result)>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var result in results)
        allResults.Add((file, result));
});

foreach (var (file, result) in allResults)
    Console.WriteLine($"{Path.GetFileName(file)}: {result.Value} ({result.Format})");

// NuGet: dotnet add package IronBarcode
using IronBarCode;
using System.Collections.Concurrent;

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

var files = Directory.GetFiles("./documents/", "*.pdf");
var allResults = new ConcurrentBag<(string File, BarcodeResult Result)>();

Parallel.ForEach(files, file =>
{
    var results = BarcodeReader.Read(file, options);
    foreach (var result in results)
        allResults.Add((file, result));
});

foreach (var (file, result) in allResults)
    Console.WriteLine($"{Path.GetFileName(file)}: {result.Value} ({result.Format})");

Imports IronBarCode
Imports System.Collections.Concurrent
Imports System.IO
Imports System.Threading.Tasks

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim files = Directory.GetFiles("./documents/", "*.pdf")
Dim allResults As New ConcurrentBag(Of (File As String, Result As BarcodeResult))()

Parallel.ForEach(files, Sub(file)
    Dim results = BarcodeReader.Read(file, options)
    For Each result In results
        allResults.Add((file, result))
    Next
End Sub)

For Each item In allResults
    Console.WriteLine($"{Path.GetFileName(item.File)}: {item.Result.Value} ({item.Result.Format})")
Next

Asenkron ve çok iş parçacıklı barkod okuma kapsayan ileri düzey modeller için, throughput ayarlama ve iş parçacığı sayısı yapılandırması da dahil olmak üzere IronBarcode belgeleri detaylı bir kılavuz sağlar.

Sorun 1: Kamera Hattı Kodunun Doğrudan Çevirisi Yok

Scandit SDK: DataCaptureContext, BarcodeCaptureSettings, Camera ve BarcodeCapture kurulum bloğu, eşzamansız durum geçişleriyle 7 ila 10 satır başlangıç kodunu kapsar.

Çözüm: Bu blok tamamen silinir. IronBarcode'un dosya tabanlı API'si herhangi bir oturum başlatma gerektirmediği için eşdeğeri yoktur. Tüm bloğu şununla değiştirin:

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

Imports IronBarCode

IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Sorun 2: BarcodeScanned Olay Yöneticisi Mantığı

Scandit SDK: İşleme mantığı, BarcodeScanned += olay işleyici lambda fonksiyonlarında veya metodlarında gömülüdür. Bu desen IronBarcode içinde mevcut değildir.

Çözüm: İşleyicinin gövdesini BarcodeReader.Read çağrısından sonra gelen standart koda taşıyın:

// Before: event handler
barcodeCapture.BarcodeScanned += (s, args) =>
{
    foreach (var b in args.Session.NewlyRecognizedBarcodes)
        Console.WriteLine(b.Data);
};

// After: direct iteration
foreach (var result in BarcodeReader.Read("document.png"))
    Console.WriteLine(result.Value);

// Before: event handler
barcodeCapture.BarcodeScanned += (s, args) =>
{
    foreach (var b in args.Session.NewlyRecognizedBarcodes)
        Console.WriteLine(b.Data);
};

// After: direct iteration
foreach (var result in BarcodeReader.Read("document.png"))
    Console.WriteLine(result.Value);

Imports System

' Before: event handler
AddHandler barcodeCapture.BarcodeScanned, Sub(s, args)
    For Each b In args.Session.NewlyRecognizedBarcodes
        Console.WriteLine(b.Data)
    Next
End Sub

' After: direct iteration
For Each result In BarcodeReader.Read("document.png")
    Console.WriteLine(result.Value)
Next

Sorun 3: EnableSymbologies Çağrılarının Kod Tabanı İçinde Dağılmış Olması

Scandit SDK: Kod tabanında birden fazla yer, farklı tarama bağlamları için farklı semboloji setleriyle settings.EnableSymbologies(...) çağrılabilir.

Çözüm: Tüm EnableSymbologies çağrılarını kaldırın. IronBarcode, varsayılan olarak tüm desteklenen formatları otomatik olarak algılar. Belirli senaryolarda performans için format kısıtlaması gerekiyorsa, BarcodeReaderOptions.ExpectBarcodeTypes kullanın:

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("document.png", options);

var options = new BarcodeReaderOptions
{
    ExpectBarcodeTypes = BarcodeEncoding.Code128 | BarcodeEncoding.QRCode
};
var results = BarcodeReader.Read("document.png", options);

Imports System

Dim options As New BarcodeReaderOptions With {
    .ExpectBarcodeTypes = BarcodeEncoding.Code128 Or BarcodeEncoding.QRCode
}
Dim results = BarcodeReader.Read("document.png", options)

Sorun 4: Mevcut Kod Tabanında PDF Okuma Yok

Scandit SDK: Mevcut kod tabanı PDF sayfalarını Scandit hattına beslemeden önce görüntülere dönüştürüyorsa, bu özel oluşturma altyapısına artık ihtiyaç yoktur.

Çözüm: PDF'den görüntüye render etme adımını tamamen kaldırın. PDF yolunu doğrudan IronBarcode'a geçirin:

// Before: render PDF pages to images, then pass each image to Scandit pipeline
// (multiple steps, external PDF library dependency)

// After: pass PDF directly to IronBarcode
var results = BarcodeReader.Read("document.pdf");
// Results include PageNumber property for each detected barcode

// Before: render PDF pages to images, then pass each image to Scandit pipeline
// (multiple steps, external PDF library dependency)

// After: pass PDF directly to IronBarcode
var results = BarcodeReader.Read("document.pdf");
// Results include PageNumber property for each detected barcode

' Before: render PDF pages to images, then pass each image to Scandit pipeline
' (multiple steps, external PDF library dependency)

' After: pass PDF directly to IronBarcode
Dim results = BarcodeReader.Read("document.pdf")
' Results include PageNumber property for each detected barcode

Sorun 5: Asenkron Kamera Başlatma Kalıpları

Scandit SDK: Kamera başlatma, await kullanır, SetFrameSourceAsync ve SwitchToDesiredStateAsync için. Eğer çağrılan kod bu asenkron işlemler etrafında yapılandırıldıysa, onları kaldırmak, asenkron zinciri basitleştirir.

Çözüm: Asenkron kamera başlatmayı tamamen kaldırın. BarcodeReader.Read eşzamansızdır. Bir UI veya sunucu bağlamında yanıt verebilirliği artırmak için eşzamansız yürütme gerekiyorsa, Task.Run içinde sarmalayın:

// Async wrapper for non-blocking execution
var results = await Task.Run(() => BarcodeReader.Read("document.png"));

// Async wrapper for non-blocking execution
var results = await Task.Run(() => BarcodeReader.Read("document.png"));

Imports System.Threading.Tasks

' Async wrapper for non-blocking execution
Dim results = Await Task.Run(Function() BarcodeReader.Read("document.png"))

Geçiş Öncesi Görevler

Kod tabanında tüm Scandit entegrasyon noktalarını denetleyin:

grep -r "DataCaptureContext\|BarcodeCaptureSettings\|BarcodeCapture" --include="*.cs" .
grep -r "EnableSymbologies\|BarcodeScanned\|NewlyRecognizedBarcodes" --include="*.cs" .
grep -r "using Scandit" --include="*.cs" .
grep -r "barcode\.Data\|barcode\.Symbology\|FrameSourceState" --include="*.cs" .

grep -r "DataCaptureContext\|BarcodeCaptureSettings\|BarcodeCapture" --include="*.cs" .
grep -r "EnableSymbologies\|BarcodeScanned\|NewlyRecognizedBarcodes" --include="*.cs" .
grep -r "using Scandit" --include="*.cs" .
grep -r "barcode\.Data\|barcode\.Symbology\|FrameSourceState" --include="*.cs" .

Tüm tarama context'lerini belgeleyin — gerçek zamanlı kamera taraması ile hangi kod yollarının ilgilendiğini (Scandit'te kalan) ve dosya veya belge işlemenin hangileriyle ilgilendiğini (IronBarcode'a geçiş yapan) belirleyin. Scandit işleme öncesi PDF sayfalarının görüntülere render edildiği tüm yerleri not edin, çünkü bu oluşturma adımı ortadan kalkacaktır.

Kod Güncelleme Görevleri

1. Scandit NuGet paketlerini kaldırın (Scandit.BarcodePicker, Scandit.DataCapture.Core, Scandit.DataCapture.Barcode)
2. IronBarcode NuGet paketini yükleyin
3. using Scandit.DataCapture.* içe aktarmalarını using IronBarCode ile değiştirin
4. DataCaptureContext başlatma bloğunu tamamen silin
5. Tüm Camera.GetDefaultCamera() ve SetFrameSourceAsync çağrılarını silin
6. Tüm EnableSymbologies çağrılarını silin
7. barcodeCapture.IsEnabled = true'yi BarcodeReader.Read(filePath) ile değiştirin
8. BarcodeScanned += olay işleyicilerini BarcodeReader.Read() sonuçları üzerinde foreach'ya dönüştürün
9. barcode.Data'yi result.Value ile değiştirin
10. barcode.Symbology'yi result.Format ile değiştirin 11.IronBarcode artık PDF'leri doğrudan okuduğunda PDF'den görüntüye render etme hatlarını kaldırın
11. Uygulama başlangıcında IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY" ekleyin

Geçiş Sonrası Testler

Kod güncellemelerinden sonra aşağıdakileri doğrulayın:

-IronBarcode tarafından döndürülen barkod değerlerinin, aynı giriş belgeleri için daha önce Scandit tarafından döndürülen değerlerle eşleştiğini doğrulayın

• Belge setinde desteklenen tüm barkod formatlarının ExpectBarcodeTypes yapılandırmasına gerek kalmadan algılandığını doğrulayın
• Çok sayfalı belgeler için test PDF çıkarımı doğru PageNumber değerlerini döndürdüğünü kontrol edin
• ASP.NET Core uç noktalarının, beklenen yük altında kabul edilebilir yanıt süreleri içinde sonuçları döndürdüğünü doğrulayın
• Docker veya konteynerleştirilmiş dağıtımların, kamera donanımı olmadan barkod okuma işlemlerini başarıyla tamamladığını doğrulayın
• Parallel.ForEach ile eşzamanlı toplu işleme, yarış koşulları olmadan doğru sonuçlar ürettiği testi -IronBarcode lisans anahtarı ile uygulamanın Scandit bağlamının yerini alarak doğru başladığını ve başlatıldığını doğrulayın