为事件添加触感反馈

触感反馈最基本的用例之一是为用户互动提供反馈。时间选择器、虚拟键盘上的按键按下操作和文本选择是触感反馈良好用例的常见示例。如需详细了解何时以及如何应用触感反馈，请参阅触感反馈设计原则。

本页介绍了提供触感反馈的三种方式。

这些方法使用在设备级别定义的基本元素，以提供量身定制的高质量反馈。

默认情况下，所有触感反馈方法均会遵循用户的轻触反馈设置。

使用 View 组件生成触感反馈

使用 View.performHapticFeedback 方法生成触感反馈。HapticFeedbackConstants 定义的触感反馈常量侧重于其在应用中的功能，而不是执行的触感反馈类型。

底层实现可能会因设备和硬件功能而异，但应用只需考虑在特定情境中提供的反馈类型。通过专注于功能，您可以为类似互动启用触感反馈。用户会随着时间的推移，学会将不同的触感与不同的含义相关联。

前提条件：启用触感反馈

只要 View 可见，其事件便可使用触感反馈。某些事件（例如长按）具有默认的触感反馈，如果视图上的监听器处理该事件（返回 true），系统就会触发该触感反馈。

Android View 可以通过将 View.hapticFeedbackEnabled 属性设为 false 来停用触感反馈。停用此属性会导致系统提供默认反馈。

performHapticFeedback 方法还会遵循系统设置 HAPTIC_FEEDBACK_ENABLED，这让用户可以为整个系统停用这些设置。

与其他触感反馈 API 不同，将 HapticFeedbackConstants 与 View 搭配使用不需要 VIBRATE 权限。

选择一个 HapticFeedbackConstant

将 View 组件与 HapticFeedbackConstants 搭配使用时，无需评估特定设备支持情况，因为这些常量会在必要时采用回退行为。唯一需要考虑的是所需常量的 SDK 级别。

示例 1：按键操作

以下示例展示了如何使用触摸监听器在 View 中为轻触输入添加触感反馈。这些效果可模拟按下按钮并松开按钮的感觉。

Kotlin

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

Java

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

示例 2：提交按钮

触感反馈用例不仅仅是模拟与设备的物理互动。它们还可以用于传达抽象含义。例如，对于 CONFIRM 效果，一般预期是短而轻的振动，而 REJECT 可能是一种更强烈的反馈，用于指示失败。如以下提交按钮反馈示例所示。

Kotlin

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

Java

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

使用预定义的 VibrationEffect 生成触感反馈

使用基于 View 的方法可专注于用户互动。为了确保整个系统的一致性，建议使用此方法。不过，您也可以调用特定的预定义 VibrationEffect API 来实现自定义触感反馈效果。

预定义效果可用作 VibrationEffect 常量，您可以使用 Vibrator 服务检查是否受支持以及播放效果，如以下示例所示。

了解 VibrationEffect API 的设备支持

在基本用法中，您无需检查是否支持各个 VibrationEffect API。Vibrator.areEffectsSupported 和 Vibrator.areAllEffectsSupported 等 API 用于确定设备是否具有常量的自定义实现。如果不存在自定义特效，您的应用仍可以播放特效并使用平台定义的后备实现。

如需了解详情，请参阅预定义的 VibrationEffect。

前提条件：加载振动器和 VIBRATE 权限

大多数振动都可以使用 Vibrator 服务播放，该服务可按如下方式加载：

Kotlin

import android.os.Vibrator

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

Java

import android.os.Vibrator;

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

应用需要具有 VIBRATE 权限，才能使用此服务让设备振动。您可以将此权限添加到应用清单文件中：

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

播放预定义的 VibrationEffect

您可以使用 VibrationEffect.createPredefined 准备预定义的效果，然后使用 Vibrator 上的某种 vibrate 方法播放这些效果。

此示例会播放点击效果。

Kotlin

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

Java

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

将高级组合与基元搭配使用

VibrationEffect.Composition API 提供了更多触感反馈可能性。不过，与效果不同，这些基元没有系统级回退，这意味着需要仔细注意基元和设备支持的其他功能。

创建自定义触感反馈中详细介绍了如何使用这些 API。