Compartir vía

Comentarios hápticos

  • Artículo

Examinar ejemplo. Examinar el ejemplo

En este artículo se describe cómo puede usar la interfaz de usuario de aplicación multiplataforma de .NET (.NET MAUI) IHapticFeedback para controlar los comentarios hápticos en un dispositivo. La retroalimentación háptica generalmente se manifiesta mediante una suave sensación de vibración proporcionada por el dispositivo para dar una respuesta al usuario. Algunos ejemplos de comentarios hápticos son cuando un usuario escribe en un teclado virtual o cuando juega un juego donde el personaje del jugador tiene un encuentro con un personaje enemigo.

La implementación predeterminada de la interfaz IHapticFeedback está disponible a través de la propiedad HapticFeedback.Default. Tanto la interfaz IHapticFeedback como la clase HapticFeedback se encuentran en el espacio de nombres Microsoft.Maui.Devices.

Comenzar

Para acceder a la funcionalidad de comentarios hápticos, se requiere la siguiente configuración específica de la plataforma.

El permiso Vibrate es necesario y debe configurarse en el proyecto de Android. Esto se puede agregar de las siguientes maneras:

  • Agregue el permiso basado en el ensamblado:

    Abra el archivo Platforms/Android/MainApplication.cs y agregue los siguientes atributos de ensamblado después de las directivas using.

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

    -o-

  • Actualice el manifiesto de Android:

    Abra el archivo Platforms/Android/AndroidManifest.xml y agregue lo siguiente en el nodo manifest:

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

    -o-

  • Actualice el manifiesto de Android en el editor de manifiestos:

    En Visual Studio, haga doble clic en el archivo Platforms/Android/AndroidManifest.xml para abrir el editor de manifiestos de Android. A continuación, en Permisos necesarios comprueba el permiso VIBRATE. Esto actualizará automáticamente el archivo AndroidManifest.xml.

Uso de comentarios hápticos

La funcionalidad de retroalimentación háptica se realiza en dos modos: un Click corto o un LongPress. En el ejemplo de código siguiente se inicia una respuesta de comentario háptico Click o LongPress al usuario en función del elemento Button en el que haga clic.

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

En las plataformas de Apple, la funcionalidad de comentarios hápticos debe ejecutarse en el subproceso de la interfaz de usuario.