Freigeben über

Haptisches Feedback

  • Artikel

Browse sample. Durchsuchen Sie das Beispiel

In diesem Artikel wird beschrieben, wie Sie die .NET Multi-Platform App UI (.NET MAUI) IHapticFeedback-Schnittstelle verwenden können, um haptisches Feedback auf einem Gerät zu steuern. Haptisches Feedback wird in der Regel durch ein sanftes Vibrationsgefühl manifestiert, das vom Gerät bereitgestellt wird, um dem/der Benutzer*in eine Antwort zu geben. Einige Beispiele für haptisches Feedback sind, wenn ein/eine Benutzer*in auf einer virtuellen Tastatur tippt oder wenn er ein Spiel spielt, bei dem der Charakter des Spielers eine Begegnung mit einem feindseligen Charakter hat.

Die Standardimplementierung der IHapticFeedback-Schnittstelle ist über die HapticFeedback.Default-Eigenschaft verfügbar. Die IHapticFeedback-Schnittstelle sowie die HapticFeedback-Klasse sind im Microsoft.Maui.Devices-Namespace enthalten.

Erste Schritte

Für den Zugriff auf die Funktion für haptisches Feedback ist die folgende plattformspezifische Einrichtung erforderlich.

Die Berechtigung Vibrate ist obligatorisch und muss im Android-Projekt konfiguriert werden. Das Hinzufügen erfolgt folgendermaßen:

  • Fügen Sie die assemblybasierte Berechtigung hinzu:

    Öffnen Sie die Datei Platforms/Android/MainApplication.cs, und fügen Sie die folgenden Assemblyattribute nach using-Direktiven hinzu:

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

    - oder -

  • Aktualisieren Sie das Android-Manifest:

    Öffnen Sie die Datei Platforms/Android/AndroidManifest.xml, und fügen Sie Folgendes zum Knoten manifest hinzu:

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

    - oder -

  • Aktualisieren Sie das Android-Manifest im Manifest-Editor:

    Doppelklicken Sie in Visual Studio auf die Datei Platforms/Android/AndroidManifest.xml, um den Android-Manifest-Editor zu öffnen. Überprüfen Sie dann unter Erforderliche Berechtigungen die Berechtigung VIBRATE. Dadurch wird die Datei AndroidManifest.xml automatisch aktualisiert.

Verwenden von haptischem Feedback

Die Funktion für haptisches Feedback wird in zwei Modi ausgeführt: eine kurze Click oder eine LongPress. Im folgenden Codebeispiel wird die haptische Feedbackantwort Click oder LongPress für den/die Benutzer*in initiiert, basierend darauf, auf welche Button er klickt:

private void HapticShortButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.Click);

private void HapticLongButton_Clicked(object sender, EventArgs e) =>
    HapticFeedback.Default.Perform(HapticFeedbackType.LongPress);