2D Barcode Reader
How to Scan QR Codes with Unicode and ECI Encoding Using Aspose.BarCode for .NET

How to Scan QR Codes with Unicode and ECI Encoding Using Aspose.BarCode for .NET

This article explains how to scan and decode QR codes containing Unicode text or ECI-encoded (Extended Channel Interpretation) data using Aspose.BarCode for .NET. Unicode QR codes allow you to encode and extract data in any language—including emojis, CJK characters, and special symbols—making them ideal for global, multilingual applications.

Real-World Problem

Many business and consumer QR codes today carry information in multiple languages, or include binary data and special symbols. Standard barcode readers may return garbled output if they don’t handle Unicode or ECI encoding. Developers need a robust way to read these codes correctly.

Solution Overview

Aspose.BarCode for .NET supports reading and decoding Unicode and ECI-encoded QR codes. The library automatically recognizes encoding hints and delivers output as standard C# strings, preserving all characters and scripts.

Prerequisites

Before you start, ensure you have:

  1. Visual Studio 2019 or later
  2. .NET 6.0 or later (or .NET Framework 4.6.2+)
  3. Aspose.BarCode for .NET installed via NuGet
  4. Basic knowledge of C#
PM> Install-Package Aspose.BarCode

Step-by-Step Implementation

Step 1: Install and Configure Aspose.BarCode

Add the Aspose.BarCode package and include the required namespace:

using Aspose.BarCode.BarCodeRecognition;

Step 2: Prepare Your Input Data

Obtain or generate an image file containing a Unicode or ECI QR code (e.g., “unicode_qr_sample.png”).

string imagePath = "unicode_qr_sample.png";

Step 3: Configure QR Recognition for Unicode/ECI

Create the barcode reader as you would for any standard QR code:

BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.QR);

Step 4: Execute the QR Scanning Process

Read and display output, which may include Unicode scripts or emojis:

foreach (BarCodeResult result in reader.ReadBarCodes())
{
    Console.WriteLine($"Type: {result.CodeTypeName}");
    Console.WriteLine($"Text: {result.CodeText}");
}

Step 5: Process Output and Verify Encoding

The output string will contain all Unicode characters as present in the QR code. For binary (ECI) data, handle the output according to your application’s needs.

Step 6: Implement Error Handling 

try
{
    using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.QR))
    {
        foreach (BarCodeResult result in reader.ReadBarCodes())
        {
            Console.WriteLine($"Type: {result.CodeTypeName}");
            Console.WriteLine($"Text: {result.CodeText}");
        }
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}

Complete Example 

using Aspose.BarCode.BarCodeRecognition;
using System;

class Program
{
    static void Main()
    {
        string imagePath = "unicode_qr_sample.png";
        try
        {
            using (BarCodeReader reader = new BarCodeReader(imagePath, DecodeType.QR))
            {
                foreach (BarCodeResult result in reader.ReadBarCodes())
                {
                    Console.WriteLine($"Type: {result.CodeTypeName}");
                    Console.WriteLine($"Text: {result.CodeText}");
                }
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}

Use Cases and Applications

  • Multilingual Labeling: QR codes with information in any language (Chinese, Arabic, Japanese, etc.)
  • International Payments and Tickets: Encode customer names, cities, or instructions in native scripts
  • Binary Data and Emojis: QR codes containing non-text symbols for social, marketing, or security use

Common Challenges and Solutions

Challenge 1: Garbled or unreadable output Solution: Ensure QR was generated with correct Unicode/ECI support. Aspose.BarCode reads all such codes automatically.

Challenge 2: Special scripts not displaying Solution: Make sure your application’s UI and logs support Unicode output.

Challenge 3: Handling binary payloads Solution: Extract binary (byte array) if needed and process per your requirements.

Performance Considerations

  • Use UTF-8 encoding in all logs, UI, and storage
  • Dispose of reader instances promptly
  • Test decoding with QR codes from diverse languages and regions

Best Practices

  1. Always validate decoded Unicode/ECI data before processing
  2. Log output using Unicode-aware tools and editors
  3. Use appropriate error handling for edge cases
  4. Test with emojis, symbols, and rare scripts to ensure reliability

Advanced Scenarios

1. Decode and Display Emojis from QR 

// QR code contains: "Contact us: 😊📱"
foreach (BarCodeResult result in reader.ReadBarCodes())
{
    Console.WriteLine(result.CodeText); // Outputs emojis and text
}

2. Handle Binary Data in ECI-encoded QR 

foreach (BarCodeResult result in reader.ReadBarCodes())
{
    byte[] binaryData = result.Extended.QR.QRBinaryData;
    // Process binary data as needed
}

Conclusion

With Aspose.BarCode for .NET, you can accurately decode Unicode and ECI-encoded QR codes, enabling robust global and multilingual applications for any region or script.

For further details, see the Aspose.BarCode API Reference .

 English