跟踪触控和指针移动

尝试Compose方式
Jetpack Compose是Android推荐的UI工具包。学习如何在Compose中使用触控和输入。

本课程介绍如何跟踪触控事件中的移动。

每当当前触控接触位置、压力或大小发生变化时,都会触发一个新的onTouchEvent(),并带有ACTION_MOVE事件。如检测常用手势中所述,所有这些事件都记录在MotionEventonTouchEvent()参数中。

由于基于手指的触控并非总是最精确的交互形式,因此触控事件的检测通常更基于移动而不是简单的接触。为了帮助应用区分基于移动的手势(例如滑动)和非移动手势(例如单点触控),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)

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()的情况下从视图中获取捕获,通常是因为包含请求捕获的视图的视图层次结构失去了焦点。