C#에서 이미지에서 QR 코드를 읽는 방법

주요 특징

• QR 코드를 쉽게 읽고 생성합니다.
• JPEG, PNG, BMP 및 기타 이미지 형식을 지원합니다.
• 고속의 성능과 정확한 검출로 QR 코드 데이터를 쉽게 추출할 수 있습니다.
• .NET Framework, .NET Core, .NET Standard (2.0+), 그리고 .NET 6/7+ 프로젝트에서 작동합니다.
• 윈도우, 리눅스 또는 기타 지원 환경과 같은 선호하는 앱 환경 및 운영 체제에서 작업할 수 있도록 플랫폼 간 지원을 제공합니다.

오픈 소스 대안과 달리, IronQR은 Enterprise급 안정성, 상용 라이선스 및 전문 지원에 중점을 두어 비즈니스 중요 앱에 적합합니다.

NuGet 통해 설치하세요

NuGet 패키지 관리자 콘솔에서 IronQR을 직접 설치할 수 있습니다:

Install-Package IronQR

Install-Package IronQR

또는 Visual Studio의 NuGet GUI를 사용하여 IronQR을 검색하고 "설치"를 클릭하십시오:

네임스페이스 추가 및 기본 설정

설치 후, 다음 네임스페이스를 C# 파일에 포함하십시오:

using IronSoftware.Drawing;
using IronQR;

using IronSoftware.Drawing;
using IronQR;

참고: IronSoftware.Drawing은 플랫폼 간 방식으로 이미지 형식을 처리하는 데 사용됩니다.

지원되는 이미지 형식

IronQR은 다음을 포함하여 여러 유형의 이미지 형식을 지원합니다:

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

이런 유연성 덕분에 카메라 스냅샷에서 스캔 문서까지 거의 모든 이미지 소스를 작업할 수 있습니다.

기본 코드 예제

이 라이브러리를 사용하여 QR 코드를 쉽게 디코딩하는 방법을 자세히 살펴보겠습니다. 여기에서는 Bitmap 클래스와 파일 스트림을 사용하여 이미지 파일에서 'Hello World!'라는 텍스트 값을 포함하는 단일 QR 코드를 읽는 최소한의 예를 소개합니다:

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

콘솔 출력

이 코드는 QR 코드 이미지를 로드하고, 첫 번째로 감지된 QR 코드를 읽고, 디코딩된 내용을 출력합니다. 간단하면서도 효과적입니다. 여기에서 QR 코드의 값을 저장하여 나중에 사용할 수 있습니다.

여러 QR 코드 처리

이미지에 여러 QR 코드(예: 제품 레이블 시트)가 포함된 경우 모든 코드를 추출할 수 있습니다. 이 예제에서는 다음 QR 코드 이미지를 프로그램을 통해 실행합니다:

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

출력

이미지 품질이 낮음

흐릿하거나 해상도가 낮은 이미지는 QR 코드를 감지하기 어렵게 만들 수 있습니다. 가능한 경우 고품질 입력을 사용하십시오.

QR 코드가 감지되지 않음

이미지가 너무 어둡지 않고, 강한 대조를 가지며, QR 코드가 가려지지 않았는지 확인하십시오. QR 영역에 초점을 맞추기 위해 이미지를 자르십시오.

예외 처리

손상된 파일이나 예상치 못한 형식을 우아하게 처리하기 위해 항상 QR 읽기 로직을 트라이-캐치 블록으로 감싸십시오:

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