Xamarin.Essentials: VibrationXamarin.Essentials: Vibration

Mit der Klasse Vibration können Sie die Vibrationsfunktion für eine gewünschte Zeitspanne starten und anhalten.The Vibration class lets you start and stop the vibrate functionality for a desired amount of time.

Erste SchritteGet started

Lesen Sie zum Einstieg in diese API das Handbuch Erste Schritte mit Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.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.

Für den Zugriff auf die Vibrationsfunktion ist die folgende plattformspezifische Einrichtung erforderlich.To access the Vibration functionality the following platform specific setup is required.

Die Berechtigung „Vibrate“ (Vibrieren) ist obligatorisch und muss im Android-Projekt konfiguriert werden.The Vibrate permission is required and must be configured in the Android project. Das Hinzufügen erfolgt folgendermaßen:This can be added in the following ways:

Öffnen Sie die Datei AssemblyInfo.cs im Ordner Eigenschaften und fügen Sie Folgendes hinzu:Open the AssemblyInfo.cs file under the Properties folder and add:

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

Alternativ können Sie das Android-Manifest aktualisieren:OR Update Android Manifest:

Öffnen Sie die Datei AndroidManifest.xml im Ordner Eigenschaften, und fügen Sie Folgendes im Knoten Manifest hinzu.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" />

Alternativ können Sie mit der rechten Maustaste auf das Android-Projekt klicken und die Eigenschaften des Projekts öffnen.Or right click on the Android project and open the project's properties. Suchen Sie unter Android-Manifest den Bereich Erforderliche Berechtigungen: , und aktivieren Sie die Berechtigung VIBRATE (Vibrieren).Under Android Manifest find the Required permissions: area and check the VIBRATE permission. Dadurch wird die Datei AndroidManifest.xml automatisch aktualisiert.This will automatically update the AndroidManifest.xml file.

Verwenden der VibrationsfunktionUsing Vibration

Fügen Sie Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

Die Vibrationsfunktion kann für eine bestimmte Zeitspanne oder den Standardzeitraum von 500 Millisekunden angefordert werden.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.
}

Der Abbruch der Gerätevibration kann mit der Methode Cancel angefordert werden: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.
}

PlattformunterschiedePlatform Differences

Keine Plattformunterschiede.No platform differences.

APIAPI