多指触控是指监听多个手指的触控事件,我们可以重写 View 中的 onTouchEvent 方法,或者使用 setOnTouchListener 方法来处理触摸事件。
首先我们来看一下如何判断多指触摸时的事件类型。
MotionEvent 中的事件类型
一般而言,我们通过判断 MotionEvent 的 action 来判断输入事件类型,从而做出相应的处理。
在不考虑多指的情况下,我们一般只关注如下几个事件类型:
MotionEvent.ACTION_DOWN
第一根手指点击屏幕MotionEvent.ACTION_UP
最后一根手指离开屏幕MotionEvent.ACTION_MOVE
屏幕上有手指在滑动MotionEvent.ACTION_CANCEL
事件被拦截
那么对于多指触控来说,除了上述常用的几种事件类型之外,我们还需要关注另外两个事件类型:
MotionEvent.ACTION_POINTER_DOWN
点击前屏幕上已存在手指MotionEvent.ACTION_POINTER_UP
当屏幕上一根手指被抬起,此时屏幕上仍有别的手指
需要注意的是,上述的两个类型我们不能像以前那样使用 MotionEvent#getAction 方法获取到,需要使用 getActionMasked 才行。
所以再处理多指触控时我们的 onTouch 方法一般可以写成这样:
public boolean onTouchEvent(MotionEvent event) {
switch (event.getActionMasked()) {
case MotionEvent.ACTION_DOWN: break;
case MotionEvent.ACTION_UP: break;
case MotionEvent.ACTION_MOVE: break;
case MotionEvent.ACTION_POINTER_DOWN: break;
case MotionEvent.ACTION_POINTER_UP: break;
}
return true;
}
当有多跟手指同时触碰屏幕时,我们需要追踪不同的手指。这里面又涉及到另外几个概念。
手指追踪
MotionEvent 中提供了几个用于追踪不同手指的方法,再介绍它们之前我先来说一下几个概念。
ActionIndex
事件索引PointerId
手指 IDPointerIndex
手指索引
与之对应的几个方法:
方法 | 描述 | 备注 | |
---|---|---|---|
getActionMasked() | 获取事件类型 | 可获取到多指触控事件类型 | |
getPointerCount() | 获取当前屏幕上的手指个数 | ||
getActionIndex() | 获取事件索引 | ||
getPointerId(int) | 获取手指 ID | 参数为 ActionIndex | |
findPointerIndex(int) | 获取手指索引 | 参数为 PointerId |
ActionIndex(事件索引)
ActionIndex 通过 getActionIndex 方法可以直接获取到,可以大概地将其理解为用来描述当前事件发生在第几根手指上,例如我们监听到手指抬起时,可能想知道是哪一根手指抬起,那么可以通过 ActionIndex 来判断。
另外,对于同一根手指来说,ActionIndex 的值可能会随着手指的按下与抬起变化的,所以我们不能用它来标识某个手指。
看起来,ActionIndex 唯一的作用就是用来获取 PointerId。
特别需要说明一点,该方法只针对 ACTION_POINTER_DOWN 及 ACTION_POINTER_UP 事件有效,ACTION_MOVE 事件是没法准确的获取到该值的,我们需要结合其他事件综合判断。
PointerId(手指 ID)
PointerId 通过 getPointerId(int) 方法获取,参数为 ActionIndex。
我们可以通过 PointerId 来标识一根手指。对于同一根手指来说,从按下到抬起整个过程中,PointerId 是固定不变的。
同样需要注意的是,这个值可能会被重用,例如一个手指的 id 是 0,当它抬起后重新按下一根手指,id 可能同样为 0。
PointerIndex(手指索引)
PointerIndex 通过 findPointerIndex(int) 来获取,参数为 PointerId。
这个值是用来获取该事件更多内容的。
如果我们想获取该事件的点击点位置,当我们通过 getX()/getY() 方法获取坐标时获取到的只能是第一根手指的位置,但是这两个方法提供了一个重载:
float getX(int pointerIndex);
float getY(int pointerIndex);
我们可以将 PointerIndex 当做参数来获取到当前手指的点击坐标。
此外还有很多方法都提供了类似的重载,这里就不一一叙述了。
应用
通过上面的介绍我们已经大概明白了多点触控的一些关键点了,现在我们来实际应用一下吧。
我这里将做一个用于绘制手指运动轨迹的 DrawView,并且可以同时跟踪多个手指的轨迹,效果图如下:
上图是同时滑动四根手指时的效果。
分析
要实现这样的效果,主要有两点问题需要考虑。
第一是如何准确的追踪某根手指的滑动轨迹,因为上面也说了,ACTION_MOVE 是无法获取到 ActionIndex 的。但上帝再关了门同时肯定也会开个窗户,我们可以通过 PointerId 来追踪,首先监听 ACTION_DOWN 及 ACTION_POINTER_DOWN 两个事件,在此处获取到新手指的 PointerId,ACTION_MOVE 事件中遍历所有的手指,然后对比 PointerId 既可。
第二,因为 MotionEvent 是会将连续多个滑动轨迹打包成一个 MotionEvent,我们需要使用 getHistoricalX 获取此次滑动的历史轨迹,该方法签名如下:
float getHistoricalX(int pointerIndex, int pos);
第一个参数 pointerIndex 好解决,第一个问题里已经讲过了,主要是第二个参数。
因为 HistoricalX 是个列表,我们需要通过索引去一个一个读取,第二个 pos 参数就是索引,但前提是我们得知道这个列表的长度才行啊。这样只需要一个 for 循环既可解决。
MotionEvent 里面提供了获取这个列表长度的方法:
int getHistorySize();
但这提供了这一个方法,没有其他重载,所以没法通过 pointerIndex 获取某跟手指此次滑动的历史轨迹列表长度!
不过经过我的测试,不管哪根手指滑动都可以通过 getHistorySize 方法获取历史轨迹长度,然后调用 getHistoricalX 方法获取历史轨迹坐标,虽然不知道为什么要这么设计,但也算确实解决了这个问题。
实现
我们先定义一个内部类用于充当绘制元数据:
private static class DrawPath {
/**
* 手指 ID,默认为 -1,手指离开后置位 -1
*/
private int pointerId = -1;
/**
* 曲线颜色
*/
private int drawColor;
/**
* 曲线路径
*/
private Path path;
/**
* 轨迹列表,用于判断目标轨迹是否已添加进来
*/
private Stack<List<PointF>> record;
DrawPath(int pointerId, int drawColor, Path path) {
this.pointerId = pointerId;
this.drawColor = drawColor;
this.path = path;
record = new Stack<>();
}
}
上面的一个 DrawPath 对应一次手指滑动的生命周期,也就是从 DOWN 到 UP 这个中间所经历的的轨迹。
然后再定义一个存放 DrawPath 的列表及画笔,轨迹颜色数组等变量:
/**
* 绘制画笔
*/
private Paint mPaint = new Paint();
/**
* 历史路径
*/
private List<DrawPath> mDrawMoveHistory = new ArrayList<>();
/**
* 用于生成随机数,随机取出颜色数组中的颜色
*/
private Random random = new Random();
初始化一下下:
private void init() {
mPaint.setAntiAlias(true);
mPaint.setStyle(Paint.Style.STROKE);
mPaint.setStrokeCap(Paint.Cap.ROUND);
mPaint.setStrokeWidth(dip2px(getContext(), 5));
}
现在我们来重写 onTouchEvent 方法吧:
@Override
public boolean onTouchEvent(MotionEvent event) {
//多指触控需要使用 getActionMasked
switch (event.getActionMasked()) {
case MotionEvent.ACTION_DOWN: {
//处理点击事件
performClick();
//重置所有 PointerId 为 -1
clearTouchRecordStatus();
//新增一个轨迹
addNewPath(event);
//重绘
invalidate();
return true;
}
case MotionEvent.ACTION_MOVE: {
if (mDrawMoveHistory.size() > 0) {
for (int i = 0; i < event.getPointerCount(); i++) {
//遍历当前屏幕上所有手指
int itemPointerId = event.getPointerId(i);//获取到这个手指的 ID
for (DrawPath itemPath : mDrawMoveHistory) {
//遍历绘制记录表,通过 ID 找到对应的记录
if (itemPointerId == itemPath.pointerId) {
int pointerIndex = event.findPointerIndex(itemPointerId);
//通过 pointerIndex 获取到此次滑动事件的所有历史轨迹
List<PointF> recordList = readPointList(event, pointerIndex);
if (!listEquals(recordList, itemPath.record.peek())) {
//判断该 List 是否已存在,不存在则添加进去
itemPath.record.push(recordList);
addPath(recordList, itemPath.path);
}
}
}
}
invalidate();
}
return true;
}
case MotionEvent.ACTION_POINTER_UP:
//屏幕上有一根指头抬起,但有别的指头未抬起时的事件
int pointerId = event.getPointerId(event.getActionIndex());
for (DrawPath item : mDrawMoveHistory) {
if (item.pointerId == pointerId) {
//该手指已绘制结束,将此 PointerId 重置为 -1
item.pointerId = -1;
}
}
break;
case MotionEvent.ACTION_POINTER_DOWN:
//屏幕上已经有了手指,此时又有别的手指点击时事件
addNewPath(event);
invalidate();
break;
case MotionEvent.ACTION_UP:
//最后一根手指抬起,重置所有 PointerId
clearTouchRecordStatus();
break;
case MotionEvent.ACTION_CANCEL:
//事件被取消
clearTouchRecordStatus();
break;
}
return true;
}
上面都有注释,我就不详细说了。
然后是重写 onDraw 方法,这虽然是个绘制轨迹的控件,但其实 onDraw 方法里反倒没多少代码:
@Override
protected void onDraw(Canvas canvas) {
super.onDraw(canvas);
if (mDrawMoveHistory == null || mDrawMoveHistory.isEmpty()) {
return;
}
for (DrawPath item : mDrawMoveHistory) {
mPaint.setColor(item.drawColor);
canvas.drawPath(item.path, mPaint);
}
}
这样就实现了一个简易的支持多指绘制控件啦,我们还可以向其中添加一些诸如撤销上一步等操作的方法,这里就不多说了。
DrawView 的完整代码已经放到了 Github 上,欢迎查看:
https://github.com/0xZhangKe/Collection/blob/master/DrawView/DrawView.java
关于事件分发拦截可以看我另一篇文章。
如果觉得还不错的话,欢迎关注我的个人公众号,我会不定期发一些干货文章~