Potoki kodów QR, które przetwarzają dane wejściowe z rzeczywistego świata, w tym wydrukowane etykiety, zdjęcia z aparatu lub zeskanowane dokumenty, napotkają symbole, które są zbyt uszkodzone, aby je zdekodować, oraz wyniki, które przejdą kontrolę sumy kontrolnej, ale nie przejdą walidacji biznesowej.
Korekcja błędów Reed-Solomona automatycznie eliminuje fizyczne uszkodzenia podczas dekodowania. Jeśli nie można odzyskać symbolu, zbiór wyników jest pusty, a nie częściowy. Walidacja na poziomie aplikacji jest oddzielna i polega na sprawdzeniu, czy zdekodowana wartość nie jest pusta, czy odpowiada oczekiwanemu formatowi lub czy zawiera prawidłowy adres URI przed dalszym przetwarzaniem.
Ten poradnik tłumaczy, jak walidować sumy kontrolne kodów QR i stosować kontrole tolerancji błędów z użyciem biblioteki IronQR.
Szybki start: Sprawdzanie sum kontrolnych kodów QR
Odczytaj kod QR i sprawdź, czy dekodowanie się powiodło: wynik niepusty oznacza, że suma kontrolna Reeda-Solomona została zaliczona.
using IronQr;
using IronSoftware.Drawing;
var reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(new QrImageInput("label.png"));
if (!results.Any())
{
Console.WriteLine("No QR code detected or decoding failed.");
return;
}
Console.WriteLine(results.First().Value);
Wywołaj metodę QrReader.Read, aby zdekodować obraz i automatycznie uruchomić walidację Reed-Solomona
Sprawdź zbiór wyników, aby potwierdzić, że dekodowanie zakończyło się powodzeniem, ponieważ pusty zbiór oznacza niepowodzenie
Przed przekazaniem dalej należy zweryfikować zdekodowaną wartość pod kątem wymagań aplikacji.
Weryfikacja sum kontrolnych kodów QR
Kody QR wykorzystują korekcję błędów Reeda-Solomona do wykrywania i naprawy uszkodzeń zakodowanych danych. Poziom korekty (niski – 7%, średni – 15%, kwartylowy – 25% lub wysoki – 30%) określa procent kodów, które mogą zostać utracone i nadal być odzyskane.
Jeśli chodzi o odczyt, podczas dekodowania wewnętrznie przeprowadzana jest weryfikacja sumy kontrolnej. Klasa QrResult nie udostępnia właściwości confidence; jeśli wynik istnieje w zbiorze, przekazana suma kontrolna. Jeśli dekodowanie nie powiedzie się, kolekcja jest pusta.
Dane wejściowe
Etykieta produktu z kodem QR zawierającym https://ironsoftware.com/, wygenerowana z korekcją błędów Medium, reprezentująca etykietę, która mogła być dotykana lub lekko porysowana podczas transportu.
using IronQr;
using IronSoftware.Drawing;
var reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(new QrImageInput("damaged-label.png"));
// Reed-Solomon decoding is pass/fail — presence in results means valid checksum
if (!results.Any())
{
// Decoding failed entirely — damage exceeded the error correction capacity
Console.WriteLine("QR code could not be decoded. Consider re-scanning or using a higher error correction level at generation time.");
return;
}
foreach (QrResult result in results)
{
// Decoded successfully — validate the content matches expected format
if (string.IsNullOrWhiteSpace(result.Value))
{
Console.WriteLine("QR decoded but produced an empty value.");
continue;
}
Console.WriteLine($"Valid QR: {result.Value}");
}
Imports IronQr
Imports IronSoftware.Drawing
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(New QrImageInput("damaged-label.png"))
' Reed-Solomon decoding is pass/fail — presence in results means valid checksum
If Not results.Any() Then
' Decoding failed entirely — damage exceeded the error correction capacity
Console.WriteLine("QR code could not be decoded. Consider re-scanning or using a higher error correction level at generation time.")
Return
End If
For Each result As QrResult In results
' Decoded successfully — validate the content matches expected format
If String.IsNullOrWhiteSpace(result.Value) Then
Console.WriteLine("QR decoded but produced an empty value.")
Continue For
End If
Console.WriteLine($"Valid QR: {result.Value}")
Next
$vbLabelText $csharpLabel
Wynik
Konsola wyświetla zdekodowaną wartość https://ironsoftware.com/, potwierdzając, że dekodowanie Reed-Solomona zakończyło się powodzeniem, a ładunek został odzyskany w nienaruszonym stanie.
Aby zapewnić większą odporność na uszkodzenia fizyczne, generuj kody QR o wyższym poziomie korekcji błędów. Poziom High odzyskuje do 30% utraconych danych kosztem większego symbolu.
Obsługa rozpoznawania formatów podczas odczytu kodów QR
IronQR obsługuje trzy formaty kodowania QR: standardowy QR, Micro QR oraz prostokątny Micro QR. Skaner automatycznie wykrywa format podczas odczytu. Po skanowaniu pole QrResult.QrType podaje wykryty format jako wartość wyliczeniową.
W plikach PDF należy używać QrPdfInput zamiast QrImageInput. Tryb skanowania określa równowagę między szybkością a dokładnością: Auto łączy wykrywanie oparte na uczeniu maszynowym z klasycznym skanowaniem, OnlyDetectionModel wykorzystuje wyłącznie model ML w celu przyspieszenia przetwarzania, a OnlyBasicScan całkowicie pomija ML, zapewniając wysoką jakość wstępnie przetworzonych obrazów.
Dane wejściowe
Etykieta produktu w formacie PNG (po lewej) i zdjęcie w formacie JPEG (po prawej), pokazujące odczyt z uwzględnieniem formatu w przypadku dwóch popularnych typów danych wejściowych.
using IronQr;
using IronSoftware.Drawing;
using IronQr.Enum;
// Read from an image file with ML + classic scan (default)
var reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(new QrImageInput("product-label.png"));
foreach (QrResult result in results)
{
// Inspect the detected QR format
Console.WriteLine($"Format: {result.QrType}"); // QRCode, MicroQRCode, or RMQRCode
Console.WriteLine($"Value: {result.Value}");
// Url is non-null only if Value is a valid URI
if (result.Url != null)
{
Console.WriteLine($"URI: {result.Url.AbsoluteUri}");
}
// Corner coordinates for positional context
Console.WriteLine($"Corners: {result.Points.Length} points detected");
}
// Read from a bitmap with ML-only mode for faster throughput
var bitmap = AnyBitmap.FromFile("camera-capture.jpg");
var fastResults = reader.Read(new QrImageInput(bitmap, QrScanMode.OnlyDetectionModel));
Imports IronQr
Imports IronSoftware.Drawing
Imports IronQr.Enum
' Read from an image file with ML + classic scan (default)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(New QrImageInput("product-label.png"))
For Each result As QrResult In results
' Inspect the detected QR format
Console.WriteLine($"Format: {result.QrType}") ' QRCode, MicroQRCode, or RMQRCode
Console.WriteLine($"Value: {result.Value}")
' Url is non-null only if Value is a valid URI
If result.Url IsNot Nothing Then
Console.WriteLine($"URI: {result.Url.AbsoluteUri}")
End If
' Corner coordinates for positional context
Console.WriteLine($"Corners: {result.Points.Length} points detected")
Next
' Read from a bitmap with ML-only mode for faster throughput
Dim bitmap As AnyBitmap = AnyBitmap.FromFile("camera-capture.jpg")
Dim fastResults = reader.Read(New QrImageInput(bitmap, QrScanMode.OnlyDetectionModel))
$vbLabelText $csharpLabel
Wynik
Konsola wyświetla wykryty format, zdekodowaną wartość, rozpoznany adres URI oraz liczbę narożników dla etykiety produktu, a następnie liczbę wyników szybkiego skanowania dla obrazu z kamery.
Pole QrType jest przydatne, gdy aplikacja wymaga określonego formatu. Na przykład system magazynowy, który generuje wyłącznie standardowe kody QR, może odfiltrować nieoczekiwane wykrycia kodów Micro QR lub Rectangular Micro QR, które mogą wskazywać na zakłócenia lub niepowiązane etykiety. Każdy format ma inne właściwości pojemnościowe: standardowy kod QR obsługuje do 7089 znaków numerycznych, Micro QR do 35, a Rectangular Micro QR zapewnia prostokątny format dla ograniczonej przestrzeni na etykiecie.
Stosowanie kontroli wartości null do wyników kodów QR
QrReader.Read zwraca pustą kolekcję, jeśli nie znaleziono żadnych kodów QR; nigdy nie zwraca null. Jednak poszczególne właściwości wyników nadal wymagają weryfikacji. Na przykład Value może być puste, a Url zwraca null, jeśli zdekodowany ciąg znaków nie jest prawidłowym adresem URI.
Solidny wzorzec walidacji sprawdza trzy aspekty: liczbę elementów w zbiorze, integralność wartości oraz poprawność typu lub adresu URI przed przekazaniem danych do innego systemu.
Dane wejściowe
Puste, białe zdjęcie bez kodu QR, przedstawiające stronę dokumentu w partii mieszanej, w której niektóre strony nie posiadają etykiet nadających się do odczytu maszynowego.
using IronQr;
using IronSoftware.Drawing;
using System.Collections.Generic;
using System.Linq;
public static class QrValidator
{
public static List<QrResult> GetValidResults(
string imagePath,
QrEncoding? expectedFormat = null)
{
var reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(new QrImageInput(imagePath));
// Guard: no QR codes detected
if (!results.Any())
return new List<QrResult>();
return results
.Where(r => !string.IsNullOrWhiteSpace(r.Value))
.Where(r => expectedFormat == null || r.QrType == expectedFormat)
.ToList();
}
}
// Usage — only accept standard QR codes with non-empty values
var validated = QrValidator.GetValidResults(
"shipping-manifest.png",
expectedFormat: QrEncoding.QRCode);
if (validated.Count == 0)
{
Console.WriteLine("No valid QR codes found for processing.");
return;
}
foreach (var qr in validated)
{
// Safe for downstream: value is non-empty, format is verified
SendToInventoryApi(qr.Value, qr.Url?.AbsoluteUri);
}
Imports IronQr
Imports IronSoftware.Drawing
Imports System.Collections.Generic
Imports System.Linq
Public Module QrValidator
Public Function GetValidResults(
imagePath As String,
Optional expectedFormat As QrEncoding? = Nothing) As List(Of QrResult)
Dim reader As New QrReader()
Dim results As IEnumerable(Of QrResult) = reader.Read(New QrImageInput(imagePath))
' Guard: no QR codes detected
If Not results.Any() Then
Return New List(Of QrResult)()
End If
Return results _
.Where(Function(r) Not String.IsNullOrWhiteSpace(r.Value)) _
.Where(Function(r) expectedFormat Is Nothing OrElse r.QrType = expectedFormat) _
.ToList()
End Function
End Module
' Usage — only accept standard QR codes with non-empty values
Dim validated = QrValidator.GetValidResults(
"shipping-manifest.png",
expectedFormat:=QrEncoding.QRCode)
If validated.Count = 0 Then
Console.WriteLine("No valid QR codes found for processing.")
Return
End If
For Each qr In validated
' Safe for downstream: value is non-empty, format is verified
SendToInventoryApi(qr.Value, qr.Url?.AbsoluteUri)
Next qr
$vbLabelText $csharpLabel
Wynik
Konsola wyświetla odpowiedź walidatora o pustym wyniku: nie wykryto żadnych kodów QR, więc zbiór jest pusty i żadne dane nie przechodzą do dalszego przetwarzania.
Walidator zwraca pustą listę (nigdy null), co eliminuje potrzebę sprawdzania wartości null w miejscu wywołania. Opcjonalny parametr expectedFormat działa jak filtr formatów, dzięki czemu kod wywołujący otrzymuje tylko wyniki zgodne z oczekiwanym typem formatu. Właściwość Url wykorzystuje operator warunkowy null do bezpiecznego obsługiwania zarówno ładunków URI, jak i innych niż URI.
W przypadku przepływów pracy asynchronicznych zastosuj te same wzorce walidacji do ReadAsync: poczekaj na wywołanie i zastosuj identyczne sprawdzanie wynikowej kolekcji.
Jaki jest cel walidacji sum kontrolnych kodu QR w C#?
Walidacja sum kontrolnych kodu QR w C# zapewnia integralność danych, weryfikując, że dane zakodowane w kodzie QR są dokładne i nie zostały uszkodzone podczas transmisji lub skanowania. IronQR może wspomóc ten proces poprzez zapewnienie niezawodnej weryfikacji sum kontrolnych.
Jak IronQR obsługuje wykrywanie formatu kodu QR?
IronQR zapewnia solidne możliwości wykrywania różnych formatów kodu QR, zapewniając kompatybilność z szeroką gamą standardów kodów QR. Ta funkcja pomaga programistom efektywnie obsługiwać kody QR w ich aplikacjach C#.
Jaką rolę odgrywa korekcja błędów Reed-Solomona w walidacji kodu QR?
Korekcja błędów Reed-Solomona to metoda stosowana w kodach QR do korekcji błędów występujących podczas skanowania. IronQR wykorzystuje tę technikę do zwiększenia tolerancji na błędy, co pozwala na dokładne odczytywanie i weryfikację kodów QR nawet przy pewnym poziomie zniekształcenia lub uszkodzenia.
Czy IronQR może stosować bezpieczne dla null wzory przy pracy z kodami QR?
Tak, IronQR może stosować bezpieczne dla null wzory, które pomagają zapobiegać błędom odniesienia do null przy obsłudze danych kodu QR. To zapewnia, że twoja aplikacja może przetwarzać kody QR bardziej niezawodnie i efektywnie.
Dlaczego tolerancja na błędy jest ważna w przetwarzaniu kodu QR?
Tolerancja na błędy jest kluczowa, ponieważ pozwala systemom przetwarzania kodów QR obsługiwać błędy i niespójności bez awarii. Możliwości tolerancji na błędy IronQR zapewniają, że nawet częściowo uszkodzone lub przesłonięte kody QR mogą być dokładnie odczytane.
Jakie są korzyści z używania IronQR do walidacji kodów QR w C#?
IronQR oferuje kilka korzyści w zakresie walidacji kodów QR, w tym wysoką dokładność, obsługę wielu formatów kodów QR i wbudowane mechanizmy korekcji błędów, co czyni go idealnym wyborem dla programistów pracujących z kodami QR w C#.
W jaki sposób IronQR zwiększa dokładność odczytu kodu QR?
IronQR zwiększa dokładność odczytu, wykorzystując zaawansowane algorytmy do wykrywania i dekodowania kodów QR oraz stosując metody korekcji błędów, takie jak Reed-Solomon, do obsługi dowolnej korupcji danych podczas skanowania.