Partager via


Xamarin.Essentials:Vibration

La classe Vibration vous permet de démarrer et d’arrêter la fonctionnalité de vibration pendant la durée souhaitée.

Démarrage

Pour commencer à utiliser cette API, lisez le guide de prise en main pour Xamarin.Essentials vous assurer que la bibliothèque est correctement installée et configurée dans vos projets.

Pour accéder à la fonctionnalité de vibration, la configuration suivante spécifique à la plateforme est obligatoire.

L’autorisation Vibrate est obligatoire, et doit être configurée dans le projet Android. Vous pouvez le faire de plusieurs façons, comme indiqué ci-dessous :

Ouvrez le fichier AssemblyInfo.cs sous le dossier Propriétés et ajoutez :

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

OU mettez à jour le manifeste Android :

Ouvrez le fichier AndroidManifest.xml sous le dossier Propriétés et ajoutez ce qui suit dans le nœud du manifeste.

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

Ou cliquez avec le bouton droit sur le projet Android et ouvrez les propriétés du projet. Sous Manifeste Android, recherchez la zone Autorisations nécessaires, puis cochez l’autorisation VIBRATE. Cela met automatiquement à jour le fichier AndroidManifest.xml.

Utilisation de la vibration

Ajoutez une référence à Xamarin.Essentials votre classe :

using Xamarin.Essentials;

Vous pouvez demander la fonctionnalité de vibration pour une durée définie ou pour une durée par défaut de 500 millisecondes.

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

Vous pouvez demander l’annulation de la vibration de l’appareil avec la méthode Cancel :

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

Différences entre les plateformes

Aucune différence entre les plateformes.

API

Retrouvez d’autres vidéos Xamarin sur Channel 9 et YouTube.