Umpan balik haptic

Telusuri sampel

Artikel ini menjelaskan bagaimana Anda dapat menggunakan antarmuka IHapticFeedback .NET Multi-platform App UI (.NET MAUI) untuk mengontrol umpan balik haptik pada perangkat. Umpan balik haptik umumnya dimanifestasikan oleh sensasi getaran lembut yang disediakan oleh perangkat untuk memberikan respons kepada pengguna. Beberapa contoh umpan balik haptik adalah ketika pengguna mengetik pada keyboard virtual atau ketika mereka memainkan game di mana karakter pemain memiliki pertemuan dengan karakter musuh.

Implementasi default antarmuka IHapticFeedback tersedia melalui properti HapticFeedback.Default. Antarmuka IHapticFeedback dan kelas HapticFeedback terkandung dalam namespace Microsoft.Maui.Devices.

Mulai sekarang

Untuk mengakses fungsionalitas umpan balik haptik, diperlukan penyiapan khusus platform berikut.

Android

Izin Vibrate diperlukan dan harus dikonfigurasi dalam proyek Android. Ini dapat ditambahkan dengan cara berikut:

• Tambahkan izin berbasis rakitan:

  Buka file Platforms/Android/MainApplication.cs dan tambahkan atribut assembly berikut setelah arahan using:

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

  -atau-

• Perbarui Manifes Android:

  Buka file Platforms/Android/AndroidManifest.xml dan tambahkan yang berikut ini di simpul manifest:

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

  -atau-

• Perbarui Manifes di Android menggunakan editor manifes:

  Di Visual Studio klik dua kali pada file Platforms/Android/AndroidManifest.xml untuk membuka editor manifes Android. Kemudian, di bawah Izin Diperlukan, periksa izin VIBRATE. Ini akan secara otomatis memperbarui file AndroidManifest.xml.

Tidak diperlukan penyiapan.

Windows

Tidak diperlukan penyiapan.

Menggunakan umpan balik haptik

Fungsionalitas umpan balik haptik dilaksanakan dalam dua mode: Click yang pendek atau LongPress. Contoh kode berikut memulai respons umpan balik haptik Click atau LongPress kepada pengguna berdasarkan Button yang mereka klik:

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

Penting

Pada platform Apple, fungsionalitas umpan balik haptik harus dijalankan pada utas UI.