QR 코드 .NET Core: C#을 사용하여 QR 코드 읽기 및 생성

QR 코드 라이브러리를 어떻게 설치합니까?

IronQR을 NuGet을 통해 설치하는 데에는 몇 초밖에 걸리지 않습니다. Visual Studio를 열고 도구 > NuGet 패키지 관리자 > 솔루션용 NuGet 패키지 관리로 이동한 후 IronQR를 검색하고 설치를 클릭하세요. 패키지는 최소한의 종속성을 가지고 있으며 기본적으로 Windows, macOS 및 Linux를 대상으로 합니다.

Install-Package IronQR

IronQR은 .NET Core 6, 7, 8, 9, 10 및 .NET Framework 4.6.2 이상을 대상으로 합니다. 크로스 플랫폼 프로젝트의 경우, SkiaSharp 통합이 비 Windows 실행 시간에서 이미지 처리를 처리합니다. 이 라이브러리는 추가 런타임 구성 없이 ASP.NET Core 웹 애플리케이션, 콘솔 앱 및 데스크탑 솔루션에서 작동합니다. 설치가 완료되면 모든 필요한 확장 메소드와 타입을 즉시 사용할 수 있습니다.

이미지에서 기본 QR 코드를 어떻게 읽습니까?

이미지 파일에서 QR 코드 데이터를 읽는 데에는 몇 줄의 코드만 필요합니다. QrReader 클래스는 이미지 품질을 평가하고 자동으로 올바른 세그먼트 모드를 선택하는 고급 머신 러닝 모델을 사용하여 입력 이미지가 이상적이지 않은 경우에도 정확한 결과를 제공합니다.

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

using IronQr;
using IronSoftware.Drawing;

// Load image containing QR code
var inputBmp = AnyBitmap.FromFile("qr-sample.png");
// Create QrImageInput from the bitmap
QrImageInput imageInput = new QrImageInput(inputBmp);
// Initialize QR Reader with ML model
QrReader reader = new QrReader();
// Read and decode all QR codes in the image
IEnumerable<QrResult> results = reader.Read(imageInput);
// Output decoded text strings
foreach (var qrCode in results)
{
    Console.WriteLine($"QR Code Value: {qrCode.Value}");
    Console.WriteLine($"URL: {qrCode.Url}");
}

고급 QR 코드 데이터를 어떻게 추출합니까?

기본 값 디코딩 외에도 IronQR은 각 스캔된 심볼로부터 좌표, 원시 데이터 세그먼트 및 모듈 수준 정보를 노출합니다. 이는 문서 처리 워크플로에서 QR 코드가 페이지 어디에 나타나는지를 정확히 알아야 하거나 하나의 이미지 내 여러 코드를 처리해야 하는 애플리케이션에 필수적입니다.

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

using IronQr;
using IronSoftware.Drawing;

var inputBmp = AnyBitmap.FromFile("document-with-qr.png");
QrImageInput imageInput = new QrImageInput(inputBmp);
QrReader reader = new QrReader();
IEnumerable<QrResult> results = reader.Read(imageInput);
foreach (var qrCode in results)
{
    // Access decoded value
    Console.WriteLine($"Data: {qrCode.Value}");
    // Get corner coordinate positions
    foreach (PointF point in qrCode.Points)
    {
        Console.WriteLine($"Position: {point.X}, {point.Y}");
    }
}

에러 수정 레벨이 QR 코드 품질에 어떻게 영향을 줍니까?

에러 수정은 코드의 일부가 가려지거나, 인쇄가 잘못되거나 물리적으로 손상된 경우에도 QR 스캐너가 원래 데이터를 복구할 수 있게 하는 메커니즘입니다. QR 코드 표준은 저장 용량을 손상 허용으로 교환하는 Low (L), Medium (M), Quartile (Q), 및 High (H)의 네 가지 레벨을 정의합니다.

QR 코드를 생성할 때, 더 높은 오류 수정 수준을 지정하면 실제 스캔 조건에서도 출력이 견고하게 유지됩니다:

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Configure QR options with high error correction
var qrOptions = new QrOptions(QrErrorCorrectionLevel.High, 20);
// Generate a QR code with specified error correction
QrCode myQr = QrWriter.Write("https://ironsoftware.com", qrOptions);
// Save as PNG image
AnyBitmap qrImage = myQr.Save();
qrImage.SaveAs("high-error-correction-qr.png");

국제 문자로 QR 코드를 어떻게 생성합니까?

IronQR는 숫자, 알파벳 숫자, 바이트, 그리고 Kanji를 포함한 QR 인코딩 모드 전체 범위를 지원합니다. 일본어 텍스트 및 기타 유니코드 콘텐츠의 경우, 라이브러리는 자동으로 가장 공간 효율적인 인코딩을 선택합니다:

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Generate QR that encodes Japanese Unicode text
QrCode japaneseQr = QrWriter.Write("こんにちは世界");
// The library selects Kanji mode automatically
AnyBitmap qrImage = japaneseQr.Save();
qrImage.SaveAs("japanese-qr.png");

구조화된 QR 데이터에 대한 페이로드 생성기를 어떻게 사용합니까?

일반 URL을 인코딩하는 QR 코드는 간단한 링크 공유에 유용하지만 많은 애플리케이션은 구조화된 데이터를 인코딩해야 합니다 -- WiFi 자격 증명, vCard 형식의 연락처 카드, 이벤트 데이터 등. 이러한 페이로드를 수동으로 포맷하는 것은 오류가 발생하기 쉽습니다; 세미콜론 누락 또는 잘못된 필드 순서는 스캐너가 데이터를 잘못 해석하게 만듭니다.

IronQR는 이러한 구조적 문자열을 올바르게 구축하는 페이로드 도우미를 제공합니다:

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

using IronQr;
using IronSoftware.Drawing;

// Generate QR code with URL payload
var urlQrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
// Save QR as PNG image file
AnyBitmap qrImage = urlQrCode.Save();
qrImage.SaveAs("url-qr-code.png");
Console.WriteLine("QR code generated successfully.");

QR 코드의 외양을 어떻게 사용자 정의하나요?

IronQR는 스캔 가능성을 희생하지 않고 생성된 코드의 시각적 외형을 조절할 수 있습니다. 전경 및 배경 색을 변경하거나, 맞춤형 브랜딩을 적용하거나, 중앙의 침묵 구역에 로고를 삽입할 수 있습니다.

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

using IronQr;
using IronSoftware.Drawing;

// Define custom colors for the QR code
var darkColor = Color.FromArgb(30, 30, 120);   // Deep navy foreground
var lightColor = Color.White;

var options = new QrOptions(QrErrorCorrectionLevel.High, maxVersion: 20)
{
    BackgroundColor = lightColor,
    Color = darkColor,
    // Embed a logo image into the QR center
    Logo = AnyBitmap.FromFile("logo.png")
};

QrCode styledQr = QrWriter.Write("https://ironsoftware.com/csharp/qr/", options);
AnyBitmap output = styledQr.Save();
output.SaveAs("branded-qr.png");

로고를 삽입하면 유효한 데이터 영역을 줄이므로, 라이브러리는 로고를 제공할 때 오류 수정 수준 H를 요구합니다. 중앙에 예약된 침묵 구역은 코드 표면의 대략 30%를 차지하여,H수준의 복구 용량에 맞습니다. 라이브러리는 이 제약을 자동으로 적용합니다 -- 로고와 함께 낮은 오류 수정 수준을 설정하면, IronQR은 신뢰할 수 없는 스캔을 생성하기보다는 설명이 포함된 메시지와 함께 예외를 발생시킵니다.

ASP.NET Core 애플리케이션의 경우, ASP.NET Core QR 코드 생성기 튜토리얼은 생성된 QR 코드를 컨트롤러 액션에서 이미지 응답으로 제공하는 방법을 보여줍니다. 출력 스트림은 중간 파일 입출력 없이 응답에 직접 기록하여 고트래픽 엔드포인트의 대기 시간을 줄입니다.

ASP.NET Core 애플리케이션에서 QR 코드를 어떻게 읽습니까?

서버 측에서 QR 코드를 스캔하는 것은 -- 업로드된 이미지, 문서 처리 파이프라인, 또는 자동 검사 시스템에서 -- 읽기 API의 일반적인 사용 사례입니다. ASP.NET QR 코드 스캐너 가이드는 전체 컨트롤러 및 서비스 설정을 다루고 있지만, 핵심 읽기 패턴은 콘솔 애플리케이션과 동일합니다:

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

using IronQr;
using IronSoftware.Drawing;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/qr")]
public class QrScanController : ControllerBase
{
    [HttpPost("scan")]
    public IActionResult Scan(IFormFile imageFile)
    {
        using var stream = imageFile.OpenReadStream();
        var bitmap = AnyBitmap.FromStream(stream);
        var imageInput = new QrImageInput(bitmap);
        var reader = new QrReader();
        var results = reader.Read(imageInput);

        var decoded = results.Select(r => new { r.Value, r.Url }).ToList();
        return Ok(decoded);
    }
}

AnyBitmap.FromStream() 메서드는 모든 읽기 가능한 스트림을 허용하므로 같은 코드 경로가 양식으로 업로드된 파일, blob 저장소에서 가져온 이미지 또는 비디오 파이프라인에서 추출된 프레임에 작동합니다. 컨트롤러는 디스크에 임시 파일을 쓰지 않아, 파일 시스템이 읽기 전용일 수 있는 컨테이너화된 배포에 중요합니다.

고처리량 시나리오에서는 애플리케이션 수명 동안 한 번 QrReader을 싱글톤으로 인스턴스화하세요. ML 모델 로딩 비용은 처음 생성 시에 지불됩니다. 같은 인스턴스에서 후속 Read() 호출은 스레드 안전하며 로드된 모델을 공유합니다.

.NET MAUI 애플리케이션에서 QR 코드를 어떻게 생성합니까?

.NET MAUI QR 코드 튜토리얼은 iOS, Android, macOS, Windows에서의 풀 크로스 플랫폼 생성을 보여줍니다. IronQR는 Windows가 아닌 플랫폼에서 실행할 때 일관된 출력을 위한 SkiaSharp 렌더링 백엔드를 사용하여 모든 MAUI 대상에서 동일한 출력을 제공합니다.

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

using IronQr;
using IronSoftware.Drawing;

// Generate QR and convert to a byte array for display in MAUI
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");
AnyBitmap bitmap = qr.Save();
byte[] imageBytes = bitmap.ExportBytes();

// Bind imageBytes to an <Image Source> in your MAUI page

모바일 대상에서는 ExportBytes()이 직접 StreamImageSource에 공급할 수 있는 PNG 바이트 배열을 반환하거나 ImageButton에 쓸 수 있습니다. MAUI 스캐폴드는 플랫폼별 코드 경로가 필요하지 않습니다 -- 동일한 생성 로직이 모든 MAUI 타겟에서 동일하게 실행됩니다.

VB.NET 프로젝트의 경우 API 표면은 동일합니다; 단지 문법만 다릅니다. 이 라이브러리는 별도의 VB.NET 어셈블리가 필요 없는 단일 NuGet 패키지로 제공됩니다.

다음 단계는 무엇입니까?

IronQR은 .NET에서 기본 생성 및 구조화된 페이로드 인코딩부터 손상되거나 브랜드화된 코드의 ML 기반 읽기까지 QR 코드의 전체 수명 주기를 다룹니다. 이 라이브러리는 간지 인코딩, 오류 수정 구성, 크로스 플랫폼 이미지 출력을 처리하여, 애플리케이션에 특정한 로직에 집중할 수 있게 해줍니다.

배운 내용을 실천하기 위해:

• 읽기 API와 결과 처리를 깊이 있게 살펴보려면 C# QR 코드 리더 튜토리얼을 검토하십시오.
• 전체 프로젝트 연습을 위해 C# QR 코드 생성기 애플리케이션 튜토리얼을 진행해 보십시오.
• 추가 생성 및 읽기 패턴을 확인하려면 코드 예제를 살펴보십시오.
• 모든 기능을 사용하여 프로덕션 배포를 위해 IronQR 라이선스를 구매하거나 더 많은 평가 시간이 필요하면 무료 체험판을 연장하십시오.