QR コード.NET Core: C# で QR コードを読み取り、生成する

QR コード ライブラリはどのようにインストールしますか?

NuGet経由でIronQRをインストールするには数秒かかります。 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 Web アプリケーション、コンソール アプリ、およびデスクトップ ソリューションで動作します。 インストールすると、必要な拡張メソッドとタイプがすべてすぐに利用できるようになります。

画像から基本的な 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 コード標準では、低 (L)、中 (M)、四分位 (Q)、高 (H) の 4 つのレベルが定義されており、各レベルはストレージ容量と損傷許容度をトレードオフします。

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 は、数字、英数字、バイト、漢字など、あらゆる QR エンコード モードをサポートしています。 日本語のテキストやその他の Unicode コンテンツの場合、ライブラリは最もスペース効率の高いエンコーディングを自動的に選択します。

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 コードをコントローラー アクションからの画像応答として提供する方法を説明します。 出力ストリームは中間ファイル I/O なしで応答に直接書き込むため、トラフィック量の多いエンドポイントのレイテンシが低く抑えられます。

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 ストレージから取得された画像、ビデオパイプラインから抽出されたフレームなど、あらゆるストリームに同じコードパスを適用できます。コントローラーは一時ファイルをディスクに書き込まないため、ファイルシステムが読み取り専用になる可能性があるコンテナ化されたデプロイメントではこの点が重要になります。

高スループットのシナリオでは、ML モデルの読み込みコストが最初の構築時に支払われるため、アプリケーションの有効期間ごとに QrReader をシングルトンとして 1 回インスタンス化します。 同じインスタンスに対する後続の 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 に直接入力したり、ImageButton に書き込んだりできる PNG バイト配列を返します。 MAUI スキャフォールドでは、プラットフォーム固有のコード パスは必要ありません。同じ生成ロジックが 4 つの MAUI ターゲットすべてで同じように実行されます。

VB .NETプロジェクトの場合、API サーフェスは同一です。 構文のみが異なります。 ライブラリには、個別の VB .NETアセンブリを必要としない単一のNuGetパッケージが付属しています。

次のステップは何ですか?

IronQR は、基本的な生成と構造化ペイロードのエンコーディングから、破損したコードやブランド化されたコードの ML による読み取りまで、 .NETでの QR コードのライフサイクル全体をカバーします。 ライブラリは漢字エンコード、エラー訂正構成、クロスプラットフォーム画像出力を処理するため、アプリケーション固有のロジックに集中できます。

学んだことを実践するには:

• 読み取り API と結果処理の詳細については、 C# QR コード リーダー チュートリアルを参照してください。
• 完全なプロジェクト ウォークスルーについては、 C# QR コード ジェネレーター アプリケーション チュートリアルを参照してください。 -コード例を参照して、追加の生成および読み取りパターンを確認します。
• IronQRライセンスを購入して、本番環境への展開に必要なすべての機能のロックを解除するか、評価期間を延長したい場合は無料トライアルを延長してください。