Jak wygląda architektura Barkoder

Rdzeń SDK w języku C/C++ obsługuje przetwarzanie obrazów. Opakowania iOS i Android udostępniają rdzeń poprzez natywne API platformy. Na .NET, wtyczki MAUI i Xamarin opakowują te same natywne SDK i udostępniają kontrolkę BarkoderView:

// dotnet add package Plugin.Maui.Barkoder
// XAML hosts a BarkoderView; this is the code-behind callback.
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.SetZoomFactor(1.5f);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
            Console.WriteLine($"Value: {r.TextualData}");
        }
    }
}

// dotnet add package Plugin.Maui.Barkoder
// XAML hosts a BarkoderView; this is the code-behind callback.
using Barkoder.Maui;

public partial class ScanPage : ContentPage, IBarkoderDelegate
{
    public ScanPage()
    {
        InitializeComponent();
        BarkoderView.SetFlashEnabled(false);
        BarkoderView.SetZoomFactor(1.5f);
        BarkoderView.StartScanning(this);
    }

    public void DidFinishScanning(BarcodeResult[] result)
    {
        foreach (var r in result)
        {
            Console.WriteLine($"Type: {r.BarcodeTypeName}");
            Console.WriteLine($"Value: {r.TextualData}");
        }
    }
}

Imports Barkoder.Maui

Public Partial Class ScanPage
    Inherits ContentPage
    Implements IBarkoderDelegate

    Public Sub New()
        InitializeComponent()
        BarkoderView.SetFlashEnabled(False)
        BarkoderView.SetZoomFactor(1.5F)
        BarkoderView.StartScanning(Me)
    End Sub

    Public Sub DidFinishScanning(result As BarcodeResult()) Implements IBarkoderDelegate.DidFinishScanning
        For Each r In result
            Console.WriteLine($"Type: {r.BarcodeTypeName}")
            Console.WriteLine($"Value: {r.TextualData}")
        Next
    End Sub
End Class

To działa wewnątrz mobilnej aplikacji MAUI z żywą kamerą. Nie ma przeciążenia pliku, brak przeciążenia strumienia, brak przeciążenia PDF i brak równoważnej powierzchni dla ASP.NET Core, konsoli czy projektów desktopowych. Natywne ścieżki kodu iOS i Android korzystają z tego samego modelu komponentów w Swift, Objective-C, Kotlin lub Java.

Funkcje, które zapewniają Barkoderowi miejsce w podsumowaniach, są rzeczywiście zdolnościami. MatrixSight i tryb DeBlur zapewniają autorską technologię odzyskiwania uszkodzonych danych, która odczytuje BarCodes, które są fizycznie uszkodzone, źle wydrukowane lub zeskanowane przy słabym oświetleniu. Funkcja wykrywania wielu BarCodes umożliwia jednoczesne odczytywanie wielu BarCodes w jednym kadrze z kamery, co pozwala pracownikom magazynu skanować całe półki za jednym razem. Skanowanie DPM (Direct Part Marking) obsługuje format DataMatrix i inne formaty w konfiguracjach grawerowanych laserowo i punktowo, z którymi większość bibliotek ogólnego przeznaczenia nie radzi sobie dobrze. Obsługa formatów o wysokiej gęstości obejmuje PDF417,Azteci inne formaty 2D z wysoką dokładnością w aparatach telefonów komórkowych.

Szczegółowe porównanie funkcji

Podejście Barkoder SDK

Barkoder's published platform list is iOS Język ojczysty (Swift / Objective-C), Android Język ojczysty (Kotlin / Java), React Native, Flutter, Cordova, Capacitor, .NET MAUI, Xamarin, and Web (WASM). Na .NET w szczególności jest to mapowane na Plugin.Maui.Barkoder i Barkoder.Xamarin. ASP.NET Core, Azure Functions, AWS Lambda, Docker, serwery Linux, WPF, WinForms, Avalonia i Blazor są nieobecne. Architektura SDK opiera się na potoku obrazu z kamery na żywo w urządzeniu mobilnym. Nie ma trybu wprowadzania danych z plików, interfejsu API strumieniowego, ścieżki przetwarzania wsadowego ani modelu wykonywania po stronie serwera.

Dla pracy .NET poza aplikacją mobilną MAUI czy Xamarin – interfejs API backendu, serwis pracowniczy, narzędzie desktopowe, pipeline dokumentów PDF – Barkoder nie oferuje ścieżki. Nie ma powierzchni API async do użytku serwera, brak integracji z wstrzykiwaniem zależności, brak wsparcia dla Azure lubAWS Lambdai brak zdolności przetwarzania PDF.

Podejście IronBarcode

IronBarcode instaluje się z NuGet za pomocą jednego polecenia i inicjuje się przy użyciu klucza licencyjnego podczas uruchamiania:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

// NuGet: dotnet add package IronBarcode
using IronBarCode;

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

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

Imports IronBarCode

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

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

Biblioteka działa całkowicie lokalnie — bez wywołań sieciowych, bez transmisji danych, bez zewnętrznych zależności. Integruje się z wstrzykiwaniem zależności .NET Core, obsługuje async/await i umożliwia wdrażanie w Dockerze,Azure FunctionsorazAWS Lambdabez konieczności modyfikacji. Aby uzyskać informacje na temat integracji ASP.NET Core na poziomie produkcyjnym, zapoznaj się z dokumentacją IronBarcode.

Podejście Barkoder SDK

Tryb DeBlur aplikacji Barkoder stosuje przetwarzanie wstępne obrazu — wzmocnienie kontrastu, wyostrzanie, korekcję obrotu — przed próbą dekodowania. Działa to wyłącznie w ramach potoku przetwarzania obrazu z kamery mobilnej. Tryb jest konfigurowany na poziomie SDK przed rozpoczęciem skanowania, a obraz z kamery jest przetwarzany w sposób ciągły. Nie ma odpowiednika ścieżki opartej na pliku.

// dotnet add package Plugin.Maui.Barkoder
// Configured against the BarkoderView in a MAUI ContentPage
BarkoderView.DeblurEnabled = true;
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.Code128 });
BarkoderView.StartScanning(this);

// dotnet add package Plugin.Maui.Barkoder
// Configured against the BarkoderView in a MAUI ContentPage
BarkoderView.DeblurEnabled = true;
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.Code128 });
BarkoderView.StartScanning(this);

Podejście IronBarcode

IronBarcode rozwiązuje ten sam problem poprzez ReadingSpeed.ExtremeDetail, która aktywuje wielokrotne przetwarzanie analizy obrazu — stosując odzyskiwanie uszkodzeń oparte na ML, wzmacnianie kontrastu, poprawę ostrości i korekcję obrotu — zanim przystąpi do dekodowania. Działa to na dowolnym pliku, strumieniu lub tablicy bajtów jako danych wejściowych:

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

using IronBarCode;

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

var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.ExtremeDetail,
    ExpectMultipleBarcodes = false,
};

var results = BarcodeReader.Read("worn-shipping-label.png", options);

if (results.Any())
{
    Console.WriteLine($"Recovered: {results.First().Value}");
}
else
{
    Console.WriteLine("Could not decode — image quality too low");
}

Imports IronBarCode

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

Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.ExtremeDetail,
    .ExpectMultipleBarcodes = False
}

Dim results = BarcodeReader.Read("worn-shipping-label.png", options)

If results.Any() Then
    Console.WriteLine($"Recovered: {results.First().Value}")
Else
    Console.WriteLine("Could not decode — image quality too low")
End If

ReadingSpeed.Balanced obsługuje większość czystych lub lekko uszkodzonych kodów kreskowych i działa szybciej. Zarezerwuj ExtremeDetail na przypadki, gdy Balanced zawiedzie — jest dokładny, ale znacznie wolniejszy. Więcej wskazówek dotyczących odczytywania trudnych kodów kreskowych można znaleźć w dokumentacji dotyczącej odczytu IronBarcode.

Podejście Barkoder SDK

Tryb wielu kodów kreskowych aplikacji Barkoder wykrywa i dekoduje jednocześnie kilka kodów kreskowych z jednego kadru z kamery. W kontekście magazynowym pracownik trzyma telefon nad półką i otrzymuje wszystkie wartości BARCODE-ów jednocześnie. Konfiguracja ta odbywa się na poziomie SDK przed rozpoczęciem skanowania:

// Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = true;
BarkoderView.StartScanning(this);

// IBarkoderDelegate callback delivers all decoded codes per frame
public void DidFinishScanning(BarcodeResult[] results)
{
    foreach (var r in results)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

// Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = true;
BarkoderView.StartScanning(this);

// IBarkoderDelegate callback delivers all decoded codes per frame
public void DidFinishScanning(BarcodeResult[] results)
{
    foreach (var r in results)
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}");
}

' Plugin.Maui.Barkoder — multi-scan mode in a MAUI ContentPage
BarkoderView.MulticodeCachingEnabled = True
BarkoderView.StartScanning(Me)

' IBarkoderDelegate callback delivers all decoded codes per frame
Public Sub DidFinishScanning(results As BarcodeResult())
    For Each r In results
        Console.WriteLine($"{r.BarcodeTypeName}: {r.TextualData}")
    Next
End Sub

Podejście IronBarcode

W aplikacjach po stronie serwera .NET scenariusz z wieloma BARCODE-ami zazwyczaj dotyczy dokumentu — faktury z BARCODE-em do śledzenia przesyłki i BARCODE-em produktu lub listu przewozowego z wieloma pozycjami na stronie.IronBarcode obsługuje to za pomocą ExpectMultipleBarcodes = true, i ta sama opcja działa identycznie na obrazach i PDF:

using IronBarCode;

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

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

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

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

using IronBarCode;

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

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

// Works on images and PDFs — single method call
var results = BarcodeReader.Read("shipping-manifest.pdf", options);

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

Imports IronBarCode

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

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

' Works on images and PDFs — single method call
Dim results = BarcodeReader.Read("shipping-manifest.pdf", options)

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

Brak wyodrębniania stron, brak wielokrotnych żądań, brak obciążenia sieciowego związanego z każdym BarCode. Plik PDF jest odczytywany natywnie w ramach jednego wywołania. Więcej informacji na temat odczytu wielu kodów kreskowych i plików PDF można znaleźć w dokumentacji IronBarcode.

Podejście Barkoder SDK

Barkoder obsługuje odczyt kodów DataMatrix z konfiguracjami DPM dla znaków wygrawerowanych laserowo i wybijanych punktowo. SDK obsługuje również formaty PDF417,Azteci inne formaty 2D o wysokiej gęstości, zapewniając wysoką dokładność w przypadku aparatów w urządzeniach mobilnych. Wszystko to działa w ramach potoku przetwarzania obrazu w systemach iOS lub Android:

// Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.DataMatrix });
BarkoderView.StartScanning(this);

// Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(new[] { BarcodeType.DataMatrix });
BarkoderView.StartScanning(this);

' Plugin.Maui.Barkoder — DataMatrix scanning in a MAUI ContentPage
BarkoderView.SetEnabledBarcodeTypes(New BarcodeType() { BarcodeType.DataMatrix })
BarkoderView.StartScanning(Me)

Barkoder nie generuje kodów DataMatrix ani żadnych innych formatów kodów kreskowych. Jest to pakiet SDK tylko do odczytu.

Podejście IronBarcode

IronBarcode natywnie odczytuje i generuje kody DataMatrix. Po stronie odczytu, ReadingSpeed.ExtremeDetail obsługuje niski kontrast i szorstkie krawędzie typowe dla oznaczeń DPM wycinanych laserowo. Po stronie generowania, BarcodeWriter.CreateBarcode() produkuje DataMatrix do tworzenia etykiet części:

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

using IronBarCode;

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

// Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix)
    .SaveAsPng("part-label.png");

// Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("branded-qr.png");

// Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
var results = BarcodeReader.Read("etched-part.png");

Imports IronBarCode

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

' Generate a DataMatrix barcode for a part label
BarcodeWriter.CreateBarcode("PART-ID-20240315-A42", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("part-label.png")

' Generate a QR code with brand logo
QRCodeWriter.CreateQrCode("https://parts.example.com/A42", 500) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("branded-qr.png")

' Read auto-detects format — DataMatrix, QR, Code128, PDF417, etc.
Dim results = BarcodeReader.Read("etched-part.png")

Pełna lista obsługiwanych formatów i opcji generowania znajduje się w przewodniku po generowaniu kodów kreskowych IronBarcode.

Wymagania Projektów .NET Poza MAUI

Najczęstszy scenariusz jest prosty: programista lub zespół tworzy aplikację .NET — ASP.NET Core, usługę Windows, narzędzie konsolowe, aplikację desktopową — i podczas poszukiwań informacji natrafia na Barkoder. Czytają o MatrixSight, DeBlur i wykrywaniu wielokodowym, znajdują funkcje interesujące, a następnie odkrywają, że powierzchnia .NET to Plugin.Maui.Barkoder i Barkoder.Xamarin — obie tylko dla mobilnych interfejsów kamer. Zespoły w tej sytuacji nie rezygnują z Barkoder; od samego początku wybierają odpowiednie narzędzie dla swojej platformy.IronBarcode to odpowiedź środowiska .NET na wymagania, które Barkoder spełnia na urządzeniach mobilnych.

Procesy przetwarzania BarCodes po stronie serwera

Niektóre zespoły początkowo tworzą prototyp procesu przetwarzania kodów kreskowych przy użyciu mobilnej aplikacji do skanowania — Barkoder lub innego mobilnego zestawu SDK — a później muszą odtworzyć lub rozszerzyć ten proces po stronie serwera. Typowe przykłady obejmują przetwarzanie przesłanych obrazów kodów kreskowych za pośrednictwem punktu końcowego API, odczytywanie kodów kreskowych z dokumentów PDF w systemie zarządzania dokumentami lub przetwarzanie wsadowe zeskanowanych archiwów etykiet. Żadna z tych procedur nie jest możliwa w przypadku Barkoder, który nie posiada modelu wdrożenia po stronie serwera.IronBarcode obsługuje je wszystkie za pomocą tego samego statycznego API w ASP.NET Core, Azure Functions, Dockerze i AWS Lambda.

Wymagania dotyczące generowania BarCode

Zespoły tworzące aplikacje .NET dla logistyki, zarządzania zapasami lub zgodności z przepisami często odkrywają, że odczyt BARCODE'ów to tylko połowa procesu. Równie ważne jest generowanie kodów BarCode — drukowanie etykiet, osadzanie kodów QR w dokumentach, tworzenie listów przewozowych. Barkoder jest z założenia tylko do odczytu; nie posiada funkcji generowania. Gdy zakres projektu wykracza poza zwykłe czytanie, biblioteka obejmująca obie strony przepływu pracy eliminuje potrzebę integracji drugiej zależności.IronBarcode zapewnia zarówno odczyt, jak i generowanie w ponad 50 formatach za pośrednictwem spójnego interfejsu API.

Przetwarzanie dokumentów PDF

W aplikacjach Enterprise .NET BarCodes często pojawiają się w dokumentach PDF — fakturach, listach przewozowych, dokumentacji medycznej, dokumentach dotyczących zgodności. Barkoder nie ma pojęcia o tym przepływie pracy; Jest przeznaczona do wprowadzania danych za pomocą aparatu w urządzeniu mobilnym. Zespoły, które muszą odczytywać kody kreskowe z przychodzących dokumentów PDF, wyodrębniać dane z kodów kreskowych na potrzeby logiki biznesowej lub weryfikować obecność kodów kreskowych w archiwach dokumentów, potrzebują biblioteki z natywną obsługą formatu PDF.IronBarcode odczytuje kody kreskowe bezpośrednio z plików PDF bez pośredniego wyodrębniania obrazów.

Przewidywalność cen i wdrożenia

Cena mobilnego SDK Barkoder jest zorganizowana wokół modelu aplikacji mobilnych i dystrybucji — subskrypcji, na aplikację i na urządzenie, powiązana z wdrożeniem mobilnym. Dla zespołów, których praca z .NET jest poza MAUI czy Xamarin, ten model cenowy nie ma zastosowania, ponieważ SDK tam nie działa. Kiedy IronBarcode jest odpowiednim narzędziem, model cenowy jest prosty: licencja wieczysta bez opłat za zapytanie i bez limitów wolumenu na liczbę przetwarzanych kodów kreskowych.

Od danych z kamery mobilnej do danych z plików

Zespoły, które wdrożyły prototyp mobilnego skanowania oparty na Barkoderze i muszą odtworzyć tę funkcjonalność w .NET, zauważą, że model wejściowy zmienia się z klatek z kamery na plik, strumień lub tablicę bajtów.IronBarcode akceptuje te same dane w wielu formach — ciąg ścieżki pliku, Stream, byte[] lub System.Drawing.Image. Logika przetwarzania BarCode jest poza tym identyczna:

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

// All of these call the same underlying pipeline
var results1 = BarcodeReader.Read("scan.png");
var results2 = BarcodeReader.Read(imageStream);
var results3 = BarcodeReader.Read(imageBytes);

' All of these call the same underlying pipeline
Dim results1 = BarcodeReader.Read("scan.png")
Dim results2 = BarcodeReader.Read(imageStream)
Dim results3 = BarcodeReader.Read(imageBytes)

Kompromis między szybkością a dokładnością

Tryb DeBlur Barkodera jest zawsze aktywny po skonfigurowaniu i działa w pętli kamery mobilnej.IronBarcode wyraźnie ujawnia kompromis dokładność-wydajność poprzez ReadingSpeed. Dla większości plików, ReadingSpeed.Balanced jest odpowiedni. Dla uszkodzonego lub zdegradowanego wejścia, którego Balanced nie może zdekodować, ReadingSpeed.ExtremeDetail stosuje pełną wielokrotną przepustową ML. Strukturyzowanie przetwarzania wsadowego do użycia Balanced domyślnie i powrót do ExtremeDetail tylko w przypadku niepowodzeń jest zalecaną metodą dla przepływów pracy wrażliwych na wydajność.

Integracja asynchroniczna w ASP.NET Core

Metoda BarcodeReader.Read()IronBarcode jest synchroniczna. W ASP.NET Core punktach końcowych, które obsługują równoczesne żądania, otocz wywołanie w Task.Run(), aby uniknąć blokowania wątku żądania:

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

var results = await Task.Run(() => BarcodeReader.Read(imageBytes, options));

Dim results = Await Task.Run(Function() BarcodeReader.Read(imageBytes, options))

Specyfikacja formatu dla wydajności

IronBarcode domyślnie automatycznie wykrywa formaty kodów kreskowych. W scenariuszach o dużej przepustowości, gdzie znany jest oczekiwany format, określenie formatu skraca czas przetwarzania poprzez wyeliminowanie testów formatów, które nie będą pasować. Skorzystaj z BarcodeReaderOptions.ExpectBarcodeTypes, aby ograniczyć wyszukiwanie, kiedy format jest znany z wyprzedzeniem.