我如何在.NET MAUI应用中集成QR Code扫描器？

要在.NET MAUI应用中集成QR Code扫描器，请通过NuGet安装IronQR库，并使用 QrReader.Read() 解码QR Codes。

创建用于QR扫描的.NET MAUI项目的步骤是什么？

首先打开Visual Studio，使用.NET MAUI App模板创建一个新项目，并选择必要的.NET版本。然后，安装IronQR库以实施QR扫描。

在.NET MAUI应用中QR扫描需要哪些必备权限？

QR扫描需要摄像头权限。在Android上，在 AndroidManifest.xml 中添加必要的权限，在iOS上，更新 Info.plist 以描述摄像头使用。

我如何在.NET MAUI应用中管理摄像头权限？

使用 Permissions.RequestAsync () 请求摄像头权限。如果被拒绝，请显示警报通知用户。

使用IronQR库进行QR扫描有什么好处？

IronQR提供跨平台支持、高性能、可定制设置、自动摄像头权限处理和多格式支持，使其成为.NET MAUI应用的理想选择。

我如何排除.NET MAUI应用中QR Code扫描的问题？

确保IronQR库已正确安装、摄像头权限已授予且设备摄像头正常工作。使用try-catch块检查代码中的任何错误。

开发.NET MAUI和QR扫描需要什么？

您需要Visual Studio 2022或更高版本、.NET 6.0 SDK或更新版本，以及IronQR NuGet包来促进QR Code扫描和条形码检测。

我如何获得QR code库的试用许可证？

访问IronQR许可证页面获取试用许可证密钥。在使用IronQR功能之前将许可证密钥插入代码中。

IronQR库支持哪些格式的QR扫描？

IronQR支持多种QR Code和条形码格式，确保可在不同应用和平台上使用。

我如何在.NET应用中生成QR Codes？

使用IronQR库的方法有效地生成QR Codes，允许您根据应用程序的需要自定义设置。

C# QR Code Library

Explore IronQR 免费试用

QR 快速入门

查看所有%s代码示例

using IronQr;
using IronSoftware.Drawing;

// Create a QR Code object
QrCode myQr = QrWriter.Write("hello world");

// Save QR Code as a Bitmap
AnyBitmap qrImage = myQr.Save();

// Save QR Code Bitmap as File
qrImage.SaveAs("qr.png");

using IronQr;
using IronSoftware.Drawing;

// Create a QR Code object
QrCode myQr = QrWriter.Write("hello world");

// Save QR Code as a Bitmap
AnyBitmap qrImage = myQr.Save();

// Save QR Code Bitmap as File
qrImage.SaveAs("qr.png");

PM >Install-Package IronQR

Install-Package IronQR

USING IRONQR

如何使用 .NET MAUI 进行 QR 代码扫描

Curtis Chau

Updated: 2026年4月21日

随着移动应用程序利用QR码快速获取信息的增长，对高效且易于集成的QR码扫描器以及.NET MAUI条码扫描器以扫描条形码的需求也在增加。 .NET MAUI（多平台应用程序UI），微软的跨平台框架，提供了一个统一的环境，用于跨iOS、Android、macOS和Windows构建应用程序。在.NET MAUI应用程序中扫描二维码时，开发者需要一个直观且功能强大的库来管理这个过程。

IronQR是一个受欢迎的库，可以让开发人员快速、准确和可靠地生成和解码QR码。本文将引导您通过与.NET MAUI集成IronQR构建一个可以在多平台无缝工作的QR/条码扫描器。

如何使用IronQR实现二维码条码扫描

创建一个.NET MAUI项目。
安装IronQR NuGet包。
设置相机和文件存储的权限。
实现二维码扫描仪。

面向.NET MAUI移动应用的IronQR简介

IronQR是一个强大且易于使用的库，它简化了在.NET应用程序中生成和解码二维码的过程，包括用于二维码和条码扫描功能的.NET MAUI移动应用。它为跨平台（如iOS、Android、macOS和Windows）的二维码和条码扫描功能集成提供了快速和可靠的解决方案，这对于构建跨平台移动应用至关重要。

面向.NET MAUI移动应用的IronQR功能

**跨平台支持：**在 MAUI 应用中，可无缝运行于 iOS、Android、macOS 和 Windows 平台。
**QR 码扫描：**高效解码各类 QR 码（URL、文本、联系信息等）。它还支持用有效的条码检测算法读取多个条码。
**QR 码生成：**支持从 URL、文本等数据中轻松生成 QR 码。
**相机权限处理：**自动处理相机权限请求，简化扫描流程。
**高性能：**资源占用极低，可实现快速且可靠的QR码扫描与生成。
**可自定义设置：**提供扫描参数和QR码外观的自定义选项。
**轻松集成：**通过简单的 API 和极少的配置，即可为您的 .NET MAUI 应用添加 QR 码扫描和生成功能。
**错误处理：**提供详细的错误信息和故障排除指南，确保在各种场景下功能运行顺畅。
**无外部依赖：**IronQR 独立运行，无需第三方库或复杂配置，这与 ZXing BarCode 扫描器不同。
**多格式支持：**支持多种QR码格式，确保与现实世界中广泛使用的各类QR码兼容。

先决条件

在进行实施之前，请确保您具备以下先决条件：

安装了Visual Studio 2022或更高版本。
.NET 6.0 SDK或更高版本（因为.NET MAUI是基于.NET 6及更新版本构建的）。
用于二维码扫描和条码检测的IronQR NuGet包。
.NET MAUI应用程序（如果您还没有一个，可以在Visual Studio中创建一个新的MAUI应用）。

步骤1：创建.NET MAUI项目

首先，让我们创建一个简单的.NET MAUI项目：

打开Visual Studio，点击创建新项目。
选择**.NET MAUI应用程序**模板。
为项目命名（例如，MauiQRCodeScanner），选择位置，然后点击下一步。

选择所需的.NET版本并点击创建。

目标框架

步骤2：安装IronQR NuGet包

IronQR是一个第三方库，提供二维码生成和扫描功能。要安装IronQR，您需要通过NuGet添加它：

在Visual Studio中，右键点击你的解决方案资源管理器中的依赖项。
点击管理NuGet包。
在浏览选项卡中，搜索IronQR，然后在相关的包上点击安装（通常是IronQR或IronQr.Maui，如果专门适用于MAUI）。
接受任何许可并确保库已安装。

步骤3：为摄像头和文件存储设置权限

为了让您的应用程序扫描二维码，您需要在移动平台（iOS和Android）上请求摄像头权限。以下是您如何添加以下权限。

Android

在AndroidManifest.xml文件中，添加相机权限：

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />

<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.camera" />

XML

iOS

在Info.plist文件中，添加相机使用说明：

<key>NSCameraUsageDescription</key>
<string>We need access to your camera to scan QR codes</string>

<key>NSCameraUsageDescription</key>
<string>We need access to your camera to scan QR codes</string>

XML

步骤4：实现QR码扫描器

现在，让我们在MAUI条码扫描应用中创建一个简单的用户界面来实现我们的二维码扫描仪。我们将使用按钮来触发扫描过程，并使用标签来显示扫描的二维码文本。

在XML命名空间中编辑MainPage.xaml文件。

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="MauiQRCodeScanner.MainPage">

    <StackLayout Padding="20" VerticalOptions="Center">
        <Button x:Name="scanButton" Text="Scan QR Code" Clicked="OnScanButtonClicked" />
        <Label x:Name="resultLabel" Text="Scan Result will appear here" HorizontalOptions="Center" VerticalOptions="CenterAndExpand"/>
    </StackLayout>
</ContentPage>

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="MauiQRCodeScanner.MainPage">

    <StackLayout Padding="20" VerticalOptions="Center">
        <Button x:Name="scanButton" Text="Scan QR Code" Clicked="OnScanButtonClicked" />
        <Label x:Name="resultLabel" Text="Scan Result will appear here" HorizontalOptions="Center" VerticalOptions="CenterAndExpand"/>
    </StackLayout>
</ContentPage>

XML

现在，在MainPage.xaml.cs中，您将处理相机权限和QR码扫描逻辑。以下是如何实现它：

using IronQrCode;
using Microsoft.Maui.Controls;
using Microsoft.Maui.Essentials;

namespace MauiQRCodeScanner
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            License.LicenseKey = "Your key";  // Add your IronQR license key here
            InitializeComponent();
        }

        // OnScanButtonClicked method with object sender as input
        private async void OnScanButtonClicked(object sender, EventArgs e)
        {
            // Check for camera permission
            var status = await Permissions.RequestAsync<Permissions.Camera>();
            if (status != PermissionStatus.Granted)
            {
                await DisplayAlert("Permission Denied", "Cannot scan QR codes without camera permission", "OK");
                return;
            }

            // Start scanning QR codes
            try
            {
                var images = await FilePicker.Default.PickAsync(new PickOptions
                {
                    PickerTitle = "Pick image",
                    FileTypes = FilePickerFileType.Images
                });
                var imageSource = images.FullPath.ToString();

                var inputBmp = AnyBitmap.FromFile(imageSource);
                // Load the asset into QrImageInput
                QrImageInput imageInput = new QrImageInput(inputBmp);

                // Create a QR Reader object
                QrReader reader = new QrReader();

                // Read the input and get all embedded QR Codes
                IEnumerable<QrResult> results = reader.Read(imageInput);

                if (results.Any())
                {
                    resultLabel.Text = "Scanned Text: " + results.First().Value; 
        // Display the result
                }
                else
                {
                    resultLabel.Text = "No QR code detected";
                }
        }
        catch (Exception ex)
        {
            resultLabel.Text = "Error: " + ex.Message;
        }
        }
    }
}

using IronQrCode;
using Microsoft.Maui.Controls;
using Microsoft.Maui.Essentials;

namespace MauiQRCodeScanner
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            License.LicenseKey = "Your key";  // Add your IronQR license key here
            InitializeComponent();
        }

        // OnScanButtonClicked method with object sender as input
        private async void OnScanButtonClicked(object sender, EventArgs e)
        {
            // Check for camera permission
            var status = await Permissions.RequestAsync<Permissions.Camera>();
            if (status != PermissionStatus.Granted)
            {
                await DisplayAlert("Permission Denied", "Cannot scan QR codes without camera permission", "OK");
                return;
            }

            // Start scanning QR codes
            try
            {
                var images = await FilePicker.Default.PickAsync(new PickOptions
                {
                    PickerTitle = "Pick image",
                    FileTypes = FilePickerFileType.Images
                });
                var imageSource = images.FullPath.ToString();

                var inputBmp = AnyBitmap.FromFile(imageSource);
                // Load the asset into QrImageInput
                QrImageInput imageInput = new QrImageInput(inputBmp);

                // Create a QR Reader object
                QrReader reader = new QrReader();

                // Read the input and get all embedded QR Codes
                IEnumerable<QrResult> results = reader.Read(imageInput);

                if (results.Any())
                {
                    resultLabel.Text = "Scanned Text: " + results.First().Value; 
        // Display the result
                }
                else
                {
                    resultLabel.Text = "No QR code detected";
                }
        }
        catch (Exception ex)
        {
            resultLabel.Text = "Error: " + ex.Message;
        }
        }
    }
}

Imports IronQrCode
Imports Microsoft.Maui.Controls
Imports Microsoft.Maui.Essentials

Namespace MauiQRCodeScanner
	Partial Public Class MainPage
		Inherits ContentPage

		Public Sub New()
			License.LicenseKey = "Your key" ' Add your IronQR license key here
			InitializeComponent()
		End Sub

		' OnScanButtonClicked method with object sender as input
		Private Async Sub OnScanButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
			' Check for camera permission
			Dim status = Await Permissions.RequestAsync(Of Permissions.Camera)()
			If status <> PermissionStatus.Granted Then
				Await DisplayAlert("Permission Denied", "Cannot scan QR codes without camera permission", "OK")
				Return
			End If

			' Start scanning QR codes
			Try
				Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
					.PickerTitle = "Pick image",
					.FileTypes = FilePickerFileType.Images
				})
				Dim imageSource = images.FullPath.ToString()

				Dim inputBmp = AnyBitmap.FromFile(imageSource)
				' Load the asset into QrImageInput
				Dim imageInput As New QrImageInput(inputBmp)

				' Create a QR Reader object
				Dim reader As New QrReader()

				' Read the input and get all embedded QR Codes
				Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

				If results.Any() Then
					resultLabel.Text = "Scanned Text: " & results.First().Value
		' Display the result
				Else
					resultLabel.Text = "No QR code detected"
				End If
		Catch ex As Exception
			resultLabel.Text = "Error: " & ex.Message
		End Try
		End Sub
	End Class
End Namespace

Imports IronQrCode
Imports Microsoft.Maui.Controls
Imports Microsoft.Maui.Essentials

Namespace MauiQRCodeScanner
	Partial Public Class MainPage
		Inherits ContentPage

		Public Sub New()
			License.LicenseKey = "Your key" ' Add your IronQR license key here
			InitializeComponent()
		End Sub

		' OnScanButtonClicked method with object sender as input
		Private Async Sub OnScanButtonClicked(ByVal sender As Object, ByVal e As EventArgs)
			' Check for camera permission
			Dim status = Await Permissions.RequestAsync(Of Permissions.Camera)()
			If status <> PermissionStatus.Granted Then
				Await DisplayAlert("Permission Denied", "Cannot scan QR codes without camera permission", "OK")
				Return
			End If

			' Start scanning QR codes
			Try
				Dim images = Await FilePicker.Default.PickAsync(New PickOptions With {
					.PickerTitle = "Pick image",
					.FileTypes = FilePickerFileType.Images
				})
				Dim imageSource = images.FullPath.ToString()

				Dim inputBmp = AnyBitmap.FromFile(imageSource)
				' Load the asset into QrImageInput
				Dim imageInput As New QrImageInput(inputBmp)

				' Create a QR Reader object
				Dim reader As New QrReader()

				' Read the input and get all embedded QR Codes
				Dim results As IEnumerable(Of QrResult) = reader.Read(imageInput)

				If results.Any() Then
					resultLabel.Text = "Scanned Text: " & results.First().Value
		' Display the result
				Else
					resultLabel.Text = "No QR code detected"
				End If
		Catch ex As Exception
			resultLabel.Text = "Error: " & ex.Message
		End Try
		End Sub
	End Class
End Namespace

代码解释

**权限：**我们使用Permissions.RequestAsync<Permissions.Camera>()请求相机权限。如果权限被拒绝，用户会看到一个警告。
**IronQR Scanner：**使用 IronQR 库的对象和方法扫描 QR 码。 QrReader.Read()方法尝试解码QR码，结果显示在标签上。