Udostępnij za pośrednictwem

Opinie haptyczne

  • Artykuł

Przeglądaj przykład. Przeglądaj przykład

W tym artykule opisano sposób używania interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI) IHapticFeedback do sterowania haptycznym sprzężeniem zwrotnym na urządzeniu. Opinie haptyczne są zwykle manifestowane przez delikatne uczucie drgań dostarczone przez urządzenie w celu udzielenia odpowiedzi użytkownikowi. Niektóre przykłady haptycznego sprzężenia zwrotnego to sytuacje, gdy użytkownik pisze na klawiaturze wirtualnej lub gdy gra w grę, w której postać gracza spotyka się z wrogiem.

Domyślna implementacja interfejsu IHapticFeedback jest dostępna za pośrednictwem właściwości HapticFeedback.Default. Zarówno interfejs IHapticFeedback, jak i klasa HapticFeedback znajdują się w przestrzeni nazw Microsoft.Maui.Devices.

Rozpocznij

Aby uzyskać dostęp do funkcji haptycznego sprzężenia zwrotnego, wymagana jest następująca konfiguracja specyficzna dla platformy.

Wymagane jest uprawnienie Vibrate i musi być skonfigurowane w projekcie systemu Android. Można to dodać w następujący sposób:

  • Dodaj uprawnienie oparte na zestawie:

    Otwórz plik Platforms/Android/MainApplication.cs i dodaj następujące atrybuty zestawu po using dyrektyw:

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

    - lub -

  • Zaktualizuj manifest systemu Android:

    Otwórz plik Platforms/Android/AndroidManifest.xml i dodaj następujący kod w węźle manifest:

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

    - lub -

  • Zaktualizuj manifest systemu Android w edytorze manifestu:

    W programie Visual Studio kliknij dwukrotnie plik Platforms/Android/AndroidManifest.xml, aby otworzyć edytor manifestu systemu Android. Następnie w obszarze Wymagane uprawnienia sprawdź uprawnienia VIBRATE. Spowoduje to automatyczne zaktualizowanie pliku AndroidManifest.xml.

Użycie informacji zwrotnej haptycznej

Funkcja sprzężenia zwrotnego haptycznego działa w dwóch trybach: krótki Click lub LongPress. Poniższy przykład kodu inicjuje haptyczną reakcję zwrotną Click lub LongPress dla użytkownika, w zależności od tego, który Button kliknie.

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);

Ważny

Na platformach Apple, funkcjonalność informacji zwrotnych haptycznych musi być realizowana w wątku interfejsu użytkownika.