Feedback háptico

  • Artigo

Browse sample. Navegue pelo exemplo

Este artigo descreve como você pode usar a interface .NET Multi-platform App UI (.NET MAUI) IHapticFeedback para controlar comentários hápticos em um dispositivo. O feedback háptico é geralmente manifestado por uma sensação de vibração suave fornecida pelo dispositivo para dar uma resposta ao usuário. Alguns exemplos de feedback háptico são quando um usuário digita em um teclado virtual ou quando joga um jogo onde o personagem do jogador tem um encontro com um personagem inimigo.

A implementação padrão da interface está disponível por meio da IHapticFeedbackHapticFeedback.Default propriedade. A interface e HapticFeedback a IHapticFeedback classe estão contidas no Microsoft.Maui.Devices namespace.

Introdução

Para acessar a funcionalidade de feedback háptico, a seguinte configuração específica da plataforma é necessária.

A permissão Vibrate é necessária e deve ser configurada no projeto do Android. Isso pode ser usado das seguintes maneiras:

  • Adicione a permissão baseada em assembly:

    Abra o arquivo Platforms/Android/MainApplication.cs e adicione os seguintes atributos de assembly após using as diretivas:

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

    - ou -

  • Atualize o manifesto do Android:

    Abra o arquivo Platforms/Android/AndroidManifest.xml e adicione o manifest seguinte no nó:

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

    - ou -

  • Atualize o manifesto do Android no editor de manifesto:

    No Visual Studio, clique duas vezes no arquivo Platforms/Android/AndroidManifest.xml para abrir o editor de manifesto do Android. Em seguida, em Permissões necessárias, verifique a permissão VIBRATE . Isso atualizará automaticamente o arquivo AndroidManifest.xml.

Use feedback háptico

A funcionalidade de feedback háptico é realizada em dois modos: um curto Click ou um LongPressarquivo . O exemplo de código a seguir inicia uma Click resposta de feedback háptico ou LongPress háptico para o usuário com base no qual Button ele clica:

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