如何使用不同的扫描模式读取二维码

This article was translated from English: Does it need improvement?
Translated
View the article in English

到 2025 年,随着越来越多的产品走向数字化和始终在线访问,读取二维码将成为一项常规任务。 将必要数据存储在紧凑的只读映像中已成为标准做法,开发人员需要有效的方法在不同的环境中提取这些信息。

IronQR 为二维码提供 3 种读取选项,每种选项都针对特定的使用场景而设计。

本操作指南将通过清晰的示例解释这三种方法。 如果您还没有看过,请查看之前关于从图像中读取二维码或编写自己的二维码的指南。

了解二维码扫描模式

IronQR 通过QrScanMode枚举提供三种强大的扫描模式:

-自动模式( QrScanMode.Auto ):结合机器学习检测和基本扫描算法,以实现最高的准确性和可靠性。 -仅基本扫描模式( QrScanMode.OnlyBasicScan ):当二维码清晰可见时,使用传统的图像处理技术进行快速可靠的扫描。 -检测模型模式QrScanMode.OnlyDetectionModel ):利用机器学习技术检测二维码位置,非常适合提取坐标数据

让我们详细了解一下每种扫描方法。


仅基本扫描模式

只有基本扫描模式使用传统的图像处理算法,而没有使用机器学习。 当二维码清晰可见且位置恰当时,这种方法快速高效; 但是,如果三个角上的方块清晰可见,即使二维码损坏,它仍然可以正常工作。

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-basic.cs
using System.Linq;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.IO;

 // Load the image
var bmp = AnyBitmap.FromFile("damaged-qr.png");

// Create scan input using Only Basic Scan mode
var input = new QrImageInput(bmp, QrScanMode.OnlyBasicScan);

// Get the result
var result = new QrReader().Read(input).FirstOrDefault();

// Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value);
$vbLabelText   $csharpLabel

扫描输入

损坏的二维码

已保存的文本文件

文本文件

自动扫描模式

自动扫描模式是默认模式(适用于QrScanMode ),也是功能最全面的选项。 它自动将机器学习检测与传统扫描算法相结合,从而在各种图像条件下提供最佳结果。

该示例展示了如何加载图像并激活Auto模式。 然后,它扫描图像,并将找到的每个二维码收集到一个列表中。最后,它遍历results集合,并将每个值对应的文本打印到控制台(在本例中,只有 URL)。

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-auto.cs
using System;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// Load the image file
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Auto Scan mode
var input = new QrImageInput(bmp, QrScanMode.Auto);

// Scan and read all QR codes
var results = new QrReader().Read(input);

// Initialize a counter to track the number of QR codes
int count = 1;

// Loop through each discovered QR code
foreach (var result in results)
{
    Console.WriteLine($"QR {count}: {result.Value}");
    count++;
}
$vbLabelText   $csharpLabel

扫描输入

带有咖啡馆网站链接的杯子

控制台显示

通过 IronQR 扫描照片后,咖啡馆网站的 URL 会被记录下来。

控制台显示网站网址

检测模型模式

检测模型模式专门利用机器学习技术来检测图像中的二维码位置。 这一特性使其在空间分析和计算机视觉应用中具有不可估量的价值。 它使用的坐标系原点位于(0, 0)

一般而言,QR 扫描器使用依赖于三个查找图案的标准解码算法,该模型捕获 ID 的所有四个顶点。 result对象包含一个Points集合,您可以通过遍历该集合来检索位置数据。

该代码重用了上一个示例中的杯子照片,以演示如何检测图像中的位置值。

此函数返回的坐标以严格的"之字形"顺序存储:左上、右上、左下,最后是右下。

:path=/static-assets/qr/content-code-examples/how-to/read-qr-codes-with-scan-modes-detection-model.cs
using System;
using System.Linq;
using IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;

// Load the image
var bmp = AnyBitmap.FromFile("cup.png");

// Create scan input using Detection Model mode
var input = new QrImageInput(bmp, QrScanMode.OnlyDetectionModel);

// Read QR code
var result = new QrReader().Read(input).FirstOrDefault();

// Print position data
if (result != null)
{
    if (result.Points != null)
    {
        foreach (var point in result.Points)
        {
            Console.WriteLine($"Point: X={point.X}, Y={point.Y}");
        }
    }
}
$vbLabelText   $csharpLabel

带标签的杯子图片

带标签的杯子

带标签的控制台

标签控制台

扫描方法比较

功能( QRScanMode基本扫描( OnlyBasicScan扫描)自动扫描( Auto检测模型( OnlyDetectionModel检测模型)
输出解码后的文本(值)解码后的文本(值)坐标(点)
算法仅限传统方式混合型(机器学习+传统)仅限机器学习
重点速度可读性/检索定位/计算机视觉

结论

IronQR的三种扫描模式可灵活应对任何二维码读取场景:

-自动扫描:适用于一般用途,具有最高的准确性和可靠性 -基本扫描:速度快、效率高,图像质量高。 -检测模型:空间应用的位置感知

通过了解每种方法的优势,您可以根据自身需求优化二维码读取实现。 无论您需要全面的数据提取、闪电般的处理速度还是精确的位置检测,IronQR 都能满足您的需求。

有关更多示例和详细的 API 信息,请访问IronQR 文档或浏览GitHub 上的代码示例

常见问题解答

读取二维码有哪些不同的扫描模式?

IronQR 提供自动、手动和批量扫描等多种扫描模式,可在不同场景下高效读取二维码。

如何在C#项目中实现二维码扫描?

您可以通过集成 IronQR 库在 C# 项目中实现二维码扫描,该库提供了易于使用的方法来读取具有不同扫描模式的二维码。

使用 IronQR 进行二维码扫描有哪些好处?

IronQR 具有高精度、快速处理能力,并支持不同的扫描模式,使其成为 C# 项目中二维码扫描的多功能选择。

IronQR 是否可以同时读取多个二维码?

是的,IronQR 支持批量扫描模式,可同时读取多个二维码,从而提高效率。

IronQR是否支持扫描来自不同来源的二维码?

IronQR 可以扫描来自各种来源的二维码,包括图像、PDF 和实时摄像头画面,为开发人员提供了灵活性。

IronQR 能否处理不同方向的二维码?

是的,IronQR 的设计旨在准确读取任何方向的二维码,确保可靠的扫描结果。

IronQR的自动扫描模式是如何工作的?

IronQR 的自动扫描模式可以智能地检测和读取二维码,无需手动输入,从而简化扫描过程。

使用 IronQR 进行二维码扫描需要哪些编程技能?

具备 C# 编程的基础知识即可使用 IronQR 进行二维码扫描,因为该库提供了简单直接的集成和使用方式。

IronQR是否有试用版可供测试?

是的,IronQR 提供试用版,允许开发者在购买前测试其功能和扫描模式。

我可以在哪里下载IronQR库?

您可以从 Iron Software 网站下载 IronQR 库,您还可以在该网站上找到文档和支持资源。

Ahmad Sohail
全栈开发者

Ahmad 是一名全栈开发人员,拥有扎实的 C#、Python 和 Web 技术基础。他对构建可扩展的软件解决方案深感兴趣,并喜欢探索设计和功能在实际应用中如何结合。

在加入 Iron Software 团队之前,Ahmad 致力于自动化项目和 API 集成,专注于提高性能和开发人员体验。

在业余时间,他喜欢尝试 UI/UX 想法,贡献开源工具,并偶尔从事技术写作和文档工作,以便让复杂主题更易于理解。

准备开始了吗?
Nuget 下载 55,860 | 版本: 2025.12 刚刚发布