如何使用 .NET MAUI 進行 QR 碼掃描器

如何使用IronQR實現二維碼掃描

1. 建立一個.NET MAUI專案。
2. 安裝IronQR NuGet套件。
3. 設定相機和檔案儲存權限。
4. 實作二維碼掃描器。

IronQR for .NET MAUI行動應用程式簡介

IronQR是一個功能強大、易於使用的函式庫，可簡化.NET應用程式（包括.NET MAUI行動應用程式）中二維碼的產生和解碼，實現二維碼和條碼掃描功能。 它為跨平台（如 iOS、Android、macOS 和 Windows）整合二維碼和條碼掃描功能提供了快速可靠的解決方案，這對於建立跨平台行動應用程式至關重要。

IronQR for .NET MAUI行動應用程式的功能

-跨平台支援：可在 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>

第四步：實現二維碼掃描器

現在，讓我們在 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;
        }
        }
    }
}

輸出

選擇所需的二維碼或從相機畫面中捕捉二維碼。

結果在使用者介面中顯示如下。

IronQR許可證(提供試用版)

IronQR透過行動應用程式程式碼中的許可證金鑰來運作。 開發者可以輕鬆地從許可證頁面取得試用許可證。 在使用IronQR庫之前，請將許可證資訊如下新增至程式碼。

License.LicenseKey = "Your License";

License.LicenseKey = "Your License";

結論

在本文中，我們逐步介紹如何使用IronQR在.NET MAUI應用程式中建立二維碼掃描器。 我們首先建立了一個.NET MAUI應用程序，安裝了IronQR套件，並實作了 UI 和掃描邏輯。 IronQR使.NET MAUI應用程式中的二維碼掃描變得極其簡單且有效率。

IronQR庫的設計目標是跨平台的，確保使用.NET MAUI建立的應用程式可以在所有目標裝置上（無論是智慧型手機、平板電腦或桌上型電腦系統）一致地存取二維碼功能。 IronQR還支援自動相機權限處理等功能，讓整合式二維碼掃描變得更加容易，無需手動管理權限。

簡而言之， IronQR for .NET MAUI使開發人員能夠在行動應用程式中快速實現二維碼掃描和生成功能，從而簡化開發並改善所有平台上的用戶體驗。