Freigeben über

Haptisches Feedback

Beispiel durchsuchen. Beispiel durchsuchen

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 Benutzer eine Antwort zu geben. Einige Beispiele für haptisches Feedback sind, wenn ein Benutzer auf einer virtuellen Tastatur tippt oder wenn er ein Spiel spielt, bei dem der Charakter des Spielers auf einen feindlichen Charakter trifft.

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

Loslegen

Um auf die haptische Feedbackfunktion zuzugreifen, ist das folgende plattformspezifische Setup erforderlich.

Die Vibrate Berechtigung ist erforderlich und muss im Android-Projekt konfiguriert werden. Dies kann auf folgende Weise hinzugefügt werden:

  • Fügen Sie die assemblybasierte Berechtigung hinzu:

    Öffnen Sie die Datei Platforms/Android/MainApplication.cs und fügen Sie nach using Direktiven die folgenden Assemblyattribute 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 im 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 VIBRIEREN. Dadurch wird die AndroidManifest.xml Datei automatisch aktualisiert.

Haptisches Feedback verwenden

Die haptische Feedback-Funktion wird in zwei Modi ausgeführt: eine kurze Click oder eine LongPress. Im folgenden Codebeispiel wird eine Click- oder LongPress haptische Feedbackantwort für den Benutzer 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);

Wichtig

Auf Apple-Plattformen muss die haptische Feedbackfunktion im UI-Thread ausgeführt werden.