1. IronQR
  2. Nasıl Yapılır
  3. QR Kod Hata Düzeltme

QR Kodu Hata Düzeltme Seviyeleri Nasıl Ayarlanır

Curtis Chau
Curtis Chau
Güncellendi:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Performans üzerinde kontrol sahibi olun. Hata düzeltme ayarlarını, hasara dayanan ve hâlâ güvenilir bir şekilde taranabilen daha hızlı, daha sağlam QR kodları oluşturmak için ayarlayın.

Hata düzeltme, parçalanan bir QR kodunu çalışmaya devam eden bir koddan ayıran şeydir. Bir etiket kazındığında, bir etiket soyulduğunda veya bir poster güneşte solduğunda, hata düzeltme kodun hâlâ taranıp taranamayacağını belirler. IronQR geliştiricilerin, temiz dijital ekranlar için optimize edilen hafif kodlardan, depolar ve fabrika zeminlerinde hayatta kalmak için yapılan ağır iş kodlarına kadar QR kodunun ne kadar dayanıklılık taşıdığını tam olarak seçmesini sağlar.

Bu rehber, herhangi bir kullanım durumu için veri yoğunluğunu hasar toleransıyla dengeleyen IronQR kütüphanesi'ni kullanarak hata düzeltme seviyelerini yapılandırmayı gösterir. QR kodları oluşturmaya yeni başlayan geliştiriciler, öncelikle QR Kodunu Resim Olarak Oluştur rehberi ile başlamalıdır.

Hızlı Başlatma: QR Kodu Hata Düzeltme Seti

Hata düzeltme seviyesini QrOptions ile yapılandırın ve dayanıklı bir QR kodu oluşturun.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronQR yükleyin

    PM > Install-Package IronQR

  2. Bu kod parçasını kopyalayıp çalıştırın.

    var options = new QrOptions(QrErrorCorrectionLevel.Medium);
var qrCode = QrWriter.Write("https://example.com", options);
qrCode.Save().SaveAs("qr-medium.png");

  3. Canlı ortamınızda test etmek için dağıtın

    Bugün projenizde IronQR kullanmaya başlayın ücretsiz deneme ile

    arrow pointer

Minimal İş Akışı (5 adımda)

  1. IronQR C# kütüphanesini indirerek hata düzeltmesi ile QR kodları oluşturun
  2. Secilen ErrorCorrectionLevel ile bir QrOptions nesnesi oluşturun
  3. Bu seçeneklerle QrWriter.Write() kullanarak QR kodu oluşturun
  4. Save() ile QR kodunu bir bitmap olarak kaydedin
  5. SaveAs() ile bitmap'i bir görüntü dosyası olarak dışarı çıkarın

Hata Düzeltme Seviyelerini Anlama

QR kodları, kısmen hasar gördüğünde veya gizlendiğinde bile taranabilir kalmak için Reed-Solomon hata düzelmesini kullanır. IronQR içindeki QrErrorCorrectionLevel enum'u, her biri artan dayanıklılık karşılığında veri kapasitesini değiştiren dört seviye sunar:

Seviye Kurtarma Kapasitesi En İyi Kullanım Alanı
QrErrorCorrectionLevel.Low ~7% hasar Dijital ekranlar, kontrollü ortamlar
QrErrorCorrectionLevel.Medium ~15% hasar Genel amaçlı kullanım, orta dayanıklılık
QrErrorCorrectionLevel.High ~25% hasar Basılı materyaller, dış mekan tabelaları
QrErrorCorrectionLevel.Highest ~30% hasar Endüstriyel etiketler, sert koşullar

Daha yüksek hata düzeltme, daha fazla yedek modül ekler, bu da QR kodunun görsel yoğunluğunu artırır. Bu aynı zamanda oluşturulan resmin boyutunu da etkileyen bir faktördür, bu yüzden geliştiricilerin boyutları buna göre ayarlaması gerekebilir. Dayanıklılık gereksinimlerini karşılayan en düşük seviye, kodun kompakt ve hızlı bir şekilde taranmasını sağlar.

Hata Düzeltme Seviyesini Ayarlama

Hata düzeltme seviyesini ayarlamak için, istenilen QrErrorCorrectionLevel değerini QrOptions yapıcısına iletin. Daha sonra, QR kodunu oluştururken bu seçenekleri QrWriter.Write() olarak iletin.

Bu örnekte, hata düzeltme Orta olarak ayarlanmıştır ve bu, kodu kompakt tutarken hasar görmüş verilerin %15'ine kadarını kurtarır.

:path=/static-assets/qr/content-code-examples/how-to/error-correction-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

QrOptions options = new QrOptions(QrErrorCorrectionLevel.Medium);

// Create QR code
QrCode qr = QrWriter.Write("1234", options);

// Save QR code as a bitmap
AnyBitmap qrImage = qr.Save();

// Save QR code bitmap as file
qrImage.SaveAs("qrMedium.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim options As New QrOptions(QrErrorCorrectionLevel.Medium)

' Create QR code
Dim qr As QrCode = QrWriter.Write("1234", options)

' Save QR code as a bitmap
Dim qrImage As AnyBitmap = qr.Save()

' Save QR code bitmap as file
qrImage.SaveAs("qrMedium.png")
$vbLabelText   $csharpLabel

Çıktı

Orta Hata Düzeltmeye Sahip QR Kodu

Hata Düzeltme Seviyelerini Karşılaştırma

Her seviye görsel olarak farklı bir QR kodu üretir. Daha düşük seviyeler daha hızlı taranan basit desenler üretirken, daha yüksek seviyeler daha fazla hasar gören yoğun desenler oluşturur. İşte karşılaştırma için her seviyede aynı veriyi nasıl üreteceğiniz:

:path=/static-assets/qr/content-code-examples/how-to/error-correction-qr-code-compare.cs
using IronQr;
using IronSoftware.Drawing;

string data = "https://ironsoftware.com";

// Low - ~7% recovery, smallest code
QrCode qrLow = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Low));
qrLow.Save().SaveAs("qrLow.png");

// Medium - ~15% recovery, balanced
QrCode qrMedium = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Medium));
qrMedium.Save().SaveAs("qrMedium.png");

// High - ~25% recovery, durable
QrCode qrHigh = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.High));
qrHigh.Save().SaveAs("qrHigh.png");

// Highest - ~30% recovery, maximum resilience
QrCode qrHighest = QrWriter.Write(data, new QrOptions(QrErrorCorrectionLevel.Highest));
qrHighest.Save().SaveAs("qrHighest.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim data As String = "https://ironsoftware.com"

' Low - ~7% recovery, smallest code
Dim qrLow As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Low))
qrLow.Save().SaveAs("qrLow.png")

' Medium - ~15% recovery, balanced
Dim qrMedium As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Medium))
qrMedium.Save().SaveAs("qrMedium.png")

' High - ~25% recovery, durable
Dim qrHigh As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.High))
qrHigh.Save().SaveAs("qrHigh.png")

' Highest - ~30% recovery, maximum resilience
Dim qrHighest As QrCode = QrWriter.Write(data, New QrOptions(QrErrorCorrectionLevel.Highest))
qrHighest.Save().SaveAs("qrHighest.png")
$vbLabelText   $csharpLabel

Lütfen dikkate alinDaha yüksek hata düzeltme seviyeleri, QR kodundaki modül sayısını artırır ve bu, deseni yoğunlaştırır. Tarama hızı öncelikse, projenin dayanıklılık ihtiyaçlarını karşılayan en düşük seviye önerilir.

Çıktı

QR Code with Low Error Correction

Düşük (~%7 Kurtarma)

Orta Hata Düzeltmeye Sahip QR Kodu

Orta (~%15 Kurtarma)

QR Code with High Error Correction

Yüksek (~%25 Kurtarma)

QR Code with Highest Error Correction

En Yüksek (~%30 Kurtarma)

Kullanım Durumu İçin Doğru Seviyeyi Seçme

Doğru hata düzeltme seviyesi, QR kodunun nerede yaşayacağına ve neye dayanması gerektiğine bağlıdır:

Kullanım Durumu Seviye Neden İlgili Rehber
Dijital ekranlar ve web siteleri QrErrorCorrectionLevel.Low Ekran temiz, aydınlatma kontrol altında, fiziksel aşınma yok. Kodu basit ve hızlı taranabilir tutar. QR Kodunu Görüntü Olarak Oluşturun
Kartvizitler, el ilanları ve iç mekan tabelaları QrErrorCorrectionLevel.Medium Hafif kullanım ve küçük kıvrılmalar taramayı etkilemez. En iyi sonuçlar için uygun kenar boşluklarıyla eşleştirin. QR Kodu Kenar Boşlukları Ekle
Ürün ambalajı ve dış mekan posterleri QrErrorCorrectionLevel.High Malzemeler yağmur, UV maruziyeti ve nakliye sırasında sert kullanım görür. Uzaktan tarama için boyutu büyütün. QR Kodunu Yeniden Boyutlandırın
Depo etiketleri, fabrika zeminleri ve endüstriyel etiketler QrErrorCorrectionLevel.Highest Kodların çizildiği, lekelendiği veya kısmen kapatıldığı sert çevreler. Maksimum yedeklilik, işlevselliği korur. Görüntüden QR Kodları Oku

Daha gelişmiş QR kodu oluşturma desenleri için C# QR Kodu Oluşturucu rehberini ve tam IronQR özellik setini inceleyin.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget İndirmeler 64,787 | Sürüm: 2026.4 just released
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronQR
bir örneği çalıştır URL'inin bir QR koduna dönüşünü izle.