如何使用不同的扫描模式读取二维码
到 2025 年,随着越来越多的产品走向数字化和始终在线访问,读取二维码将成为一项常规任务。 将必要数据存储在紧凑的只读映像中已成为标准做法,开发人员需要有效的方法在不同的环境中提取这些信息。
IronQR 为二维码提供 3 种读取选项,每种选项都针对特定的使用场景而设计。
本操作指南将通过清晰的示例解释这三种方法。 如果您还没有看过,请查看之前关于从图像中读取二维码或编写自己的二维码的指南。
如何使用不同的扫描模式读取二维码
- 下载 C# 库,即可使用高级扫描选项读取二维码
- 加载目标图像文件
- 初始化`QrImageInput` ,传入图像和所需的`QrScanMode`参数。
- 实例化`QrReader`类并将输入对象传递给`Read`方法。
- 检索结果以访问解码后的`Value`文本,或遍历`Points`数组以获取坐标数据。
了解扫描二维码的模式选项
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 IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.IO;
using System.Linq;
// 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);
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.IO
Imports System.Linq
' Load the image
Dim bmp = AnyBitmap.FromFile("damaged-qr.png")
' Create scan input using Only Basic Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyBasicScan)
' Get the result
Dim result = (New QrReader()).Read(input).FirstOrDefault()
' Save the output to a text file
File.WriteAllText("basic-scan-output.txt", result.Value)
扫描输入
已保存的文本文件
自动扫描模式
自动扫描模式是默认模式(适用于 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++;
}
Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
' Load the image file
Dim bmp = AnyBitmap.FromFile("cup.png")
' Create scan input using Auto Scan mode
Dim input = New QrImageInput(bmp, QrScanMode.Auto)
' Scan and read all QR codes
Dim results = New QrReader().Read(input)
' Initialize a counter to track the number of QR codes
Dim count As Integer = 1
' Loop through each discovered QR code
For Each result In results
Console.WriteLine($"QR {count}: {result.Value}")
count += 1
Next
扫描输入
控制台显示
通过 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 IronQr;
using IronQr.Enum;
using IronSoftware.Drawing;
using System.Linq;
// 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}");
}
}
}
Imports System
Imports IronQr
Imports IronQr.Enum
Imports IronSoftware.Drawing
Imports System.Linq
' Load the image
Dim bmp = AnyBitmap.FromFile("cup.png")
' Create scan input using Detection Model mode
Dim input = New QrImageInput(bmp, QrScanMode.OnlyDetectionModel)
' Read QR code
Dim result = (New QrReader()).Read(input).FirstOrDefault()
' Print position data
If result IsNot Nothing Then
If result.Points IsNot Nothing Then
For Each point In result.Points
Console.WriteLine($"Point: X={point.X}, Y={point.Y}")
Next
End If
End If
带标签的杯子图片
带标签的控制台
扫描方法比较
| 功能( `QRScanMode` ) | 基本扫描( `OnlyBasicScan`扫描) | 自动扫描( `Auto` ) | 检测模型( `OnlyDetectionModel`检测模型) |
|---|---|---|---|
| **输出** | 解码后的文本(值) | 解码后的文本(值) | 坐标(点) |
| **算法** | 仅限传统方式 | 混合型(机器学习+传统) | 仅限机器学习 |
| **重点** | 速度 | 可读性/检索 | 定位/计算机视觉 |
结论
IronQR的三种扫描模式可灵活应对任何二维码读取场景:
-自动扫描:适用于一般用途,具有最高的准确性和可靠性 -基本扫描:速度快、效率高,图像质量高。 -检测模型:空间应用的位置感知
通过了解每种方法的优势,您可以根据自身需求优化二维码读取实现。 无论您需要全面的数据提取、闪电般的处理速度还是精确的位置检测,IronQR 都能满足您的需求。
有关更多示例和详细的 API 信息,请访问IronQR 文档或浏览GitHub 上的代码示例。
常见问题解答
读取二维码有哪些不同的扫描模式?
IronQR 提供自动、手动和批量扫描等多种扫描模式,可在不同场景下高效读取 QR 码。
如何在 C# 项目中实现二维码扫描?
您可以通过集成 IronQR 库在 C# 项目中实现 QR 码扫描,该库提供了易于使用的方法来读取具有不同扫描模式的 QR 码。
使用 IronQR 进行二维码扫描有哪些好处?
IronQR 具有精度高、处理速度快的特点,并支持不同的扫描模式,是 C# 项目中二维码扫描的多功能选择。
是否可以使用 IronQR 同时读取多个二维码?
是的,IronQR 支持批量扫描模式,允许您同时读取多个二维码以提高效率。
IronQR 是否支持扫描各种来源的二维码?
IronQR 可以扫描各种来源的 QR 码,包括图像、PDF 和实时摄像机画面,为开发人员提供了灵活性。
IronQR 能否处理不同方向的 QR 代码?
是的,IronQR 的设计可以准确读取 QR 代码,无论其方向如何,确保可靠的扫描结果。
IronQR 中的自动扫描模式如何工作?
IronQR 的自动扫描模式可智能检测和读取二维码,无需手动输入,简化了扫描流程。
使用 IronQR 进行二维码扫描需要哪些编程技能?
使用 IronQR 进行二维码扫描只需具备基本的 C# 编程知识即可,因为该库提供了直接的集成和使用方法。
是否有 IronQR 试用版可供测试?
是的,IronQR 提供试用版,允许开发人员在承诺购买之前测试其功能和扫描模式。
在哪里可以下载 IronQR 库?
IronQR 库可从 Iron Software 网站下载,您还可以在该网站找到文档和支持资源。

