Leer en inglés

Compartir a través de


Xamarin.Essentials: Vibración

La clase Vibration permite iniciar y detener la funcionalidad de vibración durante un período de tiempo determinado.

Primeros pasos

Para empezar a usar esta API, lea la guía de introducción para Xamarin.Essentials con el fin de asegurarse de que la biblioteca está correctamente instalada y configurada en los proyectos.

Para acceder a la funcionalidad de Vibration, se requiere la siguiente configuración específica para la plataforma.

El permiso Vibrate (Vibrar) es necesario y se debe configurar en el proyecto de Android. Se puede agregar de las siguientes maneras:

Abra el archivo AssemblyInfo.cs de la carpeta Propiedades y agregue lo siguiente:

C#
[assembly: UsesPermission(Android.Manifest.Permission.Vibrate)]

O BIEN, actualice el manifiesto de Android:

Abra el archivo AndroidManifest.xml de la carpeta Propiedades y agregue lo siguiente dentro del nodo manifest.

XML
<uses-permission android:name="android.permission.VIBRATE" />

O haga clic con el botón derecho en el proyecto de Android y abra las propiedades del proyecto. En Manifiesto de Android, busque el área Permisos requeridos: y active el permiso VIBRATE (Vibrar). Esto actualizará automáticamente el archivo AndroidManifest.xml.

Uso de Vibration

Agregue una referencia a Xamarin.Essentials en la clase:

C#
using Xamarin.Essentials;

La funcionalidad de Vibration se puede solicitar para un período de tiempo concreto o el valor predeterminado de 500 milisegundos.

C#
try
{
    // Use default vibration length
    Vibration.Vibrate();

    // Or use specified time
    var duration = TimeSpan.FromSeconds(1);
    Vibration.Vibrate(duration);
}
catch (FeatureNotSupportedException ex)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Other error has occurred.
}

Se puede solicitar la cancelación de la vibración del dispositivo con el método Cancel:

C#
try
{
    Vibration.Cancel();
}
catch (FeatureNotSupportedException ex)
{
    // Feature not supported on device
}
catch (Exception ex)
{
    // Other error has occurred.
}

Diferencias entre plataformas

No hay diferencias entre las plataformas.

API

Encuentre más vídeos de Xamarin en Channel 9 y YouTube.