Cómo agregar respuestas táctiles a eventos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Uno de los casos de uso más básicos de la tecnología táctil es proporcionar comentarios a las interacciones del usuario. Los selectores de hora, la presión de teclas en un teclado virtual y la selección de texto son ejemplos comunes de buenos casos de uso para la respuesta táctil. Para obtener más información sobre cuándo y cómo aplicar la tecnología táctil, lee Principios del diseño táctil.

En esta página, se describen tres formas de proporcionar comentarios táctiles.

• Usa un View (recomendado). Este enfoque está orientado a la acción, tiene la compatibilidad más amplia y no requiere el permiso VIBRATE.
• Usa un VibrationEffect predefinido. Este enfoque tiene más flexibilidad, pero con algunas compensaciones.
• Usa composiciones avanzadas con primitivas. Este método es más nuevo y aún más flexible, pero requiere compatibilidad con dispositivos específicos.

Estos métodos usan primitivas definidas a nivel del dispositivo para proporcionar comentarios de alta calidad adaptados al dispositivo en cuestión.

Todos los métodos de respuesta táctil respetan la configuración de respuesta táctil del usuario de forma predeterminada.

Usa componentes View para generar respuestas táctiles

Usa el método View.performHapticFeedback para generar comentarios táctiles. Las constantes táctiles definidas por HapticFeedbackConstants se enfocan en su funcionalidad en una aplicación, no en el tipo de efecto táctil que se realiza.

La implementación subyacente puede variar según las capacidades del dispositivo y el hardware, pero la app solo debe considerar el tipo de comentarios que se proporcionarán en un contexto determinado. Si te enfocas en la funcionalidad, puedes habilitar la respuesta táctil para interacciones similares. Con el tiempo, los usuarios aprenden a asociar diferentes significados a diferentes sensaciones táctiles.

Requisitos previos: Habilita la respuesta táctil

Siempre que el View esté visible, se pueden usar las respuestas táctiles para sus eventos. Algunos eventos, como la presión prolongada, tienen una respuesta táctil predeterminada que se activa si un objeto de escucha en la vista controla el evento (muestra true).

Un View de Android puede inhabilitar la respuesta táctil configurando la propiedad View.hapticFeedbackEnabled en false. Si inhabilitas esta propiedad, se mostrarán comentarios predeterminados.

El método performHapticFeedback también respeta la configuración del sistema HAPTIC_FEEDBACK_ENABLED, lo que permite que el usuario los inhabilite para todo el sistema.

A diferencia de otras APIs táctiles, usar HapticFeedbackConstants con un View no requiere el permiso VIBRATE.

Elige un HapticFeedbackConstant

Cuando usas componentes View con HapticFeedbackConstants, no es necesario evaluar la compatibilidad con dispositivos específicos, ya que estas constantes tendrán un comportamiento de resguardo si es necesario. La única consideración es el nivel de SDK de la constante deseada.

Ejemplo 1: Presionar una tecla

Este es un ejemplo de cómo agregar una respuesta táctil a una entrada táctil en View con objetos de escucha táctiles. Los efectos simulan la sensación de presionar un botón y, luego, soltarlo.

class HapticTouchListener : View.OnTouchListener {
  override fun onTouch(View view, MotionEvent event) : Boolean {
    when (event.actionMasked) {
      MotionEvent.ACTION_DOWN ->
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY)
      MotionEvent.ACTION_UP ->
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY_RELEASE)
    }
    return true
  }
}

class HapticTouchListener implements View.OnTouchListener {
  @Override
  public boolean onTouch(View view, MotionEvent event) {
    switch (event.getAction()) {
      case MotionEvent.ACTION_DOWN:
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
        break;
      case MotionEvent.ACTION_UP:
        view.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY_RELEASE);
        break;
    }
    return true;
  }
}

Ejemplo 2: Botón Enviar

Los casos de uso de la respuesta táctil van más allá de simular una interacción física con el dispositivo. También se pueden usar para transmitir un significado abstracto. Por ejemplo, la expectativa general para un efecto CONFIRM es una pulsación breve y ligera, mientras que un efecto REJECT podría ser una pulsación más fuerte para indicar una falla. Esto se ilustra en el siguiente ejemplo de comentarios sobre un botón de envío.

submitButton.setOnClickListener { view ->
  val successful = performSubmit()
  if (successful) {
    view.performHapticFeedback(HapticFeedbackConstants.CONFIRM)
  } else {
    view.performHapticFeedback(HapticFeedbackConstants.REJECT)
  }
}

submitButton.setOnClickListener(view -> {
  boolean successful = performSubmit();
  if (successful) {
    view.performHapticFeedback(HapticFeedbackConstants.CONFIRM);
  } else {
    view.performHapticFeedback(HapticFeedbackConstants.REJECT);
  }
});

Usa un VibrationEffect predefinido para generar comentarios táctiles

El uso del enfoque basado en View se enfoca en la interacción del usuario. Se prefiere por la coherencia en todo el sistema. Sin embargo, también se pueden invocar APIs específicas predefinidas de VibrationEffect para obtener efectos de respuesta táctil personalizados.

Los efectos predefinidos están disponibles como constantes VibrationEffect y se pueden verificar para verificar la compatibilidad y reproducir con el servicio Vibrator, como se muestra en los siguientes ejemplos.

Información sobre la compatibilidad de dispositivos con las APIs de VibrationEffect

En el uso básico, no debería ser necesario verificar la compatibilidad con APIs individuales de VibrationEffect. Las APIs, como Vibrator.areEffectsSupported y Vibrator.areAllEffectsSupported, se usan para determinar si el dispositivo tiene una implementación personalizada de la constante. Si no hay un efecto personalizado, tu app puede seguir reproduciendo los efectos y usar una implementación de resguardo definida por la plataforma.

Para obtener más información, consulta VibrationEffect predefinidas.

Requisitos previos: Carga el vibrador y el permiso VIBRATE

La mayoría de las vibraciones se pueden reproducir con el servicio Vibrator, que se puede cargar de la siguiente manera:

import android.os.Vibrator

val vibrator = context.getSystemService(Vibrator::class.java)

import android.os.Vibrator;

Vibrator vibrator = context.getSystemService(Vibrator.class);

La app debe tener el permiso VIBRATE para hacer vibrar el dispositivo con este servicio. El permiso se puede agregar al archivo de manifiesto de la aplicación:

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

Reproducir un VibrationEffect predefinido

Los efectos predefinidos se pueden preparar con VibrationEffect.createPredefined y, luego, reproducir con uno de los métodos vibrate en Vibrator.

En este ejemplo, se reproduce un efecto de clic.

val vibrator = context.getSystemService(Vibrator::class.java)
...
// Requires VIBRATE permission
vibrator.vibrate(VibrationEffect.createPredefined(VibrationEffect.EFFECT_CLICK))

Vibrator vibrator = context.getSystemService(Vibrator.class);
...
// Requires VIBRATE permission
vibrator.vibrate(VibrationEffect.createPredefined(VibrationEffect.EFFECT_CLICK));

Usa composiciones avanzadas con primitivas

La API de VibrationEffect.Composition ofrece posibilidades adicionales para la respuesta táctil. Sin embargo, a diferencia de los efectos, estas primitivas no tienen resguardos a nivel del sistema, lo que significa que se debe prestar especial atención a las primitivas y a otras funciones que admite el dispositivo.

El uso de estas APIs se analiza con más detalle en Cómo crear efectos táctiles personalizados.