触感反馈最基本的用例之一是为用户互动提供反馈。时间选择器、虚拟键盘上的按键按下操作和文本选择是触感反馈良好用例的常见示例。如需详细了解何时以及如何应用触感反馈,请参阅触感反馈设计原则。
本页介绍了提供触感反馈的三种方式。
- 使用
View
(推荐)。此方法以操作为导向,支持范围最广,并且不需要VIBRATE
权限。 - 使用预定义的
VibrationEffect
。 这种方法更灵活,但需要做出一些权衡。 - 将高级合成与基元搭配使用。这种方法更新且更灵活,但需要特定设备支持。
这些方法使用在设备级别定义的基本元素,以提供量身定制的高质量反馈。
默认情况下,所有触感反馈方法均会遵循用户的轻触反馈设置。
使用 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。