Compartilhar via

Comentários hápticos

procurar exemplo. Procurar o exemplo

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

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

Começar

Para acessar a funcionalidade de comentários hápticos, a configuração específica da plataforma a seguir é necessária.

A permissão Vibrate é necessária e deve ser configurada no projeto android. Isso pode ser adicionado 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 as diretivas using.

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

    -ou-

  • Atualize o manifesto do Android:

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

    <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.

Usar retorno háptico

A funcionalidade de feedback tátil é realizada em dois modos: um curto Click ou um LongPress. O exemplo de código a seguir inicia uma resposta de feedback háptico Click ou LongPress ao usuário, dependendo de 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);

Importante

Nas plataformas Apple, a funcionalidade de comentários hápticos deve ser executada no thread da interface do usuário.