Jak odczytać kod QR z obrazu w C#

Najważniejsze cechy

• Odczytuj i generuj kody QR z łatwością.
• Obsługa formatów obrazów JPEG, PNG, BMP i innych.
• Wysoka prędkość działania i dokładne wykrywanie dla łatwego wyodrębniania danych kodów QR.
• Działa na projektach .NET Framework, .NET Core, .NET Standard (2.0+), oraz .NET 6/7+.
• Oferuje wsparcie międzyplatformowe, więc możesz pracować w swoim ulubionym środowisku aplikacji i systemie operacyjnym, czy to Windows, Linux, czy jakimkolwiek innym wspieranym środowisku.

W przeciwieństwie do alternatyw z otwartym źródłem, IronQR koncentruje się na stabilności klasy enterprise, licencjonowaniu komercyjnym oraz wsparciu profesjonalnym, czyniąc go doskonałym rozwiązaniem dla aplikacji kluczowych dla biznesu.

Zainstaluj przez NuGet

Możesz zainstalować IronQR bezpośrednio z Konsoli Menedżera Pakietów NuGet:

Install-Package IronQR

Alternatywnie, użyj GUI NuGet w Visual Studio, wyszukując IronQR, i kliknij "Zainstaluj":

Dodawanie przestrzeni nazw i podstawowa konfiguracja

Po zainstalowaniu, uwzględnij następującą przestrzeń nazw w pliku C#:

using IronSoftware.Drawing;
using IronQR;

using IronSoftware.Drawing;
using IronQR;

Imports IronSoftware.Drawing
Imports IronQR

Uwaga: IronSoftware.Drawing jest używany do obsługi formatów obrazów w sposób międzyplatformowy.

Obsługiwane formaty obrazów

IronQR obsługuje wiele typów formatów obrazów, w tym:

• PNG
• JPG/JPEG
• BMP
• GIF
• TIFF

Ta elastyczność pozwala pracować praktycznie z każdym źródłem obrazu, od zdjęć z aparatu po zeskanowane dokumenty.

Podstawowy przykład kodu

Przyjrzyjmy się bliżej, jak można użyć tej biblioteki do łatwego dekodowania kodów QR. Oto minimalny przykład, który odczytuje pojedynczy kod QR z wartością tekstową "Hello World!" z pliku graficznego, używając klasy Bitmap i strumienia plików do ładowania obrazu:

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image using a file stream
        using var stream = File.OpenRead("sample-qr.png");
        var bitmapImage = AnyBitmap.FromStream(stream);
        QrImageInput qrImageInput = new QrImageInput(bitmapImage );
        // Read the QR code
        QrReader qrReader = new QrReader();
        try
        {
     // Use the QR read method to read the values within your QR code(s)
            IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
            // Output the decoded value
            foreach (var result in results)
            {
                Console.WriteLine("QR Code Value: " + result.Value);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine("Error reading QR code: " + ex.Message);
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports System
Friend Class Program
	Shared Sub Main()
		' Load the image using a file stream
		Dim stream = File.OpenRead("sample-qr.png")
		Dim bitmapImage = AnyBitmap.FromStream(stream)
		Dim qrImageInput As New QrImageInput(bitmapImage)
		' Read the QR code
		Dim qrReader As New QrReader()
		Try
	 ' Use the QR read method to read the values within your QR code(s)
			Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
			' Output the decoded value
			For Each result In results
				Console.WriteLine("QR Code Value: " & result.Value)
			Next result
		Catch ex As Exception
			Console.WriteLine("Error reading QR code: " & ex.Message)
		End Try
	End Sub
End Class

Wynik konsoli

Ten kod ładuje obraz kodu QR, odczytuje pierwszy wykryty kod QR i drukuje zdekodowaną zawartość. Proste i skuteczne. Stąd możesz zapisać wartości kodu QR do dalszego użytku.

Obsługa wielu kodów QR

Jeśli twój obraz zawiera wiele kodów QR (np. arkusz etykiet produktów), możesz je wszystkie wyodrębnić. W tym przykładzie przeskanujemy obraz kodu QR za pomocą naszego programu:

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

using IronQr;
using IronSoftware.Drawing;
using System;
class Program
{
    static void Main()
    {
        // Load the image from file
        var inputImage = AnyBitmap.FromFile("SampleCodes.png");
        QrImageInput qrImageInput = new QrImageInput(inputImage);
        // Read the QR code
        QrReader qrReader = new QrReader();
        IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
        // Output the decoded value
        foreach (var result in results)
        {
            Console.WriteLine("QR Code Value: " + result.Value);
        }
    }
}

Imports IronQr
Imports IronSoftware.Drawing
Imports System
Friend Class Program
	Shared Sub Main()
		' Load the image from file
		Dim inputImage = AnyBitmap.FromFile("SampleCodes.png")
		Dim qrImageInput As New QrImageInput(inputImage)
		' Read the QR code
		Dim qrReader As New QrReader()
		Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
		' Output the decoded value
		For Each result In results
			Console.WriteLine("QR Code Value: " & result.Value)
		Next result
	End Sub
End Class

Wynik

Niska jakość obrazu

Rozmazane lub niskiej rozdzielczości obrazy mogą utrudniać wykrycie kodu QR. Używaj jak najlepszych wejść, gdy to możliwe.

Kod QR Niewykryty

Upewnij się, że obraz nie jest zbyt ciemny, ma silny kontrast, a kod QR nie jest zasłonięty. Spróbuj przyciąć obraz, aby skupić się na obszarze kodu QR.

Obsługa wyjątków

Zawsze umieszczaj logikę odczytu kodów QR w blokach try-catch, aby płynnie obsługiwać uszkodzone pliki lub nieoczekiwane formaty:

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}

try
{
    IEnumerable<QrResult> results = qrReader.Read(qrImageInput);
    // Output the decoded value
    foreach (var result in results)
    {
        Console.WriteLine("QR Code Value: " + result.Value);
    }
}
catch (Exception ex)
{
    Console.WriteLine("Error reading QR code: " + ex.Message);
}

Try
	Dim results As IEnumerable(Of QrResult) = qrReader.Read(qrImageInput)
	' Output the decoded value
	For Each result In results
		Console.WriteLine("QR Code Value: " & result.Value)
	Next result
Catch ex As Exception
	Console.WriteLine("Error reading QR code: " & ex.Message)
End Try