À quoi ressemble l'architecture de Barkoder

Le noyau C/C++ du SDK gère le traitement des images. Les wrappers iOS et Android exposent ce cœur à travers les APIs natives de la plateforme. Sur .NET, les plugins MAUI et Xamarin encapsulent les mêmes SDK natifs et exposent un contrôle 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

Cela fonctionne à l'intérieur d'une application mobile MAUI contre une caméra en direct. Il n'existe pas de surcharge de fichier, pas de surcharge de flux, pas de surcharge de PDF, et pas de surface équivalente pour les projets ASP.NET Core, console, ou bureau. Les chemins de code natifs iOS et Android utilisent le même modèle de composant en Swift, Objective-C, Kotlin, ou Java.

Les fonctionnalités qui méritent à Barkoder une place dans les récapitulatifs sont de véritables capacités. MatrixSight et le mode DeBlur offrent une technologie exclusive de récupération des dommages qui permet de lire les codes-barres physiquement endommagés, mal imprimés ou capturés dans des conditions d'éclairage défavorables. La détection multiple de codes-barres décode simultanément plusieurs codes-barres dans une seule image de la caméra, permettant ainsi aux magasiniers de scanner des étagères entières en une seule fois. La numérisation DPM (Direct Part Marking) prend en charge DataMatrix et d'autres formats dans des configurations gravées au laser et par microbillage que la plupart des bibliothèques à usage général ne gèrent pas correctement. La prise en charge des formats haute densité inclut PDF417, Aztèque et d'autres formats 2D avec une grande précision sur les appareils photo mobiles.

Comparaison détaillée des fonctionnalités

Approche du SDK Barkoder

La liste des plateformes publiées par Barkoder est iOS Natif(Swift / Objective-C), Android Natif(Kotlin / Java), React Native, Flutter, Cordova, Capacitor, .NET MAUI, Xamarin, et Web (WASM). Sur .NET spécifiquement, cela correspond à Plugin.Maui.Barkoder et Barkoder.Xamarin. ASP.NET Core, Azure Functions, AWS Lambda, Docker, Linux servers, WPF, WinForms, Avalonia, and Blazor are absent. L'architecture du SDK repose sur un flux de données en direct provenant d'une caméra mobile. Il ne propose ni mode d'entrée basé sur des fichiers, ni API de flux, ni traitement par lots, ni modèle d'exécution côté serveur.

Pour les travaux .NET en dehors d'une application mobile MAUI ou Xamarin — une API de backend, un service worker, un outil de bureau, un pipeline de documents PDF — Barkoder ne propose pas de chemin. Il n'existe pas de surface API asynchrone pour l'utilisation serveur, pas d'intégration de l'injection de dépendances, pas de support Azure ou AWS Lambda, et pas de capacité de traitement PDF.

Approche IronBarcode

IronBarcode s'installe depuis NuGet en une seule commande et s'initialise avec une clé de licence au démarrage :

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

La bibliothèque fonctionne entièrement en local — aucun appel réseau, aucune transmission de données, aucune dépendance externe. Il s'intègre à l'injection de dépendances ASP.NET Core , prend en charge async/await et se déploie sur Docker, Azure Functionset AWS Lambdasans modification. Pour une intégration ASP.NET Core de niveau production, consultez la documentation IronBarcode .

Approche du SDK Barkoder

Le mode DeBlur de Barkoder applique un prétraitement de l'image (amélioration du contraste, netteté, correction de la rotation) avant la tentative de décodage. Ce système fonctionne exclusivement au sein du pipeline de la caméra mobile. Le mode est configuré au niveau du SDK avant le début de la numérisation, et le flux vidéo de la caméra est traité en continu. Il n'existe pas de chemin d'accès équivalent basé sur les fichiers.

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

Approche IronBarcode

IronBarcode traite le même problème avec ReadingSpeed.ExtremeDetail, qui active un pipeline d'analyse d'image multi-passages — appliquant la récupération de dommages basée sur ML, l'amélioration du contraste, le renforcement et la correction de rotation — avant de tenter le décodage. Cela fonctionne avec n'importe quel fichier, flux ou tableau d'octets en entrée :

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 gère la plupart des codes-barres propres ou légèrement endommagés et est plus rapide. Réservez ExtremeDetail pour les cas où Balanced échoue — il est exhaustif mais nettement plus lent. Pour plus d'informations sur la lecture des codes-barres difficiles, consultez la documentation de lecture IronBarcode .

Approche du SDK Barkoder

Le mode multi-codes-barres de Barkoder détecte et décode simultanément plusieurs codes-barres à partir d'une seule image de la caméra. Dans un entrepôt, un employé tient son téléphone au-dessus d'une étagère et reçoit simultanément toutes les valeurs des codes-barres. Ceci est configuré au niveau du SDK avant le début de l'analyse :

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

Approche IronBarcode

Dans les applications serveur .NET , le scénario à codes-barres multiples implique généralement un document : une facture avec un code-barres de suivi d'expédition et un code-barres de produit, ou un manifeste d'expédition avec plusieurs articles par page. Code-barres IronBarcode gère cela avec ExpectMultipleBarcodes = true, et la même option fonctionne aussi bien sur les images que sur les PDFs :

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

Aucune extraction de page, aucune requête multiple, aucune surcharge réseau par code-barres. Le fichier PDF est lu nativement en un seul appel. Pour en savoir plus sur la lecture de plusieurs codes-barres et de fichiers PDF, consultez la documentation IronBarcode .

Approche du SDK Barkoder

Barkoder prend en charge la lecture DataMatrix avec des configurations DPM pour les marques gravées au laser et par microbillage. Le SDK prend également en charge les formats PDF417, Aztèque et autres formats 2D haute densité avec une grande précision sur les appareils photo mobiles. Tout ceci fonctionne au sein du pipeline de la caméra sur iOS ou 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 ne génère pas de codes-barres DataMatrix ni aucun autre format de code-barres. Il s'agit d'un SDK en lecture seule.

Approche IronBarcode

IronBarcode lit et génère nativement des données DataMatrix. Du côté de la lecture, ReadingSpeed.ExtremeDetail gère le faible contraste et les bords rugueux typiques des marques DPM gravées au laser. Du côté de la génération, BarcodeWriter.CreateBarcode() produit DataMatrix pour la création d'étiquettes de pièces :

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

Pour obtenir la liste complète des formats pris en charge et des options de génération, consultez le guide de génération de codes-barres IronBarcode .

Exigences de projet .NET en dehors de MAUI

Le scénario le plus courant est simple : un développeur ou une équipe est en train de créer une application .NET ( ASP.NET Core, un service Windows, un outil console, une application de bureau) et découvre Barkoder lors de ses recherches. Ils lisent à propos de MatrixSight, DeBlur, et de la détection de multi-code-barres, trouvent les fonctionnalités attrayantes, puis découvrent que la surface .NET est Plugin.Maui.Barkoder et Barkoder.Xamarin — les deux uniquement pour l'interface utilisateur de caméra mobile. Les équipes dans cette situation ne quittent pas Barkoder ; Ils identifient dès le départ l'outil adapté à leur plateforme. Code-barres IronBarcode est la réponse .NET aux exigences auxquelles Barkoder répond sur mobile.

Flux de travail de traitement des codes-barres côté serveur

Certaines équipes commencent par prototyper un flux de traitement des codes-barres à l'aide d'une application de numérisation mobile (Barkoder ou un autre SDK mobile), puis doivent reproduire ou étendre ce flux côté serveur. Parmi les exemples courants, citons le traitement d'images de codes-barres téléchargées via une API, la lecture de codes-barres dans des documents PDF d'un système de gestion documentaire ou le traitement par lots d'archives d'étiquettes numérisées. Aucun de ces flux de travail n'est possible avec Barkoder, qui ne dispose d'aucun modèle de déploiement côté serveur. Code-barres IronBarcode gère tous ces cas avec la même API statique sur ASP.NET Core, Azure Functions, Docker et AWS Lambda.

Exigences de génération de codes-barres

Les équipes qui développent des applications .NET pour la logistique, les stocks ou la conformité constatent fréquemment que la lecture des codes-barres ne représente que la moitié du flux de travail. La génération de codes-barres (impression d'étiquettes, intégration de codes QR dans les documents, production de manifestes d'expédition) est tout aussi importante. Barkoder est conçu pour être en lecture seule ; Il ne possède aucune capacité de génération. Lorsqu'un projet s'étend au-delà de la simple lecture, une bibliothèque couvrant les deux aspects du flux de travail élimine le besoin d'intégrer une seconde dépendance. Code-barres IronBarcode assure la lecture et la génération de plus de 50 formats grâce à une API cohérente.

Traitement des documents PDF

Dans les applications Enterprise .NET , les codes-barres apparaissent fréquemment intégrés dans les documents PDF — factures, manifestes d'expédition, dossiers médicaux, documents de conformité. Barkoder n'a aucune notion de ce flux de travail ; Elle est conçue pour la capture d'images par caméra sur un appareil mobile. Les équipes qui doivent lire les codes-barres des documents PDF entrants, extraire des données de codes-barres pour des applications métier ou vérifier la présence de codes-barres dans des archives documentaires ont besoin d'une bibliothèque prenant en charge nativement le format PDF. Code-barres IronBarcode lit les codes-barres directement à partir des fichiers PDF sans extraction d'image intermédiaire.

Prévisibilité des prix et du déploiement

La tarification du SDK mobile de Barkoder est structurée autour de l'application mobile et du modèle de distribution — niveaux d'abonnement, par application, et par appareil liés au déploiement mobile. Pour les équipes dont le travail .NET se trouve en dehors de MAUI ou Xamarin, ce modèle de tarification ne s'applique pas car le SDK ne fonctionne pas là-bas. Lorsque Code-barres IronBarcode est l'outil approprié, le modèle de tarification est simple : une licence perpétuelle sans frais par demande et sans limites de volume sur le nombre de codes-barres traités.

De la saisie par caméra mobile à la saisie basée sur des fichiers

Les équipes qui ont mis en œuvre un prototype de numérisation mobile basé sur Barkoder et qui doivent reproduire cette fonctionnalité en .NET constateront que le modèle d'entrée passe des images de la caméra aux fichiers, flux ou tableaux d'octets. Code-barres IronBarcode accepte les mêmes données sous plusieurs formes — une chaîne de chemin de fichier, un Stream, un byte[], ou un System.Drawing.Image. La logique de traitement des codes-barres est par ailleurs identique :

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

Compromis entre vitesse et précision

Le mode DeBlur de Barkoder est toujours actif lorsqu'il est configuré et s'exécute dans la boucle de la caméra mobile. Code-barres IronBarcode expose explicitement le compromis précision-vitesse via ReadingSpeed. Pour la plupart des fichiers, ReadingSpeed.Balanced est approprié. Pour les entrées endommagées ou dégradées que Balanced ne parvient pas à décoder, ReadingSpeed.ExtremeDetail applique le pipeline ML multi-passages complet. Structurer le traitement par lots pour utiliser Balanced par défaut et revenir à ExtremeDetail seulement en cas d'échecs est l'approche recommandée pour les flux de travail sensibles à la performance.

Intégration asynchrone dans ASP.NET Core

La méthode BarcodeReader.Read() d'IronBarcode est synchrone. Dans les points de terminaison ASP.NET Core qui gèrent les demandes concurrentes, encapsulez l'appel dans Task.Run() pour éviter de bloquer le thread de demande :

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

Spécification de format pour les performances

IronBarcode détecte automatiquement les formats de codes-barres par défaut. Dans les scénarios à haut débit où le format attendu est connu, la spécification du format réduit le temps de traitement en éliminant les tests de format qui ne correspondront pas. Utilisez BarcodeReaderOptions.ExpectBarcodeTypes pour restreindre la recherche lorsque le format est connu à l'avance.