Con el aumento de aplicaciones móviles que aprovechan los códigos QR para una recuperación rápida de información, la necesidad de un escáner de códigos QR eficiente y fácil de integrar, así como un escáner de códigos de barras .NET MAUI para escanear códigos de barras, está en crecimiento. .NET MAUI (Interfaz de usuario de aplicaciones multiplataforma), el marco de trabajo multiplataforma de Microsoft, proporciona un entorno unificado para desarrollar aplicaciones en iOS, Android, macOS y Windows. Al escanear códigos QR en una aplicación .NET MAUI, los desarrolladores necesitan una biblioteca intuitiva y potente para gestionar el proceso.

IronQR es una biblioteca popular que permite a los desarrolladores generar y decodificar códigos QR de manera rápida, precisa y confiable. Este artículo te guiará en la integración de IronQR con .NET MAUI para construir un escáner de códigos QR y de barras que pueda funcionar sin problemas en múltiples plataformas.

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 a la perfección en las plataformas iOS, Android, macOS y Windows dentro de las aplicaciones MAUI.
• Escaneo de códigos QR: Decodifica de forma eficiente diversos 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: permite generar fácilmente códigos QR a partir de datos como URL, textos y mucho más.
• Gestión de permisos de cámara: gestiona automáticamente las solicitudes de permisos de cámara, simplificando el proceso de escaneo.
• Alto rendimiento: escaneo y generación de códigos QR rápidos y fiables con un uso mínimo de recursos.
• Ajustes personalizables: Ofrece opciones de personalización para los parámetros de escaneo y el aspecto del código QR.
• Fácil integración: API sencilla y configuración mínima necesaria para añadir la lectura y generación de códigos QR a tu aplicación .NET MAUI.
• Gestión de errores: Proporciona mensajes de error detallados y soluciones 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 BarCodes 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.

Prerrequisitos

Antes de proceder con la implementación, asegúrese de tener los siguientes prerrequisitos:

1. Visual Studio 2022 o posterior instalado.
2. .NET 6.0 SDK o posterior (ya que .NET MAUI está construido sobre .NET 6 y versiones posteriores).
3. Paquete NuGet IronQR para escaneo de códigos QR y detección de códigos de barras.
4. Aplicación .NET MAUI (Puede crear una nueva aplicación MAUI en Visual Studio si aún no tiene una).

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.

Androide

En el archivo AndroidManifest.xml, añade el permiso para la cámara:

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

iOS

En el archivo Info.plist, añade la descripción del uso de la cámara:

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

Edita 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ás los permisos de la cámara y la lógica de 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;
        }
        }
    }
}

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

Explicación del código

• Permisos: Solicitamos permisos de cámara utilizando Permissions.RequestAsync<Permissions.Camera>(). Si se deniega el permiso, se muestra una alerta al usuario.
• IronQR Scanner: Utiliza los objetos y métodos de la biblioteca IronQR para escanear códigos QR. El método QrReader.Read() intenta decodificar los códigos QR, y el resultado se muestra en la etiqueta.

Introducir código QR

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

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