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

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

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

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

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

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

-跨平台支持：可在 MAUI 应用程序中无缝运行于 iOS、Android、macOS 和 Windows 平台。 -二维码扫描：高效解码各种类型的二维码（网址、文本、联系信息等）。 它还支持用有效的条码检测算法读取多个条码。 -二维码生成：此功能可以轻松地从 URL、文本等数据生成二维码。 -摄像头权限处理：自动处理摄像头权限请求，简化扫描过程。 -高性能：快速可靠地扫描和生成二维码，资源占用极低。 -可自定义设置：提供扫描参数和二维码外观的自定义选项。 -轻松集成：只需简单的 API 和最少的设置，即可将二维码扫描和生成功能添加到您的 .NET MAUI 应用程序中。 -错误处理：提供详细的错误信息和故障排除，确保在各种情况下都能流畅运行。 -无外部依赖项： IronQR 独立运行，减少了对第三方库或复杂配置的需求，这与 ZXing 条码扫描器不同。 -多格式支持：支持多种二维码格式，确保与现实世界中使用的各种二维码兼容。

步骤1：创建.NET MAUI项目

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

1. 打开Visual Studio，点击创建新项目。
2. 选择.NET MAUI应用程序模板。

3. 为项目命名（例如，MauiQRCodeScanner），选择位置，然后点击下一步。

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

步骤2：安装IronQR NuGet包

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

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

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

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

<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" />

<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>

步骤4：实现二维码扫描仪

现在，让我们在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>

现在，在MainPage.xaml.cs中，您将处理摄像头权限和二维码扫描逻辑。 以下是如何实现它：

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;
        }
        }
    }
}

输出

！QR代码输出

选择所需的二维码或从摄像头饲料中捕获。

结果在UI中如下显示。

IronQR许可（可试用）

IronQR在移动应用代码中使用许可证密钥。 开发人员可以很容易地从许可证页面获取试用许可证。 在使用IronQR库之前，将许可证放置在代码中的某个位置，如下所示。

License.LicenseKey = "Your License";

License.LicenseKey = "Your License";

结论

在本文中，我们介绍了在.NET MAUI应用程序中使用IronQR构建二维码扫描仪的过程。 我们首先通过设置.NET MAUI应用程序，安装IronQR包，并实现UI和扫描逻辑开始。 IronQR使得在.NET MAUI应用程序中进行二维码扫描变得非常简单和有效。

IronQR库旨在跨平台，从而确保用.NET MAUI构建的应用程序可以在所有目标设备上一致地访问二维码功能，无论它们是智能手机、平板电脑还是台式系统。 IronQR还支持自动处理摄像头权限等功能，使得集成二维码扫描变得更容易，无需手动管理权限的麻烦。

简而言之，IronQR for .NET MAUI使开发人员能够快速在其移动应用中实现二维码扫描和生成功能，简化了开发并在所有平台上提升了用户体验。