Xamarin.Essentials: VibrationXamarin.Essentials: Vibration

La classe Vibration vous permet de démarrer et d’arrêter la fonctionnalité de vibration pendant la durée souhaitée.The Vibration class lets you start and stop the vibrate functionality for a desired amount of time.

Prise en mainGet started

Pour commencer à utiliser cette API, lisez le Guide de prise en main de Xamarin.Essentials pour vérifier que la bibliothèque est correctement installée et configurée dans vos projets.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Pour accéder à la fonctionnalité de vibration, la configuration suivante spécifique à la plateforme est obligatoire.To access the Vibration functionality the following platform specific setup is required.

L’autorisation Vibrate est obligatoire, et doit être configurée dans le projet Android.The Vibrate permission is required and must be configured in the Android project. Vous pouvez l’ajouter des façons suivantes :This can be added in the following ways:

Ouvrez le fichier AssemblyInfo.cs sous le dossier Propriétés et ajoutez :Open the AssemblyInfo.cs file under the Properties folder and add:

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

OU mettez à jour le manifeste Android :OR Update Android Manifest:

Ouvrez le fichier AndroidManifest.xml sous le dossier Propriétés et ajoutez ce qui suit dans le nœud du manifeste.Open the AndroidManifest.xml file under the Properties folder and add the following inside of the manifest node.

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

Vous pouvez également cliquer avec le bouton droit sur le projet Android, et ouvrir les propriétés du projet.Or right click on the Android project and open the project's properties. Sous Manifeste Android, recherchez la zone Autorisations nécessaires, puis cochez l’autorisation VIBRATE.Under Android Manifest find the Required permissions: area and check the VIBRATE permission. Cela entraîne la mise à jour automatique du fichier AndroidManifest.xml.This will automatically update the AndroidManifest.xml file.

Utilisation de la vibrationUsing Vibration

Ajoutez une référence à Xamarin.Essentials dans votre classe :Add a reference to Xamarin.Essentials in your class:

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.The Vibration functionality can be requested for a set amount of time or the default of 500 milliseconds.

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 :Cancellation of device vibration can be requested with the Cancel method:

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

Différences entre les plateformesPlatform Differences

Aucune différence entre les plateformes.No platform differences.

APIAPI