本课程介绍了如何在触摸事件中跟踪移动。
每当当前触摸接触位置、压力或大小发生变化时，都会触发一个新的 onTouchEvent()，并带有 ACTION_MOVE 事件。如 检测常见手势 中所述，所有这些事件都记录在 MotionEvent 的 onTouchEvent() 参数中。
由于基于手指的触摸并非总是最精确的交互形式，因此触摸事件的检测通常更基于移动而不是简单的接触。为了帮助应用区分基于移动的手势（例如滑动）和非移动手势（例如单点触控），Android 包含了“触摸容差”的概念。触摸容差指的是用户触摸在被解释为基于移动的手势之前可以游移的像素距离。有关此主题的更多信息，请参阅 在 ViewGroup 中管理触摸事件。
有几种方法可以跟踪手势中的移动，具体取决于应用的需求。以下是示例
- 指针的起始和结束位置，例如将屏幕上的对象从 A 点移动到 B 点。
- 指针移动的方向，由 X 和 Y 坐标确定。
- 历史记录。您可以通过调用
MotionEvent方法getHistorySize()来查找手势历史记录的大小。然后，您可以使用运动事件的getHistorical<Value>方法获取每个历史事件的位置、大小、时间和压力。当渲染用户手指的轨迹（例如触摸绘图）时，历史记录非常有用。有关详细信息，请参阅MotionEvent参考。 - 指针在触摸屏上移动的速度。
请参阅以下相关资源
跟踪速度
您可以有一个基于指针移动距离或方向的基于移动的手势。但是，速度通常是跟踪手势特征或确定手势是否发生的决定性因素。为了简化速度计算，Android 提供了 VelocityTracker 类。VelocityTracker 帮助您跟踪触摸事件的速度。这对于速度是手势标准一部分的手势（例如抛掷）很有用。
这是一个说明 VelocityTracker API 中方法用途的示例
Kotlin
private const val DEBUG_TAG = "Velocity"
class MainActivity : Activity() {
private var mVelocityTracker: VelocityTracker? = null
override fun onTouchEvent(event: MotionEvent): Boolean {
when (event.actionMasked) {
MotionEvent.ACTION_DOWN -> {
// Reset the velocity tracker back to its initial state.
mVelocityTracker?.clear()
// If necessary, retrieve a new VelocityTracker object to watch
// the velocity of a motion.
mVelocityTracker = mVelocityTracker ?: VelocityTracker.obtain()
// Add a user's movement to the tracker.
mVelocityTracker?.addMovement(event)
}
MotionEvent.ACTION_MOVE -> {
mVelocityTracker?.apply {
val pointerId: Int = event.getPointerId(event.actionIndex)
addMovement(event)
// When you want to determine the velocity, call
// computeCurrentVelocity(). Then, call getXVelocity() and
// getYVelocity() to retrieve the velocity for each pointer
// ID.
computeCurrentVelocity(1000)
// Log velocity of pixels per second. It's best practice to
// use VelocityTrackerCompat where possible.
Log.d("", "X velocity: ${getXVelocity(pointerId)}")
Log.d("", "Y velocity: ${getYVelocity(pointerId)}")
}
}
MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
// Return a VelocityTracker object back to be re-used by others.
mVelocityTracker?.recycle()
mVelocityTracker = null
}
}
return true
}
}
Java
public class MainActivity extends Activity {
private static final String DEBUG_TAG = "Velocity";
...
private VelocityTracker mVelocityTracker = null;
@Override
public boolean onTouchEvent(MotionEvent event) {
int index = event.getActionIndex();
int action = event.getActionMasked();
int pointerId = event.getPointerId(index);
switch(action) {
case MotionEvent.ACTION_DOWN:
if(mVelocityTracker == null) {
// Retrieve a new VelocityTracker object to watch the
// velocity of a motion.
mVelocityTracker = VelocityTracker.obtain();
}
else {
// Reset the velocity tracker back to its initial state.
mVelocityTracker.clear();
}
// Add a user's movement to the tracker.
mVelocityTracker.addMovement(event);
break;
case MotionEvent.ACTION_MOVE:
mVelocityTracker.addMovement(event);
// When you want to determine the velocity, call
// computeCurrentVelocity(). Then call getXVelocity() and
// getYVelocity() to retrieve the velocity for each pointer ID.
mVelocityTracker.computeCurrentVelocity(1000);
// Log velocity of pixels per second. It's best practice to use
// VelocityTrackerCompat where possible.
Log.d("", "X velocity: " + mVelocityTracker.getXVelocity(pointerId));
Log.d("", "Y velocity: " + mVelocityTracker.getYVelocity(pointerId));
break;
case MotionEvent.ACTION_UP:
case MotionEvent.ACTION_CANCEL:
// Return a VelocityTracker object back to be re-used by others.
mVelocityTracker.recycle();
break;
}
return true;
}
}
使用指针捕获
某些应用（例如游戏以及远程桌面和虚拟化客户端）受益于对鼠标指针的控制。指针捕获是 Android 8.0（API 级别 26）及更高版本中提供的一项功能，它通过将所有鼠标事件传递到应用中聚焦的视图来提供此控制。
请求指针捕获
应用中的视图只能在其包含的视图层次结构具有焦点时才能请求指针捕获。因此，在视图上执行特定用户操作时（例如，在 onClick() 事件期间或在活动的 onWindowFocusChanged() 事件处理程序中）请求指针捕获。
要请求指针捕获，请在视图上调用 requestPointerCapture() 方法。以下代码示例演示了如何在用户单击视图时请求指针捕获
Kotlin
fun onClick(view: View) {
view.requestPointerCapture()
}
Java
@Override
public void onClick(View view) {
view.requestPointerCapture();
}
指针捕获请求成功后，Android 会调用 onPointerCaptureChange(true)。只要系统在与请求捕获的视图相同的视图层次结构中，系统就会将鼠标事件传递到应用中聚焦的视图。其他应用会停止接收鼠标事件，直到捕获被释放，包括 ACTION_OUTSIDE 事件。Android 会照常传递来自鼠标以外来源的指针事件，但鼠标指针不再可见。
处理捕获的指针事件
视图成功获取指针捕获后，Android 会传递鼠标事件。您的聚焦视图可以通过执行以下任务之一来处理事件
- 如果您使用的是自定义视图，请覆盖
onCapturedPointerEvent(MotionEvent)。 - 否则，注册一个
OnCapturedPointerListener。
以下代码示例演示了如何实现 onCapturedPointerEvent(MotionEvent)
Kotlin
override fun onCapturedPointerEvent(motionEvent: MotionEvent): Boolean {
// Get the coordinates required by your app.
val verticalOffset: Float = motionEvent.y
// Use the coordinates to update your view and return true if the event is
// successfully processed.
return true
}
Java
@Override
public boolean onCapturedPointerEvent(MotionEvent motionEvent) {
// Get the coordinates required by your app.
float verticalOffset = motionEvent.getY();
// Use the coordinates to update your view and return true if the event is
// successfully processed.
return true;
}
以下代码示例演示了如何注册 OnCapturedPointerListener
Kotlin
myView.setOnCapturedPointerListener { view, motionEvent ->
// Get the coordinates required by your app.
val horizontalOffset: Float = motionEvent.x
// Use the coordinates to update your view and return true if the event is
// successfully processed.
true
}
Java
myView.setOnCapturedPointerListener(new View.OnCapturedPointerListener() {
@Override
public boolean onCapturedPointer (View view, MotionEvent motionEvent) {
// Get the coordinates required by your app.
float horizontalOffset = motionEvent.getX();
// Use the coordinates to update your view and return true if the event is
// successfully processed.
return true;
}
});
无论您使用自定义视图还是注册侦听器，您的视图都会收到一个 MotionEvent，其中包含指定相对移动（例如 X 或 Y 增量）的指针坐标，类似于轨迹球设备传递的坐标。您可以使用 getX() 和 getY() 检索坐标。
释放指针捕获
应用中的视图可以通过调用 releasePointerCapture() 来释放指针捕获，如以下代码示例所示
Kotlin
override fun onClick(view: View) {
view.releasePointerCapture()
}
Java
@Override
public void onClick(View view) {
view.releasePointerCapture();
}
系统可以在您没有显式调用 releasePointerCapture() 的情况下从视图中获取捕获，通常是因为包含请求捕获的视图的视图层次结构失去了焦点。