Dynamsoft Barcode Reader vs IronBarcode: Porównanie bibliotek kodów kreskowych C#

Zrozumienie czytnika BarCode Dynamsoft

Architektura Dynamsoft odzwierciedla jego pochodzenie z branży fotograficznej. Sekwencja uruchamiania wymaga weryfikacji licencji online, model ustawień zawiera wartości limitu czasu zoptymalizowane pod kątem przetwarzania klatek w czasie rzeczywistym, a API udostępnia koncepcje takie jak DeblurLevel, które istnieją specjalnie dla zmiennych warunków ostrości i rozmycia ruchu w przypadku kamery ręcznej:

// Dynamsoft: license server call required at startup
using Dynamsoft.DBR;

// This call contacts Dynamsoft's license server — fails in air-gapped environments
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
    throw new InvalidOperationException($"License validation failed: {errorMsg}");

var reader = new BarcodeReader();

// Settings tuned for camera frame processing
var settings = reader.GetRuntimeSettings();
settings.DeblurLevel = 5;          // compensates for camera motion blur
settings.ExpectedBarcodesCount = 1; // camera focus: one barcode at a time
settings.Timeout = 100;             // 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings);

// Dynamsoft: license server call required at startup
using Dynamsoft.DBR;

// This call contacts Dynamsoft's license server — fails in air-gapped environments
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
    throw new InvalidOperationException($"License validation failed: {errorMsg}");

var reader = new BarcodeReader();

// Settings tuned for camera frame processing
var settings = reader.GetRuntimeSettings();
settings.DeblurLevel = 5;          // compensates for camera motion blur
settings.ExpectedBarcodesCount = 1; // camera focus: one barcode at a time
settings.Timeout = 100;             // 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings);

Imports Dynamsoft.DBR

' Dynamsoft: license server call required at startup
' This call contacts Dynamsoft's license server — fails in air-gapped environments
Dim errorCode As Integer = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.DBR_OK, Integer) Then
    Throw New InvalidOperationException($"License validation failed: {errorMsg}")
End If

Dim reader As New BarcodeReader()

' Settings tuned for camera frame processing
Dim settings = reader.GetRuntimeSettings()
settings.DeblurLevel = 5          ' compensates for camera motion blur
settings.ExpectedBarcodesCount = 1 ' camera focus: one barcode at a time
settings.Timeout = 100             ' 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings)

Jest to dobrze zaprojektowany interfejs API, dostosowany do swoich celów. Ustawienie Timeout = 100 ma sens, gdy przetwarzasz 30 klatek na sekundę z kamery i nie możesz poświęcić 500 ms na pojedynczą klatkę. W przypadku serwera przetwarzającego przesłany plik PDF limit czasu wynoszący 100 ms jest ograniczeniem, które nie ma żadnego sensu i może powodować niepowodzenia odczytu w przypadku gęstszych BARCODE-ów.

Projekt oparty na instancjach — new BarcodeReader(), reader.Dispose() — jest zgodny z semantyką sesji kamery: otwierasz sesję, przetwarzasz klatki, zamykasz sesję. W przypadku przetwarzania plików ten cykl życia dodaje szablonowy kod bez żadnych korzyści.

Problem z plikami PDF

Dynamsoft BarCode Reader nie obsługuje natywnie formatu PDF. Gdy dane wejściowe mają formę pliku PDF, kod musi najpierw przekształcić każdą stronę w obraz, a następnie przekazać ten obraz do Dynamsoft. Wymaga oddzielnej biblioteki do renderowania plików PDF — powszechnie używana jest PdfiumViewer — która dodaje zależność NuGet, natywną zależność binarną (pdfium.dll w systemie Windows lub libpdfium w systemie Linux) oraz pętlę renderowania wokół każdej operacji na pliku PDF:

// Dynamsoft PDF processing — requires PdfiumViewer (external dependency)
// dotnet add package PdfiumViewer
// dotnet add package PdfiumViewer.Native.x86_64.v8-xfa (platform-specific)
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to Dynamsoft
            TextResult[] barcodes = reader.DecodeFileInMemory(imageBytes, "");
            foreach (var b in barcodes)
                results.Add(b.BarcodeText);
        }
    }

    return results;
}

// Dynamsoft PDF processing — requires PdfiumViewer (external dependency)
// dotnet add package PdfiumViewer
// dotnet add package PdfiumViewer.Native.x86_64.v8-xfa (platform-specific)
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to Dynamsoft
            TextResult[] barcodes = reader.DecodeFileInMemory(imageBytes, "");
            foreach (var b in barcodes)
                results.Add(b.BarcodeText);
        }
    }

    return results;
}

Imports PdfiumViewer
Imports System.Drawing.Imaging
Imports Dynamsoft.DBR

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results As New List(Of String)()

    Using pdfDoc = PdfDocument.Load(pdfPath)
        For page As Integer = 0 To pdfDoc.PageCount - 1
            ' Render each page at 300 DPI
            Using image = pdfDoc.Render(page, 300, 300, True)
                Using ms As New MemoryStream()
                    image.Save(ms, ImageFormat.Png)
                    Dim imageBytes As Byte() = ms.ToArray()

                    ' Now pass rendered image bytes to Dynamsoft
                    Dim barcodes As TextResult() = reader.DecodeFileInMemory(imageBytes, "")
                    For Each b In barcodes
                        results.Add(b.BarcodeText)
                    Next
                End Using
            End Using
        Next
    End Using

    Return results
End Function

Są to trzy zależności (Dynamsoft, PdfiumViewer oraz natywny plik binarny specyficzny dla platformy), pętla renderowania na każdą stronę oraz znaczne obciążenie pamięci w przypadku dokumentów zawierających wiele stron.

IronBarcode odczytuje dane bezpośrednio z pliku PDF:

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package IronBarcode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package IronBarcode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

' IronBarcode: PDF is native — no extra library, no render loop
' NuGet: dotnet add package IronBarcode
Dim results = BarcodeReader.Read("invoice.pdf")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Jedno połączenie. Brak renderera PDF. Brak pętli na stronę. Brak natywnego pliku binarnego specyficznego dla platformy do obsługi plików PDF.

Złożoność licencji

Weryfikacja licencji online jest prosta, gdy serwer ma dostęp do Internetu. Gdy tak nie jest — lub gdy zasady sieciowe wymagają wyraźnego umieszczenia hostów wychodzących na liście dozwolonych — obszar niepowodzeń walidacji wzrasta:

// Dynamsoft: error code pattern required
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
{
    // Handle: network timeout, license server unreachable, invalid key,
    // expired key, device count exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

// Dynamsoft: error code pattern required
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
{
    // Handle: network timeout, license server unreachable, invalid key,
    // expired key, device count exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

Imports System

' Dynamsoft: error code pattern required
Dim errorCode As Integer = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.DBR_OK, Integer) Then
    ' Handle: network timeout, license server unreachable, invalid key,
    ' expired key, device count exceeded, etc.
    Throw New InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}")
End If

Licencjonowanie offline w Dynamsoft wymaga oddzielnego procesu. Aby pobrać identyfikator UUID urządzenia, należy wywołać BarcodeReader.OutputLicenseToString(), przesłać ten identyfikator do działu pomocy technicznej Dynamsoft w celu otrzymania pliku licencji dla konkretnego urządzenia, a następnie aktywować go za pomocą InitLicenseFromLicenseContent:

// Dynamsoft offline license — device UUID required
string uuid = BarcodeReader.OutputLicenseToString();
// Send uuid to Dynamsoft support → receive licenseContent string
int errorCode = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, out string errorMsg);

// Dynamsoft offline license — device UUID required
string uuid = BarcodeReader.OutputLicenseToString();
// Send uuid to Dynamsoft support → receive licenseContent string
int errorCode = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, out string errorMsg);

' Dynamsoft offline license — device UUID required
Dim uuid As String = BarcodeReader.OutputLicenseToString()
' Send uuid to Dynamsoft support → receive licenseContent string
Dim errorCode As Integer = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, errorMsg)

W środowisku Docker, gdzie kontenery są efemeryczne, a identyfikatory UUID zmieniają się przy każdym wdrożeniu, powoduje to ciągłą pracę operacyjną. Każde uruchomienie kontenera może wymagać zarejestrowania nowego identyfikatora UUID w dziale pomocy technicznej Dynamsoft.

Aktywacja licencji IronBarcode to pojedyncze zadanie oceniane lokalnie:

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-KEY";

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-KEY";

' IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-KEY"

Brak kodów błędów do sprawdzenia. Brak zależności od sieci. Brak rejestracji na urządzenie. Ten sam kod działa na komputerze deweloperskim, w potoku CI/CD, w kontenerze Docker oraz na serwerze w izolacji fizycznej.

Przykłady zastosowań: aparat vs plik

Szczerze mówiąc, Dynamsoft i IronBarcode są zoptymalizowane pod kątem różnych głównych scenariuszy. Poniższa tabela jasno to opisuje, zamiast ogłaszać, że jedna biblioteka jest ogólnie lepsza:

Zrozumienie IronBarcode

Biblioteka IronBarcode for .NET służąca zarówno do generowania, jak i odczytywania kodów kreskowych. API jest statyczne — bez instancji, bez wywołań dispose, bez cyklu życia sesji. Aktywacja licencji odbywa się lokalnie. Wbudowana obsługa plików PDF:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
    MaxParallelThreads = 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

Imports IronBarCode

' License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-KEY"

' Read from an image file
Dim results = BarcodeReader.Read("label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

' Read from a PDF — native, no extra library
Dim pdfResults = BarcodeReader.Read("manifest.pdf")

' Read with options for high-accuracy or high-throughput scenarios
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}
Dim multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options)

Generowanie jest równie proste:

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

Imports System

' Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

' Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("tracking-qr.png")

' Get bytes for HTTP response
Dim bytes As Byte() = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .ToPngBinaryData()

Porównanie funkcji

Przewodnik po mapowaniu API

Dla zespołów, które mają kod Dynamsoft i muszą zrozumieć, jak tłumaczyć pojęcia:

Kiedy zespoły się zmieniają

Przetwarzanie dokumentów po stronie serwera, a nie skanowanie za pomocą kamery. Najczęstszym scenariuszem migracji jest sytuacja, w której zespół wybrał Dynamsoft ze względu na reputację, zintegrował go, a następnie odkrył, że API skoncentrowane na kamerze i luka w obsłudze plików PDF utrudniają przepływ pracy związany z przetwarzaniem dokumentów. Odczytywanie kodów kreskowych z przesłanych plików PDF w aplikacji internetowej to podstawowy przypadek użycia, który w Dynamsoft wymaga obejść, ale w IronBarcode jest to jedno wywołanie.

Środowiska odizolowane lub o ograniczonym dostępie. Instytucje finansowe, systemy opieki zdrowotnej i wdrożenia rządowe często zabraniają wychodzących połączeń internetowych z serwerów aplikacji. W tych środowiskach weryfikacja licencji online firmy Dynamsoft kończy się niepowodzeniem. Przepływ pracy z identyfikatorem UUID urządzenia offline jest funkcjonalny, ale powoduje dodatkowe obciążenie związane z zależnością od wsparcia technicznego. Zespoły pracujące w tych środowiskach często przechodzą na IronBarcode właśnie dlatego, że weryfikacja licencji nie wymaga połączenia z siecią.

Kontenery efemeryczne Docker i Kubernetes. Wdrożenia kontenerowe, w których instancje są często skalowane w górę i w dół, sprawiają, że licencjonowanie offline oparte na urządzeniach staje się niemożliwe do zarządzania. Każdy nowy kontener może mieć inny identyfikator UUID w zależności od infrastruktury. Klucz licencyjny IronBarcode działa jako standardowa zmienna środowiskowa bez konieczności rejestracji dla poszczególnych instancji.

Potrzeba zarówno generowania, jak i odczytu. Dynamsoft jest tylko do odczytu. Aplikacje, które muszą generować etykiety z kodami BarCode, drukować kody QR dla produktów lub tworzyć listy przewozowe z wbudowanymi kodami BarCode, potrzebują drugiej biblioteki. Zespoły w takiej sytuacji często przechodzą na IronBarcode, aby uniknąć zarządzania dwiema oddzielnymi zależnościami dotyczącymi kodów kreskowych.

Uproszczony ślad operacyjny. Usunięcie serwera licencji Dynamsoft z listy zewnętrznych zależności, które muszą być dostępne, usunięcie biblioteki renderowania PDF oraz zastąpienie zarządzania instancjami wywołaniami statycznymi zmniejsza liczbę elementów, które mogą zawieść w środowisku produkcyjnym.

Wnioski

Dynamsoft BarCode Reader to wysokiej jakości biblioteka, która idealnie nadaje się do swojego przeznaczenia: skanowania kodów kreskowych w czasie rzeczywistym za pomocą kamery, zwłaszcza w aplikacjach mobilnych. Algorytmy są dobrze dostosowane do warunków skanowania ręcznego — zmiennego oświetlenia, rozmycia ruchowego, częściowego zasłonięcia. Jeśli to jest Twój przypadek użycia, Dynamsoft dobrze sobie radzi.

W przypadku przetwarzania dokumentów po stronie serwera — odczytywania kodów kreskowych z plików PDF, generowania etykiet z kodami kreskowymi, działania w środowiskach odizolowanych lub wdrażania w efemerycznych kontenerach Docker — architektura biblioteki stwarza utrudnienia na każdym etapie. Sprawdzanie licencji online, brak obsługi plików PDF, ustawienia limitu czasu zoptymalizowane pod kątem aparatu oraz przepływ pracy offline oparty na identyfikatorze UUID urządzenia są konsekwencjami tworzenia oprogramowania z myślą o wykorzystaniu aparatu w urządzeniach mobilnych. To nie są błędy; są to świadome wybory projektowe dostosowane do innego kontekstu.

IronBarcode jest przeznaczony do pracy w kontekście dokumentów i po stronie serwera. Lokalna weryfikacja licencji, natywny odczyt plików PDF, statyczne API i obsługa generowania to funkcje najwyższej klasy, a nie tylko rozwiązania zastępcze. Decyzja o migracji zależy od tego, w jakim środowisku faktycznie funkcjonują Twoje barcody.