Pipeline DataCaptureContext

Każda integracja Scandit rozpoczyna się od sekwencji inicjalizacji kamery, zanim będzie można odczytać choćby jeden BARCODE:

// Scandit SDK: full camera pipeline setup
// NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

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;

// Scandit SDK: full camera pipeline setup
// NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

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;

Imports Scandit.DataCapture.Core.Maui
Imports Scandit.DataCapture.Barcode.Maui

' Scandit SDK: full camera pipeline setup
' NuGet: Scandit.DataCapture.Core.Maui, Scandit.DataCapture.Barcode.Maui

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

Każda linia w tym bloku konfiguruje infrastrukturę kamery. Interfejs API nie ujawnia ścieżki pliku, PDF lub argumentu strumienia w tym punkcie wejściowym - zakłada, że uruchomiono kamerę przed rozpoczęciem pracy z kodem kreskowym.

Szczegółowe porównanie funkcji

Podejście Scandit SDK

Scandit przetwarza ramki kamery w czasie rzeczywistym. DataCaptureContext utrzymuje aktywną sesję kamery, a BarcodeCapture nasłuchuje kodów kreskowych w każdej przychodzącej ramce. Wyniki kodu kreskowego są dostarczane asynchronicznie poprzez zdarzenie BarcodeScanned. Odczytanie statycznego pliku obrazu za pomocą Scandit wymaga dostosowania potoku kamery tak, aby traktował plik jako źródło klatek — jest to proces, który nie jest obsługiwany natywnie i wymaga nakładu pracy inżynieryjnej w celu jego przybliżenia.

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

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

Imports System

' Scandit SDK: event-callback 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()
        ProcessBarcode(value, symbology)
    Next
End Sub

Model sterowany zdarzeniami jest odpowiedni do ciągłego skanowania na żywo, gdzie BARCODES pojawiają się w strumieniu wideo w sposób nieprzewidywalny. W przypadku przetwarzania opartego na plikach model wprowadza niepotrzebną złożoność: dane wejściowe mają znaną granicę zakończenia, sesja kamery nigdy nie kończy się w sposób naturalny, a asynchroniczny wzorzec wywołania zwrotnego nie współgra dobrze z architekturami serwerowymi typu żądanie-odpowiedź.

Podejście IronBarcode

IronBarcode traktuje każde wprowadzone dane jako odrębny dokument o deterministycznym wyniku. Metoda BarcodeReader.Read akceptuje ścieżkę do pliku, strumień lub tablicę bajtów, wykonuje wszystkie wykrywania synchronicznie i zwraca kolekcję wyników. Nie ma sesji do otwarcia, źródła ramki do skonfigurowania ani zdarzenia, na które można się zapisać.

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

W przypadku odczytu BarCodes z obrazów bezstanowe API nie wymaga żadnej inicjalizacji poza kluczem licencyjnym. Wykrywanie formatu odbywa się automatycznie. Powyższy kompletny program odczytuje dowolny obsługiwany format BARCODE z pliku obrazu za pomocą trzech wierszy kodu operacyjnego.

Podejście Scandit SDK

Architektura Scandit wymaga sprzętu kamerowego oraz platformy mobilnej, która może udostępniać go za pośrednictwem natywnego interfejsu API kamery. Głównymi obsługiwanymi platformami są iOS i Android. Komputery stacjonarne z systemem Windows stanowią drugorzędną grupę docelową. ASP.NET Core, Azure Functions, kontenery Docker i serwery Linux nie wchodzą w zakres projektu biblioteki. DataCaptureContext zakłada uruchomioną sesję kamery, co nie ma odpowiednika w środowiskach obliczeń bezserwerowych, wdrożeniach w kontenerach lub usługach przetwarzania w tle.

Podejście IronBarcode

IronBarcode został stworzony z myślą o środowiskach serwerowych, chmurowych i kontenerowych. Bezstanowe API nie ma żadnych zależności sprzętowych ani wymagań dotyczących inicjalizacji specyficznych dla platformy. Wdrożenie w Azure Functions w celu przetwarzania kodów kreskowych jest obsługiwanym i udokumentowanym rozwiązaniem. Docker na systemie Linux jest standardowym celem wdrożenia. Punkty końcowe .NET Core odczytujące BARCODES z przesłanych plików stanowią podstawowy obsługiwany scenariusz, który nie wymaga żadnych architektonicznych obejść.

Podejście Scandit SDK

Potok kamery Scandit został zaprojektowany dla jednej sesji kamery, obsługującej jednego użytkownika lub urządzenie. Model FrameSourceState zakłada trwałą, ciągłą sesję kamery — a nie kolejkę dokumentów przetwarzanych w przepustowości. Dostosowanie biblioteki do przetwarzania partii plików wymaga symulacji sesji kamery dla każdego dokumentu lub serializacji przetwarzania dokumentów za pośrednictwem wspólnego potoku, z których żadne nie stanowi obsługiwanego ani wydajnego wzorca.

Podejście IronBarcode

Ponieważ metoda BarcodeReader.ReadIronBarcode jest bezstanowa, jest z natury bezpieczna do wywołania z wielu wątków jednocześnie. Przetwarzanie wsadowe równoległe nie wymaga specjalnej konfiguracji poza zdefiniowaniem BarcodeReaderOptions:

// IronBarcode: concurrent batch processing
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

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

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

// IronBarcode: concurrent batch processing
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};

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

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

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

' IronBarcode: concurrent batch processing
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}

Dim files = Directory.GetFiles("./incoming/", "*.pdf")
Dim allResults As New ConcurrentBag(Of BarcodeResult)()

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

Szczegółowe wzorce dotyczące asynchronicznego i wielowątkowego odczytu kodów kreskowych można znaleźć w dokumentacji IronBarcode, która obejmuje wzorce bezpieczne dla wątków oraz opcje optymalizacji przepustowości.

Podejście Scandit SDK

Scandit nie obsługuje natywnie formatu PDF. Wyodrębnianie kodów kreskowych z pliku PDF za pomocą Scandit wymaga renderowania każdej strony PDF do obrazu rastrowego przy użyciu oddzielnej biblioteki renderującej PDF, a następnie przekazania tych obrazów przez potok symulacji kamery. Takie podejście wprowadza dodatkową zależność, dodatkowe koszty licencji i znaczny nakład pracy inżynieryjnej dla zadania, które jest rutynowe w procesach przetwarzania dokumentów. Dokumenty wielostronicowe wymagają iteracji stron, zarządzania pamięcią dla renderowanych obrazów oraz ręcznej koordynacji wyników między stronami.

Podejście IronBarcode

IronBarcode natywnie odczytuje kody kreskowe z dokumentów PDF. Ścieżka do pliku PDF to ważny argument dla BarcodeReader.Read, a wyniki obejmują właściwość PageNumber wskazującą, na której stronie dokumentu znaleziono każdy kod kreskowy:

// IronBarcode: extract barcodes from every page of a PDF
var results = BarcodeReader.Read("shipping-manifest.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

// IronBarcode: extract barcodes from every page of a PDF
var results = BarcodeReader.Read("shipping-manifest.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})");
}

Imports IronBarcode

' IronBarcode: extract barcodes from every page of a PDF
Dim results = BarcodeReader.Read("shipping-manifest.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Value} ({barcode.Format})")
Next

Pełne wytyczne dotyczące odczytu kodów kreskowych z plików PDF, w tym opcje wyboru zakresu stron i wyodrębniania wielu kodów kreskowych, można znaleźć w dokumentacji IronBarcode, która obejmuje pełen zakres scenariuszy przetwarzania plików PDF.

Podejście firmy Scandit

Scandit nie publikuje cennika. Strona produktu wymienia funkcje i nazwy produktów – SparkScan, MatrixScan, ID Scanning, AR Overlays, Parser – i kieruje zapytania cenowe przez rozmowę sprzedażową. Proces cytowania zazwyczaj obejmuje opisanie przypadku użycia, szacowanie ilości skanowania, określenie urządzeń, omówienie poziomów wsparcia i wybranie długości umowy przed przedstawieniem kwoty kosztów. Każda linia produktów Scandit jest osobno wyceniona i osobno kontraktowana, więc rozszerzenie dostępu do funkcji może wymagać dodatkowego cyklu sprzedażowego.

Podejście IronBarcode

IronBarcode publikuje informacje o poziomach licencji na stronie produktu bez konieczności wypełniania formularza lub wysyłania zapytania handlowego:

Licencje są bezterminowe. Nie ma opłat za skanowanie, opłat za urządzenie ani progów ilościowych, które powodowałyby zmiany poziomu taryfowego. Roczne odnowienie jest opcjonalne i kosztuje połowę pierwotnej ceny, ale zakupiona licencja pozostaje ważna bez konieczności odnawiania. Wszystkie funkcje zawarte w pakiecie IronBarcode— odczyt, generowanie, obsługa plików PDF, wykrywanie wielu kodów kreskowych — są dostępne na każdym poziomie.

Wymagania dotyczące przetwarzania po stronie serwera

Zespoły budujące API ASP.NET Core, usługi przetwarzania w tle lub funkcje Azure stwierdzają, że architektura Scandit jest zorientowana na założenia, które nie mają zastosowania w środowisku serwerowym. Potok DataCaptureContext oraz kamera oczekują sprzętu kamery i źródła ramki na żywo. Kiedy wymagania dotyczące kodów kreskowych w projekcie są całkowicie po stronie serwera — odczytywanie z przesłanych plików, przetwarzanie kolejek dokumentów, wyodrębnianie danych kodu kreskowego z nadchodzących PDF-ów — pipeline kamery dodaje kroki inicjalizacji i ograniczenia platformowe, które nie mają znaczenia dla obciążenia.

Przetwarzanie dokumentów w trybie wsadowym

Organizacje przetwarzające duże ilości dokumentów zawierających kody kreskowe — listy przewozowe, faktury, rejestry inwentarzowe, formularze medyczne — stwierdzają, że model źródła klatek Scandit jest zorientowany na ciągłe sesje kamery, a nie na dyskretne dokumenty z deterministycznymi punktami startu i zakończenia. Gdy objętość dokumentów rośnie, a przetwarzanie równoległe staje się konieczne, zaprojektowana jako stanowa ścieżka kamery wymaga dodatkowego inżynierii, aby się dostosować.

Przejrzystość cen

Zespoły deweloperskie pracujące nad propozycjami budżetowymi, porównaniami dostawców lub analizami kosztów i korzyści dla nowych projektów potrzebują rozmowy sprzedażowej, aby określić koszt licencji Scandit. Kiedy projekt ma określony budżet i określony harmonogram, wymaganie rozmowy sprzedażowej do uzyskania oferty cenowej dodaje kroki do oceny i planowania. Zespoły oceniające jednocześnie kilka opcji bibliotek mogą stwierdzić, że brak opublikowanego cennika utrudnia skonstruowane porównania obok siebie.

Zmniejszenie złożoności potoku

Nawet gdy Scandit jest już wdrożony do skanowania kamerą mobilną, wymagania dotyczące kodów kreskowych po stronie serwera w tej samej aplikacji mogą wymagać innego narzędzia. Ścieżka kamery, która pasuje do skanowania w czasie rzeczywistym na urządzeniach mobilnych, dodaje złożoność, gdy jest stosowana do przetwarzania dokumentów statycznych. Zespoły, które osiągnęły ten punkt, często przyjmująIronBarcode do przetwarzania po stronie serwera obok istniejącego wdrożenia Scanbot, zamiast rozszerzania ścieżki kamery o przepływy pracy dokumentu.

Pipeline kamery nie ma odpowiednika w postaci pliku

Cały blok inicjalizacji DataCaptureContext — tworzenie kontekstu, konfiguracja ustawień, włączenie symbologii, pozyskanie kamery, przypisanie źródła ramki i przejście stanu — nie ma odpowiednika w API opartym na plikach IronBarcode. Podczas migracji kodu integracji po stronie serwera ten blok jest usuwany w całości. Nie jest przetłumaczone; zostaje usunięte. Zamiennik IronBarcode to przypisanie klucza licencyjnego, a następnie wywołanie BarcodeReader.Read.

Wywołanie zwrotne zdarzenia do bezpośredniego powrotu

Scandit dostarcza wyniki kodu kreskowego poprzez zdarzenie BarcodeScanned, ponieważ skanowanie kamery na żywo jest z natury asynchroniczne.IronBarcode zwraca wyniki synchronicznie jako kolekcję typowaną, ponieważ odczyt oparty na plikach ma znaną granicę zakończenia. Migracja polega na przekształceniu logiki obsługi zdarzeń na standardową iterację:

// Scandit callback pattern (removed during migration)
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString());
};

//IronBarcode direct return (replacement)
foreach (var result in BarcodeReader.Read("document.png"))
    ProcessBarcode(result.Value, result.Format.ToString());

// Scandit callback pattern (removed during migration)
barcodeCapture.BarcodeScanned += (sender, args) =>
{
    foreach (var barcode in args.Session.NewlyRecognizedBarcodes)
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString());
};

//IronBarcode direct return (replacement)
foreach (var result in BarcodeReader.Read("document.png"))
    ProcessBarcode(result.Value, result.Format.ToString());

Imports System.Collections.Generic

' Scandit callback pattern (removed during migration)
AddHandler barcodeCapture.BarcodeScanned, Sub(sender, args)
    For Each barcode In args.Session.NewlyRecognizedBarcodes
        ProcessBarcode(barcode.Data, barcode.Symbology.ToString())
    Next
End Sub

' IronBarcode direct return (replacement)
For Each result In BarcodeReader.Read("document.png")
    ProcessBarcode(result.Value, result.Format.ToString())
Next

Usunięcie deklaracji symbologii

Scandit wymaga wyraźnych wywołań EnableSymbologies przed rozpoczęciem skanowania.IronBarcode nie wymaga wstępnego deklarowania symboli — wszystkie formaty są wykrywane automatycznie. Podczas migracji wszystkie wywołania settings.EnableSymbologies(...) są usuwane. Jeśli oryginalny kod Scandit ograniczał symbologie ze względu na wydajność, odpowiednia optymalizacja w IronBarcode jest dostępna przez BarcodeReaderOptions.ExpectBarcodeTypes, ale nie jest wymagana do rozpoczęcia.