Cómo usar .NET MAUI para un escáner de códigos QR

Cómo implementar el escaneo de códigos de barras QR con IronQR

1. Crear un proyecto .NET MAUI.
2. Instalar el paquete NuGet de IronQR.
3. Configurar permisos para la cámara y el almacenamiento de archivos.
4. Implementar el escáner de códigos QR.

Introducción a IronQR para aplicaciones móviles .NET MAUI

IronQR es una biblioteca potente y fácil de usar que simplifica la generación y descodificación de códigos QR en aplicaciones .NET, incluidas las aplicaciones móviles .NET MAUI para la funcionalidad de escaneo de códigos QR y códigos de barras. Proporciona soluciones rápidas y confiables para integrar la funcionalidad de escaneo de códigos QR y códigos de barras en plataformas como iOS, Android, macOS y Windows, lo cual es esencial para construir aplicaciones móviles multiplataforma.

Características de IronQR para aplicaciones móviles .NET MAUI

• Compatibilidad multiplataforma: funciona sin problemas en plataformas iOS, Android, macOS y Windows dentro de las aplicaciones de MAUI.
• Escaneo de códigos QR: decodifica eficientemente varios tipos de códigos QR (URL, texto, información de contacto, etc.). También admite múltiples códigos de barras leídos con algoritmos de detección de códigos de barras eficientes.
• Generación de códigos QR: esto permite la fácil generación de códigos QR a partir de datos como URL, textos y más.
• Manejo de permisos de cámara: maneja automáticamente las solicitudes de permisos de cámara, lo que simplifica el proceso de escaneo.
• Alto rendimiento: escaneo y generación de códigos QR rápidos y confiables con un uso mínimo de recursos.
• Configuración personalizable: ofrece opciones de personalización para los parámetros de escaneo y la apariencia del código QR.
• Fácil integración: API simple y configuración mínima requerida para agregar escaneo y generación de códigos QR a su aplicación .NET MAUI.
• Manejo de errores: proporciona mensajes de error detallados y resolución de problemas, lo que garantiza un funcionamiento fluido en diversos escenarios.
• Sin dependencias externas: IronQR funciona de forma independiente, lo que reduce la necesidad de bibliotecas de terceros o configuraciones complejas, a diferencia del escáner de código de barras ZXing.
• Compatibilidad con múltiples formatos: admite múltiples formatos de códigos QR, lo que garantiza la compatibilidad con una amplia gama de códigos QR utilizados en el mundo real.

Paso 1: Crear un proyecto .NET MAUI

Para comenzar, vamos a crear un proyecto .NET MAUI simple:

1. Abra Visual Studio y haga clic en Crear un nuevo proyecto.
2. Seleccione la plantilla de Aplicación .NET MAUI.

3. Nombre el proyecto (por ejemplo, MauiQRCodeScanner), seleccione una ubicación y haga clic en Siguiente.

Seleccione la versión requerida de .NET y haga clic en Crear.

Paso 2: Instale el paquete NuGet de IronQR

IronQR es una biblioteca de terceros que proporciona funcionalidades de generación y escaneo de códigos QR. Para instalar IronQR, necesita agregarlo a través de NuGet:

1. En Visual Studio, haga clic derecho en Dependencias en su Explorador de soluciones.
2. Haga clic en Administrar paquetes NuGet.
3. En la pestaña Examinar, busque IronQR y haga clic en Instalar en el paquete relevante (generalmente IronQR o IronQR.Maui si está disponible específicamente para MAUI).
4. Acepte cualquier licencia y asegúrese de que la biblioteca se instale.

Paso 3: Configurar permisos para la cámara y el almacenamiento de archivos

Para que su aplicación escanee códigos QR, necesitará solicitar permisos de cámara en plataformas móviles (iOS y Android). Aquí se explica cómo puede agregar los siguientes permisos.

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

Paso 4: Implementar el escáner de código QR

Ahora, vamos a crear una interfaz de usuario simple para nuestro escáner de códigos QR en la aplicación de escáner de código de barras MAUI. Utilizaremos el botón para activar el proceso de escaneo y una etiqueta para mostrar el texto del código QR escaneado.

Edite el archivo MainPage.xaml en el espacio de nombres XML.

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

Ahora, en el MainPage.xaml.cs, manejará los permisos de la cámara y la lógica del escaneo de códigos QR. Aquí está cómo implementarlo:

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

Producción

Seleccione el código QR requerido o cápturelo desde el feed de la cámara.

El resultado se muestra en la interfaz como se indica.

Licencia IronQR (versión de prueba disponible)

IronQR funciona con una clave de licencia en el código de la aplicación móvil. Los desarrolladores pueden obtener fácilmente una licencia de prueba desde la página de licencia. Coloque la licencia en algún lugar del código como se muestra a continuación antes de usar la biblioteca IronQR.

License.LicenseKey = "Your License";

License.LicenseKey = "Your License";

Conclusión

En este artículo, recorrimos el proceso de construcción de un escáner de códigos QR en una aplicación .NET MAUI usando IronQR. Comenzamos configurando una aplicación .NET MAUI, instalamos el paquete IronQR e implementamos la interfaz de usuario y la lógica de escaneo. IronQR hace que el escaneo de códigos QR en una aplicación .NET MAUI sea increíblemente simple y efectivo.

La biblioteca IronQR está diseñada para ser multiplataforma, asegurando que las aplicaciones construidas con .NET MAUI puedan acceder a la funcionalidad de códigos QR de manera consistente en todos los dispositivos objetivo, ya sean teléfonos inteligentes, tabletas o sistemas de escritorio. IronQR también admite funciones como el manejo automático de permisos de cámara, lo que facilita integrar el escaneo de códigos QR sin la molestia de gestionar permisos manualmente.

En resumen, IronQR para .NET MAUI permite a los desarrolladores implementar rápidamente las características de escaneo y generación de códigos QR en sus aplicaciones móviles, agilizando el desarrollo y mejorando la experiencia del usuario en todas las plataformas.