Xamarin.Essentials: El Magnetómetro - Xamarin Forms

En este artículo, profundizaremos en la implementación del Magnetómetro en aplicaciones Xamarin Forms utilizando Xamarin.Essentials. El magnetómetro es el sensor encargado de medir el campo magnético en los ejes X, Y y Z del dispositivo, siendo clave para aplicaciones de brújula y otras que requieren orientación precisa del dispositivo.

Nos centraremos exclusivamente en Android, y proporcionaremos ejemplos de código bien comentados, explicando en detalle cómo utilizar el magnetómetro en tus proyectos Xamarin. También veremos qué móviles soportan este sensor y cómo configurar Xamarin.Essentials para su uso.

 

Introducción al Magnetómetro

El Magnetómetro es un sensor que mide el campo magnético en torno al dispositivo. Su principal uso es en aplicaciones de brújula, donde se necesita determinar la dirección en la que apunta el teléfono. El magnetómetro mide los campos magnéticos en tres dimensiones (ejes X, Y y Z), permitiendo detectar la orientación del dispositivo con respecto al campo magnético terrestre. Es un sensor común en la mayoría de los smartphones modernos, aunque algunos dispositivos económicos o antiguos podrían no incluirlo.

 

Requisitos previos

Para implementar el Magnetómetro en una aplicación Xamarin Forms, necesitas tener lo siguiente:

• Visual Studio con soporte para Xamarin.
• Proyecto Xamarin Forms configurado.
• Xamarin.Essentials instalado.

 

Móviles que soportan el Magnetómetro

La mayoría de los smartphones actuales de gama media y alta, tanto en plataformas Android como iOS, incluyen un magnetómetro. Esto incluye dispositivos de marcas como:

• Samsung (Serie Galaxy S, Note, A, y algunos de la serie M)
• Google Pixel (todos los modelos)
• OnePlus (todos los modelos)
• Xiaomi, Oppo, Vivo (algunos modelos de gama media-alta)

Sin embargo, hay dispositivos de gama baja que pueden no incluir este sensor. Los emuladores de Android generalmente no lo simulan, por lo que es importante probar en un dispositivo físico.

 

Configuración del Proyecto en Visual Studio

Crear un nuevo proyecto de Xamarin Forms

1. Abre Visual Studio y selecciona Nuevo Proyecto.
2. Elige Aplicación en blanco (Xamarin.Forms).
3. Configura tu proyecto para Android y iOS (aunque este artículo se enfoca en Android).

Instalar Xamarin.Essentials

1. Haz clic derecho en el proyecto compartido y selecciona Administrar Paquetes NuGet.
2. Busca Xamarin.Essentials y añádelo a todos los proyectos (Android, iOS y el proyecto compartido).

 

Configuración de Xamarin.Essentials

En Android, no se requiere ningún permiso específico para acceder al magnetómetro, ya que no implica la recopilación de información sensible del usuario. Sin embargo, debemos inicializar Xamarin.Essentials correctamente en el archivo MainActivity.cs.

using Android.App;
using Android.Content.PM;
using Android.OS;
using Xamarin.Essentials;
using Xamarin.Forms;

namespace SensorApp.Droid
{
    [Activity(Label = "SensorApp", Icon = "@mipmap/icon", Theme = "@style/MainTheme", MainLauncher = true, ConfigurationChanges = ConfigChanges.ScreenSize | ConfigChanges.Orientation)]
    public class MainActivity : global::Xamarin.Forms.Platform.Android.FormsAppCompatActivity
    {
        protected override void OnCreate(Bundle savedInstanceState)
        {
            base.OnCreate(savedInstanceState);

            Xamarin.Essentials.Platform.Init(this, savedInstanceState); // Inicializar Xamarin.Essentials
            global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
            LoadApplication(new App());
        }

        // Manejar los permisos de Xamarin.Essentials
        public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Permission[] grantResults)
        {
            Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);

            base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
        }
    }
}

 

Implementación del Magnetómetro

Ahora que hemos configurado nuestro proyecto y añadido Xamarin.Essentials, podemos implementar el Magnetómetro. Este sensor nos proporcionará los valores del campo magnético en los tres ejes X, Y y Z.

Crear la interfaz de usuario en XAML

Añadiremos una nueva página MagnetometerPage.xaml para mostrar los datos en tiempo real.

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="SensorApp.MagnetometerPage"
             Title="Magnetómetro">
    <StackLayout Padding="20">
        <Label Text="Datos del Magnetómetro" FontSize="Large" />
        <Label x:Name="magneticXLabel" Text="Campo Magnético X: " />
        <Label x:Name="magneticYLabel" Text="Campo Magnético Y: " />
        <Label x:Name="magneticZLabel" Text="Campo Magnético Z: " />
        <Button Text="Iniciar Magnetómetro" Clicked="OnStartMagnetometerClicked" />
        <Button Text="Detener Magnetómetro" Clicked="OnStopMagnetometerClicked" />
    </StackLayout>
</ContentPage>

Código C# para el Magnetómetro

El siguiente código activará y desactivará el Magnetómetro, actualizando las etiquetas en la interfaz de usuario con los valores en tiempo real.

using Xamarin.Essentials;
using Xamarin.Forms;

namespace SensorApp
{
    public partial class MagnetometerPage : ContentPage
    {
        public MagnetometerPage()
        {
            InitializeComponent();
        }

        // Evento que se dispara al hacer clic en "Iniciar Magnetómetro"
        private void OnStartMagnetometerClicked(object sender, EventArgs e)
        {
            if (!Magnetometer.IsMonitoring)
            {
                Magnetometer.ReadingChanged += OnMagnetometerReadingChanged;
                Magnetometer.Start(SensorSpeed.UI);
            }
        }

        // Evento que se dispara al hacer clic en "Detener Magnetómetro"
        private void OnStopMagnetometerClicked(object sender, EventArgs e)
        {
            if (Magnetometer.IsMonitoring)
            {
                Magnetometer.ReadingChanged -= OnMagnetometerReadingChanged;
                Magnetometer.Stop();
            }
        }

        // Método que se ejecuta cada vez que se actualizan los datos del Magnetómetro
        void OnMagnetometerReadingChanged(object sender, MagnetometerChangedEventArgs e)
        {
            var data = e.Reading;
            magneticXLabel.Text = $"Campo Magnético X: {data.MagneticField.X}";
            magneticYLabel.Text = $"Campo Magnético Y: {data.MagneticField.Y}";
            magneticZLabel.Text = $"Campo Magnético Z: {data.MagneticField.Z}";
        }
    }
}

• Magnetometer.Start(SensorSpeed.UI): Inicia el sensor del Magnetómetro. El parámetro SensorSpeed.UI indica que queremos actualizaciones suficientemente rápidas para la interfaz de usuario.
• Magnetometer.ReadingChanged: Evento que se dispara cada vez que se actualiza la lectura del campo magnético. Recibe una instancia de MagnetometerData, la cual contiene los valores en los tres ejes X, Y y Z.
• Magnetometer.Stop(): Detiene el sensor cuando ya no necesitamos monitorear los cambios.

 

Manejo de errores y consideraciones

Algunos dispositivos podrían no contar con un magnetómetro. Para evitar errores, siempre es recomendable manejar estas excepciones.

try
{
    // Iniciar el magnetómetro
    Magnetometer.Start(SensorSpeed.UI);
}
catch (FeatureNotSupportedException fnsEx)
{
    // El dispositivo no tiene magnetómetro
    await DisplayAlert("Error", "El dispositivo no tiene un Magnetómetro.", "OK");
}
catch (Exception ex)
{
    // Otro error
    await DisplayAlert("Error", $"Se produjo un error: {ex.Message}", "OK");
}

 

Pruebas en dispositivos Android

Configurar el dispositivo

Asegúrate de conectar un dispositivo Android físico que tenga el magnetómetro habilitado. Los emuladores generalmente no soportan este sensor.

Iniciar la depuración

• Inicia la depuración de la aplicación desde Visual Studio en el dispositivo físico.
• Verifica que los valores del campo magnético se actualicen correctamente al mover el dispositivo.

 

Posibles extensiones

El magnetómetro puede usarse en diversas aplicaciones útiles. Algunas ideas para extender esta funcionalidad incluyen:

• Aplicación de brújula: Usa los datos del magnetómetro para construir una brújula funcional.
• Medición de campos magnéticos: Implementar una app que detecte variaciones en el campo magnético (útil para trabajos de geología o detección de metales).
• Orientación de dispositivos: Combinar los datos del magnetómetro con otros sensores como el acelerómetro para determinar la orientación precisa del dispositivo.