Architektura potoku przetwarzania obrazu z kamery

Architektura Scanbota wymaga inicjalizacji przy uruchomieniu aplikacji, a następnie wywołania skanowania za pomocą aparatu. Metoda skanowania wymaga BarcodeScannerScreenConfiguration, ponieważ cała operacja jest oparta na kamerze:

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

using ScanbotSDK.MAUI;
using ScanbotSDK.MAUI.Barcode;

// In MauiProgram.cs — initialization required before any scan
// ScanbotSDKMain.Initialize(new SdkConfiguration {
//     LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
//     LoggingEnabled = false
// }, builder);

// Configure scanner appearance and behavior
var configuration = new BarcodeScannerScreenConfiguration
{
    UseCase = new SingleScanningMode()
};

// Open full-screen camera scanner — UI takes over the entire screen
var result = await ScanbotSDKMain.Barcode.StartScannerAsync(configuration);

if (result.IsSuccess)
{
    foreach (var item in result.Value.Items)
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}");
}

Imports ScanbotSDK.MAUI
Imports ScanbotSDK.MAUI.Barcode

' In MauiProgram.vb — initialization required before any scan
' ScanbotSDKMain.Initialize(New SdkConfiguration With {
'     .LicenseKey = "YOUR-SCANBOT-LICENSE-KEY",
'     .LoggingEnabled = False
' }, builder)

' Configure scanner appearance and behavior
Dim configuration As New BarcodeScannerScreenConfiguration With {
    .UseCase = New SingleScanningMode()
}

' Open full-screen camera scanner — UI takes over the entire screen
Dim result = Await ScanbotSDKMain.Barcode.StartScannerAsync(configuration)

If result.IsSuccess Then
    For Each item In result.Value.Items
        Console.WriteLine($"{item.Barcode.Format}: {item.Barcode.Text}")
    Next
End If

SDK przetwarza klatki wideo na żywo w czasie rzeczywistym, podświetla wykryte kody kreskowe w wizjerze i zwraca wynik po potwierdzeniu kodu kreskowego lub anulowaniu przez użytkownika. Obiekt konfiguracyjny kontroluje wygląd interfejsu użytkownika kamery, a nie sposób przetwarzania. To jest kompletny model.

Szczegółowe porównanie funkcji

Podejście Scanbot SDK

Architektura Scanbota opiera się na natywnej ścieżce kamery. Gdy zostanie wywołane ScanbotSDKMain.Barcode.StartScannerAsync(configuration), biblioteka przekazuje kontrolę pełnoekranowemu doświadczeniu z kamerą, korzystając z natywnych API kamery urządzenia na iOS, Androidzie lub Windowsie. Biblioteka w sposób ciągły przetwarza klatki wideo na żywo, stosuje wykrywanie BarCode do każdej klatki i zwraca kontrolę do aplikacji wywołującej po potwierdzeniu BarCode lub zamknięciu skanera przez użytkownika. W modelu Scanbot nie ma pojęcia statycznego obrazu — dane wejściowe to zawsze strumień klatek wideo na żywo z kamery urządzenia.

Ten projekt zapewnia doświadczenie skanowania z kodami kreskowymi uwydatnionymi w czasie rzeczywistym w wizjerze, z konfigurowalnym obszarem skanowania z kontrolą proporcji, przełącznikiem latarki, dźwiękowym i wibracyjnym sprzężeniem oraz blokadą orientacji. Są to funkcje interfejsu użytkownika zbudowane z myślą o przypadku użycia kamery. Alternatywą jest to, że biblioteka jest nierozerwalnie związana ze sprzętem kamery i systemem operacyjnym, który nią steruje.

Podejście IronBarcode

IronBarcode akceptuje dowolną reprezentację binarną obrazu zawierającego kod kreskowy i zwraca zdekodowane wyniki za pomocą tej samej metody statycznej, niezależnie od tego, w jaki sposób obraz został uzyskany:

// Install: dotnet add package BarCode
using IronBarCode;

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

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

// Install: dotnet add package BarCode
using IronBarCode;

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

// From a file path — works in any project type
var results = BarcodeReader.Read("barcode.png");
foreach (var result in results)
    Console.WriteLine($"{result.Value} ({result.Format})");

// From a PDF — reads all barcodes on all pages
var pdfResults = BarcodeReader.Read("invoice.pdf");
foreach (var result in pdfResults)
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}");

// From a stream — useful for HTTP file uploads
using var stream = File.OpenRead("document.pdf");
var streamResults = BarcodeReader.Read(stream);

// With processing options
var options = new BarcodeReaderOptions { Speed = ReadingSpeed.Balanced };
var configuredResults = BarcodeReader.Read("image.png", options);

Imports IronBarCode

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

' From a file path — works in any project type
Dim results = BarcodeReader.Read("barcode.png")
For Each result In results
    Console.WriteLine($"{result.Value} ({result.Format})")
Next

' From a PDF — reads all barcodes on all pages
Dim pdfResults = BarcodeReader.Read("invoice.pdf")
For Each result In pdfResults
    Console.WriteLine($"Page {result.PageNumber}: {result.Value}")
Next

' From a stream — useful for HTTP file uploads
Using stream = File.OpenRead("document.pdf")
    Dim streamResults = BarcodeReader.Read(stream)
End Using

' With processing options
Dim options = New BarcodeReaderOptions With {.Speed = ReadingSpeed.Balanced}
Dim configuredResults = BarcodeReader.Read("image.png", options)

To samo wywołanie działa w aplikacji konsolowej, kontrolerze .NET Core, funkcji Azure, formularzu WPF lub stronie MAUI.IronBarcodeodczytuje kody kreskowe z plików PDF w sposób natywny — nie jako obrazy wyodrębnione z plików PDF, ale poprzez bezpośrednią analizę struktury pliku PDF i wyszukiwanie kodów kreskowych na każdej stronie.

Podejście Scanbot SDK

Pakiet Scanbot MAUI jest przeznaczony dla net9.0-android i net9.0-ios. Projekt .NET MAUI Application, który deklaruje tylko te dwa cele, zostanie zbudowany pomyślnie. Jednakże, gdy do net9.0-maccatalyst lub celWindows MAUIzostanie dodany do TargetFrameworks, odwołanie do pakietu Scanbot MAUI nie zostanie rozwiązane na tych celach. To nie jest problem z konfiguracją - pakiet MAUI nie dostarcza asemblerów dla Windows lub macOS MAUI. Komputer stacjonarny z Windows jest objęty oddzielnym pakietem Scanbot.BarcodeSDK.Windows dla aplikacji UWP/WinUI 3 z autofokusem kamery.

W efekcie zestaw pakietów .NET Scanbot celuje w MAUI mobile i UWP/WinUI 3 desktop, a nie w typy projektów serwerowych lub bez kamery na komputerach stacjonarnych.

Podejście IronBarcode

IronBarcode jest dystrybuowany jako pojedynczy pakiet NuGet, który działa poprawnie we wszystkich typach projektów .NET i docelowych frameworkach:

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

# Same package, same API — works in ASP.NET Core, WPF, console, MAUI, Azure Functions
dotnet add package BarCode

W przypadku aplikacji MAUI, które są również przeznaczone na komputery stacjonarne z systemem Windows lub macOS,IronBarcode obsługuje wszystkie cztery platformy docelowe MAUI z poziomu jednego odwołania do pakietu, bez konieczności konfiguracji zależnej od platformy. Zespoły budujące projekt MAUI, który celuje w iOS, Androida i Windows, mogą dodaćIronBarcode raz i używać BarcodeReader.Read() na wszystkich trzech platformach bez modyfikacji.

Podejście Scanbot SDK

W projekcie MAUI przeznaczonym dla systemów iOS i Android, Scanbot udostępnia natywny wizjer aparatu wbudowany w układ nawigacyjny aplikacji. Wywołanie ScanbotSDKMain.Barcode.StartScannerAsync() przedstawia pełnoekranowy skaner, a wynik zostaje zwrócony na stronę wywołującą, gdy użytkownik zakończy lub odrzuci skan. Ta integracja daje aplikacji mobilnej UI skanowania, które wygląda jak natywne dla platformy.

Ograniczenie pojawia się, gdy projekt się rozszerza. Dodanie celu macOS lub celuWindows MAUIpowoduje błędy kompilacji na tych platformach (komputer stacjonarny z Windows jest obsługiwany przez oddzielny pakiet Scanbot.BarcodeSDK.Windows dla aplikacji UWP/WinUI 3). Dodanie bezgłowej komponenty po stronie serwera, która potrzebuje przetwarzania kodów kreskowych, wymaga oddzielnej biblioteki - zależność Scanbot nie może towarzyszyć projektowi w ramach ASP.NET Core,Azure Functionsczy Docker.

Podejście IronBarcode

W projekcie MAUI,IronBarcode współpracuje z MediaPicker platformy, aby przechwycić zdjęcia i czytać kody kreskowe z otrzymanych obrazów. Proces skanowania wykorzystuje aparat systemowy zamiast niestandardowego wizjera:

// Works on iOS, Android, Windows, andmacOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_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)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

// Works on iOS, Android, Windows, andmacOS MAUItargets
// NuGet: dotnet add package BarCode
using IronBarCode;

private async void ScanButton_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)
        await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK");
}

Imports IronBarCode
Imports System.IO
Imports System.Threading.Tasks

Private Async Sub ScanButton_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
                Await DisplayAlert("Scanned", $"{result.Format}: {result.Value}", "OK")
            Next
        End Using
    End Using
End Sub

Cechą charakterystyczną jest nakładka na wizjer na żywo. Użytkownik widzi interfejs aparatu systemowego zamiast niestandardowego obszaru skanowania, co jest wystarczające w zastosowaniach biznesowych, gdzie wystarczy funkcja "wskazania i uchwycenia". Samouczek dotyczący skanera BARCODE .NET MAUI obejmuje pełny wzorzec integracji MAUI dla platform iOS i Android, w tym obsługę uprawnień i konfigurację projektu.

Podejście Scanbot

Scanbot działa w oparciu o model rocznej opłaty ryczałtowej. Roczny koszt licencji nie jest liczony według ilości skanów. Zapewnia to przewidywalne roczne budżetowanie dla zespołów korzystających wyłącznie ze stabilnych wdrożeń mobilnych. Aby uzyskać dokładną wycenę, należy skontaktować się z zespołem sprzedaży Scanbot; Opublikowane dane liczbowe nie są dostępne. Obowiązek corocznego odnawiania oznacza, że licencja stanowi stały koszt operacyjny.

Podejście IronBarcode

IronBarcode jest sprzedawany jako jednorazowy zakup na czas nieokreślony w czterech wersjach: Lite za 749 USD, Plus za 1499 USD, Professional za 2999 USD i Unlimited za 5999 USD. Nie ma wymogu corocznego odnawiania licencji w celu dalszego korzystania z zakupionej wersji. W cenie zawarte są aktualizacje oprogramowania w okresie obowiązywania licencji. Ceny są publikowane na stronie internetowej Iron Software bez konieczności prowadzenia rozmów handlowych.

Przetwarzanie po stronie serwera i przetwarzanie zaplecza

Aplikacja mobilna zbudowana przy użyciu Scanbot często współistnieje z komponentem po stronie serwera, który obsługuje przesyłanie dokumentów, zadania wsadowe lub punkty końcowe API. Gdy ten komponent po stronie serwera wymaga przetwarzania kodów kreskowych — wyodrębniania kodów kreskowych z przesłanych plików PDF, sprawdzania poprawności wartości kodów kreskowych w przychodzących dokumentach lub przetwarzania danych kodów kreskowych z załączonych obrazów — aplikacja Scanbot nie jest dostępna. Pakiet nie kompiluje się w .NET Core, Azure Functions, aplikacjach konsolowych ani żadnym projekcie innym niż MAUI. Zespoły w tej sytuacji muszą utrzymywać zależność od mobilnego rozwiązania do obsługi kodów kreskowych obok oddzielnego rozwiązania po stronie serwera lub oceniać, czy IronBarcode może pełnić obie role w ramach jednego pakietu.

Wymagania dotyczące aplikacji desktopowej

Główną zaletą MAUI jest często obsługa wielu platform: jedna baza kodu przeznaczona dla systemów iOS, Android i Windows. Gdy celWindows MAUIpojawia się w planie działania — albo z początkowych wymagań, albo jako późniejsze dodanie — pakiet ScanbotBarcodeSDK.MAUI nie daje się rozwiązać na tym celu, ponieważ Scanbot obejmuje Windows przez oddzielny pakiet UWP/WinUI 3 (Scanbot.BarcodeSDK.Windows), a nie przez MAUI Windows. Zespoły, które chcą mieć jedną ścieżkę buildów Windows w wielo-celowym projekcie MAUI lub potrzebują bezgłowego komponentu Windows (takiego jak usługa Windows), nie dostaną tego z zestawu pakietów Scanbot.IronBarcode dostarcza jeden pakiet, który jest rozwiązywany na celuWindows MAUIi również działa w bezgłowych kontekstach desktopowych i serwerowych.

PDF i przepływy pracy z dokumentami

Aplikacje, które przechodzą od skanowania na żywo do automatyzacji dokumentów, napotykają ograniczenia możliwości Scanbota. Odczytywanie kodów kreskowych z faktury PDF, wyodrębnianie kodów śledzących z zeskanowanej etykiety wysyłkowej lub przetwarzanie danych kodu kreskowego z zarchiwizowanego dokumentu to działania, które wykraczają poza model wejściowy Scanbot, który jest zbudowany wokół transmisji z kamery na żywo.IronBarcode obsługuje wszystkie te dane wejściowe oparte na plikach w sposób natywny. Ten sam pakiet, który działa w aplikacji mobilnej MAUI, może wyodrębniać BARCODE-sy z dokumentów PDF w ramach zadania przetwarzania w tle, bez żadnych dodatkowych zależności.

Przewidywalne koszty licencji

Roczne koszty odnowienia wymagają ponownej oceny w każdym cyklu odnowienia. Zespoły, które rozpoczęły korzystanie z Scanbota w ramach wdrożenia mobilnego na małą skalę, a następnie rozszerzyły je na szersze wdrożenie z większą liczbą użytkowników lub platform, mogą uznać opłatę roczną za mniej korzystną w miarę wzrostu zakresu. Model jednorazowej licencji wieczystej IronBarcode eliminuje obowiązek odnawiania. Zespoły przeprowadzające oceny przedłużenia licencji często zastanawiają się, czy jednorazowy zakup lepiej wpisuje się w ich długoterminowe planowanie kosztów, zwłaszcza gdy rozszerzony zakres projektu obejmuje platformy po stronie serwera lub platformy desktopowe, które i tak nie są objęte zasięgiem Scanbota.

Brak odpowiednika podglądu na żywo

Wizjer kamery Scanbota działający w czasie rzeczywistym — z nakładką obszaru skanowania, ciągłym wykrywaniem i haptycznym sprzężeniem zwrotnym — nie ma bezpośredniego odpowiednika w IronBarcode. Wzorzec zastępczy używa MediaPicker.CapturePhotoAsync() MAUI do otwarcia kamery systemowej, przechwycenia zdjęcia i zwrócenia obrazu do przetwarzania. Interakcja użytkownika polega raczej na robieniu zdjęć niż na ciągłym skanowaniu. W przypadku aplikacji biznesowych (zarządzanie zapasami, logistyka, przetwarzanie dokumentów) to rozróżnienie rzadko ma znaczenie. W przypadku aplikacji konsumenckich, w których nakładka na żywo ma kluczowe znaczenie dla wrażeń z użytkowania produktu, jest to istotna różnica w zakresie UX, którą należy ocenić przed podjęciem decyzji o migracji.

Wzorzec wywołania zwrotnego zdarzenia do bezpośredniego powrotu

ScanbotSDKMain.Barcode.StartScannerAsync() Scanbota jest async i zwraca wynik z flagą IsSuccess i kolekcją Value.Items. BarcodeReader.Read()IronBarcode zwraca kolekcję bezpośrednio — nie ma obiektu opakowującego z polem statusu. Sprawdzenie powodzenia zmienia się z result.IsSuccess na results.Any() lub sprawdzenie nuli na results.FirstOrDefault().

Zmiana nazwy przestrzeni nazw Format Enum

BarcodeFormat Scanbota (np. BarcodeFormat.Code128) i BarcodeEncodingIronBarcode(np. BarcodeEncoding.Code128) zawierają podobne elementy, ale są różnymi typami w różnych przestrzeniach nazw. Kod, który przechowuje lub porównuje wartości formatów według typu enum, wymaga aktualizacji odniesienia do typu. Porównania łańcuchów na podstawie wyników .ToString() są zazwyczaj kompatybilne, ponieważ nazwy członków są podobne, ale wyraźne porównania typu enum wymagają aktualizacji do wartości BarcodeEncoding.

Dodatki do kompilacji systemu Windows

Jeśli pakiet Scanbot powodował błędy kompilacjiWindows MAUIprzed migracją, jego usunięcie rozwiązuje te problemy. Po dodaniu IronBarcode sprawdź, czy funkcje specyficzne dla systemu Windows — okna dialogowe wyboru plików, lokalne ścieżki plików, uprawnienia systemu Windows — są odpowiednio obsługiwane w kodzie aplikacji MAUI, ponieważ różnią się one od schematów dostępu do plików w systemach iOS i Android.