Feedback aptico

Sfoglia l'esempio Esplora l'esempio

Questo articolo descrive come usare l'interfaccia utente multipiattaforma .NET (.NET MAUI) IHapticFeedback per controllare il feedback aptico su un dispositivo. Il feedback aptico è in genere manifestato da una delicata sensazione di vibrazione fornita dal dispositivo per dare una risposta all'utente. Alcuni esempi di feedback aptico sono quando un utente digita una tastiera virtuale o quando gioca a un gioco in cui il personaggio del giocatore ha un incontro con un personaggio nemico.

L'implementazione predefinita dell'interfaccia IHapticFeedback è disponibile tramite la proprietà HapticFeedback.Default. Sia l'interfaccia IHapticFeedback che la classe HapticFeedback sono contenute nello spazio dei nomi Microsoft.Maui.Devices.

Inizia

Per accedere alla funzionalità di feedback aptico, è necessaria la configurazione specifica della piattaforma seguente.

L'autorizzazione Vibrate è obbligatoria e deve essere configurata nel progetto Android. Questa operazione può essere aggiunta nei modi seguenti:

• Aggiungere l'autorizzazione basata su assembly:

  Aprire il file Platforms/Android/MainApplication.cs e aggiungere gli attributi di assembly seguenti dopo le direttive using:

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

  -o-

• Aggiornare il manifesto Android:

  Aprire il file Platforms/Android/AndroidManifest.xml e aggiungere quanto segue nel nodo manifest:

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

  - o -

• Aggiornare il manifesto Android nell'editor del manifesto:

  In Visual Studio fare doppio clic sul file Platforms/Android/AndroidManifest.xml per aprire l'editor del manifesto Android. Quindi, in Autorizzazioni necessarie, controllare l'autorizzazione VIBRATE. Verrà aggiornato automaticamente il file AndroidManifest.xml.

iOS/Mac Catalyst

Non è necessaria alcuna configurazione.

Windows

Non è necessaria alcuna configurazione.

Usare il feedback aptico

La funzionalità di feedback aptico viene eseguita in due modalità: una modalità breve Click o una modalità LongPress. Nell'esempio di codice seguente viene avviata una risposta di feedback aptico Click o LongPress all'utente in base al Button che clicca:

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

Importante

Nelle piattaforme Apple è necessario eseguire funzionalità di feedback aptico nel thread dell'interfaccia utente.