使用 Aspose.BarCode 为 .NET 创建 Aztec 代码

Aztec 代码在移动机票、运输、安全支付和智能卡中广泛使用,因为它们的强度和快速阅读性.

引入

Aztec 代码是一种 2D 条码,提供高数据密度和强大的错误纠正能力. 它们是移动机票、运输、安全支付和智能卡的理想,因为它们的稳定性和快速阅读性.

原則

在开始之前,请确保您有以下内容:

  • Visual Studio 2019 或以后
  • .NET 6.0 或更高版本(或 .NET Framework 4.6.2+)
  • Aspose.BarCode for .NET 通过 NuGet 安装
  • 关于C#的基本知识#

要安装 Aspose.BarCode,请在 Package Manager Console 中执行下列命令:

PM> Install-Package Aspose.BarCode

步骤实施

步骤 1: 安装和进口 Aspose.BarCode

安装 NuGet 包并进口所需的名称空间:

using Aspose.BarCode.Generation;

步骤2:创建 Aztec 代码发电机

安装 Aztec 代码的发电机:

BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Aztec, "TICKET2025-BOARDING");

步骤3:自定义 Aztec 代码设置

设置层、ECC 和其他选项:

// Set number of layers (Auto or specific 1-32)
generator.Parameters.Barcode.Aztec.AztecLayers = AztecSymbolMode.Auto;
// Set error correction percent (default: 23%)
generator.Parameters.Barcode.Aztec.AztecErrorLevel = 33;
// Set module (pixel) size
generator.Parameters.Barcode.XDimension.Pixels = 6;
// Optional: Set foreground and background color
generator.Parameters.Barcode.BarColor = Color.Black;
generator.Parameters.Barcode.BackColor = Color.White;

步骤4:创建和保存 Aztec 代码

将代码导出到 PNG、JPEG 或任何支持的格式:

generator.Save("aztec-code.png", BarCodeImageFormat.Png);

完整的例子

以下是一個完整的例子,表明如何使用 Aspose.BarCode 在 C# 中生成 Aztec 代碼:

using Aspose.BarCode.Generation;
using System.Drawing; // Required for Color

class Program
{
    static void Main()
    {
        // Create Aztec generator for a ticket
        BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Aztec, "TICKET2025-BOARDING");
        generator.Parameters.Barcode.Aztec.AztecLayers = AztecSymbolMode.Auto;
        generator.Parameters.Barcode.Aztec.AztecErrorLevel = 33; // 33% error correction
        generator.Parameters.Barcode.XDimension.Pixels = 6;
        generator.Parameters.Barcode.BarColor = Color.Black;
        generator.Parameters.Barcode.BackColor = Color.White;
        generator.Save("aztec-code.png", BarCodeImageFormat.Png);
    }
}

使用案例和应用程序

  • 移动和运输门票: 地铁、航空公司或活动入口
  • 支付代码: 安全付款/交易编码
  • 身份证/智能卡: 安全的个人信息编码

共同挑战与解决方案

**挑战1: Aztec 代码不扫描?**解决方案: 增加错误纠正,验证对比和大小,测试用于指定的设备.

**挑战2:需要更高的安全性吗?**解决方案: 使用最大 ECC(高达95%),保持代码文本短,避免数据漏洞.

**挑战3:一个代码的数据太长了吗?**解决方案: 通过多个代码分解,或者转到 PDF417 为非常大的付费负载.

绩效考虑

  • Batch 为门票或移动应用程序创建 Aztec 代码
  • 使用内存流量,以便大容量内记忆出口
  • 调整层和ECC扫描可靠性

最佳实践

  • 使用自动模式为层,除非具体打印/尺寸要求
  • 在移动和手持设备上的测试输出
  • 出口到 PNG 为最佳印刷/显示质量
  • 文档所有代码文本和ECC设置可追踪

先进的场景

首页 > Batch Generate Aztec Codes

foreach (var item in tickets)
{
    BarcodeGenerator g = new BarcodeGenerator(EncodeTypes.Aztec, item.CodeText);
    g.Save($"aztec_{item.Id}.png", BarCodeImageFormat.Png);
}

二、设置特定的层数

generator.Parameters.Barcode.Aztec.AztecLayers = AztecSymbolMode.Layers16;

常见问题解答

1. Aztec 代码的最大容量是多少？

Aztec 代码的理论最大字符数约为 3,500 个数字或 1,800 个字母数字字符。实际使用时受模块大小和错误纠正等级影响，通常在 1,000–2,000 字符之间能够保持良好可读性。

2. 如何在不同尺寸的显示屏上保证可读性？

建议在生成时使用 XDimension.Pixels 调整模块像素大小，并结合 AztecLayers 自动模式让系统根据数据量自行选取合适层数。对移动端，可在 Save 前将图像缩放至 150–300 DPI，以兼容低分辨率摄像头。

3. 是否可以在同一张图片中嵌入多个 Aztec 条码？

可以，通过在同一 Graphics 对象上多次调用 generator.Save，并指定不同的坐标偏移。需要自行管理每个条码的边距，确保不相互覆盖。

4. 错误纠正等级提升会导致条码体积增大吗？

是的，错误纠正百分比越高，所需的模块数越多，最终图像尺寸会随之增大。实际项目中常在 23%–33% 之间权衡，特殊安全场景可选到 95%。

性能优化技巧

使用内存流避免磁盘 I/O

在高并发场景下，直接将条码写入 MemoryStream，再返回给前端或保存至云存储，可显著降低磁盘写入延迟。

using (var ms = new MemoryStream())
{
    generator.Save(ms, BarCodeImageFormat.Png);
    // 将 ms.ToArray() 发送到 HTTP 响应或上传至对象存储
}

批量生成时的并行处理

利用 Parallel.ForEach 对票据集合并行生成，每个线程使用独立的 BarcodeGenerator 实例，避免线程安全问题。

Parallel.ForEach(tickets, ticket =>
{
    var gen = new BarcodeGenerator(EncodeTypes.Aztec, ticket.CodeText);
    gen.Parameters.Barcode.Aztec.AztecLayers = AztecSymbolMode.Auto;
    gen.Save($"aztec_{ticket.Id}.png", BarCodeImageFormat.Png);
});

调整 XDimension 与模块大小的平衡

过小的模块会导致扫描困难，过大的模块会浪费空间。经验值是：在移动端使用 4–6 像素的 XDimension，在打印稿件上使用 8–10 像素，以获得最佳对比度。

在 ASP.NET Core 中的集成示例

下面演示如何在控制器中直接返回 PNG 图像，无需写入磁盘。

[ApiController]
[Route("api/[controller]")]
public class BarcodeController : ControllerBase
{
    [HttpGet("aztec/{text}")]
    public IActionResult GetAztec(string text)
    {
        var generator = new BarcodeGenerator(EncodeTypes.Aztec, text);
        generator.Parameters.Barcode.Aztec.AztecLayers = AztecSymbolMode.Auto;
        generator.Parameters.Barcode.XDimension.Pixels = 5;
        using var ms = new MemoryStream();
        generator.Save(ms, BarCodeImageFormat.Png);
        return File(ms.ToArray(), "image/png");
    }
}

结论

使用 Aspose.BarCode for .NET,您可以为运输、移动和安全工作流创建 Aztec 代码 - 以可靠性和速度为定制 Aspose.BarCode API 参考.

More in this category