Architecture du pipeline de la caméra

L'architecture de Scanbot nécessite une initialisation au démarrage de l'application, suivie d'un appel de numérisation piloté par caméra. La méthode de scanner requiert un BarcodeScannerScreenConfiguration car l'ensemble de l'opération est piloté par la caméra :

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

Le SDK traite les images vidéo en direct en temps réel, met en évidence les codes-barres détectés dans le viseur et renvoie un résultat lorsqu'un code-barres est confirmé ou que l'utilisateur annule. L'objet de configuration contrôle l'apparence de l'interface utilisateur de la caméra, et non son comportement de traitement. Voici le modèle complet.

Comparaison détaillée des fonctionnalités

Approche du SDK Scanbot

L'architecture de Scanbot est construite autour d'un pipeline de caméra native. Lorsque ScanbotSDKMain.Barcode.StartScannerAsync(configuration) est appelé, la bibliothèque donne le contrôle à une expérience de caméra en plein écran alimentée par les API de caméra native de l'appareil sous iOS, Android ou Windows. La bibliothèque traite en continu les images vidéo en direct, applique la détection de codes-barres à chaque image et rend le contrôle à l'application appelante lorsqu'un code-barres est confirmé ou que l'utilisateur ferme le scanner. Le modèle Scanbot ne comporte pas de notion d'image statique ; l'entrée est toujours un flux d'images vidéo en direct provenant de la caméra de l'appareil.

Ce design produit une expérience de numérisation avec des codes-barres en temps réel mis en évidence dans le viseur, une région de numérisation configurable avec contrôle du ratio d'aspect, un interrupteur de torche, des retours audio et haptiques, et un verrouillage de l'orientation. Ce sont des fonctionnalités d'interface utilisateur conçues pour le cas d'utilisation de la caméra. Le compromis est que la bibliothèque est inséparable du matériel de la caméra et du système d'exploitation qui la gère.

Approche IronBarcode

IronBarcode accepte toute représentation binaire d'une image contenant un code-barres et renvoie des résultats décodés par la même méthode statique, quelle que soit la manière dont l'image a été obtenue :

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

Le même appel s'exécute dans une application console, un contrôleur ASP.NET Core, une fonction Azure, un formulaire WPF ou une page MAUI. Code-barres IronBarcode lit nativement les codes-barres des fichiers PDF — non pas comme des images extraites des PDF, mais en analysant directement la structure du PDF et en trouvant les codes-barres sur chaque page.

Approche du SDK Scanbot

Le package Scanbot MAUI cible net9.0-android et net9.0-ios. Un projet .NET MAUI Application qui déclare uniquement ces deux cibles se construira avec succès. Cependant, lorsque net9.0-maccatalyst ou une cible Windows MAUIest ajoutée à TargetFrameworks, la référence au package Scanbot MAUI échoue à se résoudre sur ces cibles. Ce n'est pas un problème de configuration — le paquet MAUI ne fournit pas d'assemblages pour Windows ou macOS MAUI. Le bureau Windows est couvert par le package séparé Scanbot.BarcodeSDK.Windows pour les applications UWP/WinUI 3 avec une caméra autofocus.

Le résultat est que l'ensemble de packages .NET de Scanbot cible le mobile MAUI et le bureau UWP/WinUI 3, plutôt que les types de projets serveurs ou de bureau non liés à la caméra.

Approche IronBarcode

IronBarcode est distribué sous la forme d'un package NuGet unique qui fonctionne correctement sur tous les types de projets .NET et les frameworks cibles :

# 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

Pour les applications MAUI ciblant également les ordinateurs de bureau Windows ou macOS , Code-barres IronBarcode prend en charge les quatre cibles MAUI à partir d'une seule référence de package sans configuration conditionnelle à la plateforme. Les équipes construisant un projet MAUI qui cible iOS, Android et Windows peuvent ajouter Code-barres IronBarcode une fois et utiliser BarcodeReader.Read() sur les trois plateformes sans modification.

Approche du SDK Scanbot

Dans le cadre d'un projet MAUI ciblant iOS et Android, Scanbot fournit un viseur de caméra natif intégré au flux de navigation de l'application. L'appel ScanbotSDKMain.Barcode.StartScannerAsync() présente le scanner en plein écran, et le résultat revient à la page appelante lorsque l'utilisateur complète ou annule le scan. Cette intégration donne à l'application mobile une interface utilisateur de numérisation qui se sent native à la plate-forme.

Cette limitation apparaît lorsque le projet prend de l'ampleur. Ajouter une cible macOS ou une cible Windows MAUIrompt la construction sur ces plateformes (le bureau Windows est géré par le package séparé Scanbot.BarcodeSDK.Windows pour les applications UWP/WinUI 3). L'ajout d'un composant côté serveur sans tête nécessitant un traitement des codes-barres nécessite une bibliothèque séparée — la dépendance Scanbot ne peut pas suivre le projet dans ASP.NET Core, Azure Functions, ou Docker.

Approche IronBarcode

Dans un projet MAUI, Code-barres IronBarcode travaille avec le MediaPicker de la plateforme pour capturer des photos et lire les codes-barres à partir des images résultantes. Le flux de travail de numérisation utilise la caméra du système plutôt qu'un viseur personnalisé :

// Works on iOS, Android, Windows, and macOS 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, and macOS 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

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

L'avantage principal réside dans la superposition du viseur en direct. L'utilisateur voit l'interface utilisateur de la caméra système plutôt qu'une zone de numérisation personnalisée, ce qui est adéquat pour les applications professionnelles où le pointage et la capture suffisent. Le tutoriel sur le lecteur de codes-barres .NET MAUI couvre l'intégralité du modèle d'intégration MAUI pour les cibles iOS et Android , y compris la gestion des autorisations et la configuration du projet.

Approche Scanbot

Scanbot fonctionne selon un modèle de forfait annuel. Le coût de la licence annuelle n'est pas mesuré par le volume de numérisations. Cela permet une budgétisation annuelle prévisible pour les équipes disposant de déploiements mobiles stables. Pour connaître le prix exact, veuillez contacter l'équipe commerciale de Scanbot ; Les chiffres publiés ne sont pas disponibles. L'obligation de renouvellement annuel signifie que la licence représente un coût opérationnel permanent.

Approche IronBarcode

IronBarcode est vendu sous forme d'achat unique et perpétuel, décliné en quatre niveaux : Lite à 749 $, Plus à 1 499 $, Professional à 2 999 $ et Unlimited à 5 999 $. Aucun renouvellement annuel n'est requis pour continuer à utiliser la version achetée. Les mises à jour logicielles sont incluses pendant la période de licence. Les tarifs sont publiés sur le site web Iron Software sans qu'il soit nécessaire de passer par une conversation commerciale.

Traitement côté serveur et en arrière-plan

Une application mobile développée avec Scanbot est souvent associée à un composant côté serveur qui gère les téléchargements de documents, les traitements par lots ou les points de terminaison API. Lorsque ce composant côté serveur a besoin d'un traitement de codes-barres (extraction de codes-barres à partir de PDF téléchargés, validation des valeurs de codes-barres dans les documents entrants ou traitement des données de codes-barres à partir de pièces jointes d'images), Scanbot n'est pas disponible. Ce package ne se compile pas dans ASP.NET Core, Azure Functions, les applications console ou tout projet non-MAUI. Dans ce cas de figure, les équipes doivent gérer une dépendance à un système de codes-barres mobile en parallèle d'une solution de codes-barres côté serveur distincte, ou évaluer si Code-barres IronBarcode peut couvrir les deux rôles avec un seul package.

Exigences relatives aux applications de bureau

L'atout majeur de MAUI réside souvent dans sa compatibilité multiplateforme : un code source unique ciblant iOS, Android et Windows. Lorsque la cible Windows MAUIentre dans la feuille de route — soit à partir des exigences initiales ou comme un ajout ultérieur — le package ScanbotBarcodeSDK.MAUI échoue à se résoudre sur cette cible, car Scanbot couvre Windows via un package UWP/WinUI 3 séparé (Scanbot.BarcodeSDK.Windows) plutôt que via MAUI Windows. Les équipes qui souhaitent un chemin de construction Windows unique à l'intérieur d'un projet MAUI multi-cibles, ou qui ont besoin d'un composant Windows sans tête (tel qu'un service Windows), n'obtiendront pas cela à partir de l'ensemble de packages de Scanbot. Code-barres IronBarcode fournit un package unique qui se résout sur la cible Windows MAUIet fonctionne également dans les contextes de bureau et de serveur sans tête.

Flux de travail PDF et documents

Les applications qui passent de la numérisation en direct à l'automatisation des documents se heurtent à une limite de capacité avec Scanbot. Lire des codes-barres à partir d'une facture PDF, extraire des codes de suivi à partir d'une image d'étiquette d'expédition numérisée, ou traiter les données de code-barres à partir d'un document archivé sont hors du modèle d'entrée de Scanbot, construit autour d'un flux caméra en direct. Code-barres IronBarcode gère nativement toutes ces entrées basées sur des fichiers. Le même module qui s'exécute dans l'application mobile MAUI peut extraire les codes-barres des documents PDF en traitement arrière-plan, sans aucune dépendance supplémentaire.

Coûts de licence prévisibles

Les coûts de renouvellement annuels nécessitent une réévaluation à chaque cycle de renouvellement. Les équipes qui ont commencé avec Scanbot dans le cadre d'un déploiement mobile à petite échelle et qui ont étendu leur utilisation à un plus grand nombre d'utilisateurs ou de plateformes pourraient trouver les frais annuels moins avantageux à mesure que la portée s'élargit. Le modèle perpétuel à paiement unique d'IronBarcode élimine l'obligation de renouvellement. Les équipes chargées d'évaluer le renouvellement des licences examinent souvent si un achat unique correspond mieux à leur planification des coûts à long terme, notamment lorsque le périmètre élargi du projet inclut des plateformes serveur ou de bureau qui ne sont de toute façon pas couvertes par Scanbot.

Aucun équivalent de viseur électronique

Le viseur de caméra en temps réel de Scanbot — avec superposition de la zone de numérisation, détection continue et retour haptique — n'a pas d'équivalent direct dans IronBarcode. Le modèle de remplacement utilise le MediaPicker.CapturePhotoAsync() de MAUI pour ouvrir la caméra du système, capturer une photo et retourner l'image pour traitement. L'expérience utilisateur s'apparente à un flux de capture de photos plutôt qu'à un flux de numérisation continu. Pour les applications commerciales (gestion des stocks, logistique, traitement des documents), cette distinction est rarement significative. Pour les applications grand public où la superposition en direct est essentielle à l'expérience utilisateur, il s'agit d'une véritable différence en matière d'expérience utilisateur qui doit être évaluée avant de s'engager dans la migration.

Modèle de rappel d'événement pour un retour direct

Le ScanbotSDKMain.Barcode.StartScannerAsync() de Scanbot est asynchrone et renvoie un résultat avec un drapeau IsSuccess et une collection Value.Items. Le BarcodeReader.Read() de Code-barres IronBarcode renvoie directement une collection — il n'y a pas d'objet wrapper avec un champ de statut. La vérification du succès passe de result.IsSuccess à results.Any() ou à une vérification de null sur results.FirstOrDefault().

Modification de l'espace de noms de l'énumération de format

L'enum BarcodeFormat de Scanbot (par exemple, BarcodeFormat.Code128) et l'enum BarcodeEncoding de Code-barres IronBarcode (par exemple, BarcodeEncoding.Code128) contiennent des membres similaires mais sont de types différents dans des namespaces différents. Le code qui stocke ou compare des valeurs de format par type énuméré nécessite la mise à jour de la référence de type. Les comparaisons de chaînes basées sur la sortie de .ToString() sont généralement compatibles puisque les noms des membres sont similaires, mais les comparaisons explicites de type enum nécessitent une mise à jour vers les valeurs BarcodeEncoding.

Modules complémentaires de Windows

Si le package Scanbot provoquait des échecs de compilation de Windows MAUIavant la migration, sa suppression résout ces problèmes. Après avoir ajouté IronBarcode, vérifiez que les fonctionnalités spécifiques à Windows (boîtes de dialogue de sélection de fichiers, chemins d'accès aux fichiers locaux, autorisations Windows) sont correctement gérées dans le code de l'application MAUI, car elles diffèrent des modèles d'accès aux fichiers d'iOS et d'Android.