【Android 应用开发】多点触控 ( 多点触控事件 | PointerId | PointerIndex | 坐标获取

文章目录

I . 多点触控事件
II . PointerId 与 PointerIndex 简介
III . 本次 PointerId 与 PointerIndex 获取
IV . PointerId 与 PointerIndex 互相转化
V . 触摸点个数获取 ( getPointerCount )
VI . 触摸点坐标获取
VII . 多点触控示例代码 ( 参考 )

I . 多点触控事件

1 . 多点触控事件 :

① ACTION_DOWN : 第一个手指按下

② ACTION_MOVE : 所有的手指移动

③ ACTION_UP : 最后一个手指抬起

④ ACTION_POINTER_DOWN : 中间的手指按下 ( 已经有手指按下 )

⑤ ACTION_POINTER_UP : 中间手指抬起 ( 还有手指在触摸中 )

2 . 获取多点触控事件 : 调用 MotionEvent 对象的 getActionMasked() 可以获取多点触控事件 , 即上面的 5 种触摸事件 ;

3 . 获取并处理多点触控事件代码示例 :

① 获取多点触控事件 :

//获取当前的多点触控触摸事件
int actionMasked = event.getActionMasked();

② 处理多点触控事件 :

//处理 5种多点触控事件
switch (actionMasked){case MotionEvent.ACTION_DOWN :          //第一个手指按下break;case MotionEvent.ACTION_MOVE :          //手指移动break;case MotionEvent.ACTION_UP :            //最后一个手指抬起break;case MotionEvent.ACTION_POINTER_DOWN :  //中间的手指按下 ( 已经有手指按下 )break;case MotionEvent.ACTION_POINTER_UP :    //中间手指抬起 ( 还有手指在触摸中 )break;}

II . PointerId 与 PointerIndex 简介

1 . Pointer 触摸点 :

① PointerId : 触摸点标识 , 一旦赋值不可更改 ;

手指按下 , 该触摸点产生自带触摸点 ID 属性 , 以及分配一个触摸点索引 , 当手指抬起 , 该触摸点 ID 值回收 ; 期间触摸点 ID 不会改变 ;

② PointerIndex : 触摸点索引 , 触摸点的索引值可能会变 ;

该值从 0 开始计数 , 取值范围是 0 ~ 触摸点个数 - 1 , 每当有一个中间触摸点抬起 , 后面的触摸点就会依次替补该空缺 ;

2 . MotionEvent 与 Pointer 触摸点关系 :

MotionEvent 对象中存储多个触摸点信息 , 每个触摸点都有 PointerId ( 触摸点标识 ) 和 PointerIndex ( 触摸点索引 ) 两个属性 ;

3 . PointerId 与 PointerIndex 运行机制 :

PointerId 触摸点 ID 标识 , 只要按下 , 不抬起 , 值不变 , 如果中间手指抬起 , 那么出现中间的 ID 空置的情况 ; 3 个手指按下 , PointerId 分别是 0, 1 , 2 ;中间的抬起 , 那么 PointerId 的 ID 值会空着 , 两个手指的 ID 分别是 0 和 2 ;

PointerIndex 触摸点索引值 , 3 个手指按下 , 索引值依次是 0 , 1 , 2 , 如果第二个手指抬起 , 后续的第三个的索引会由 2 变成 1 , 顺序补位替补上去 ;

III . 本次 PointerId 与 PointerIndex 获取

① 获取本次的触摸事件的触摸点 ID :

//获取本事件对应的 pointerIndex
int actionIndex = event.getActionIndex();

② 获取本次触摸事件的触摸点索引 :

//4 . 获取 actionIndex 对应的 PointerId
int pointerId = event.getPointerId(actionIndex);

IV . PointerId 与 PointerIndex 互相转化

PointerId 与 PointerIndex 关联及转化关系 :

① 两者特点 : PointerId 是固定不变的 , PointerIndex 有顺序补位的特征 , 是不确定的 ;

② PointerId -> PointerIndex : 通过调用 MotionEvent 对象的 findPointerIndex(int pointerId) 方法可以获取指定 pointerId 对应的 PointerIndex 值 ;

③ PointerIndex -> PointerId : 通过调用 MotionEvent 对象的 getPointerId(int pointerIndex) 方法可以获取指定 PointerIndex 对应的 pointerId 值 ;

//3 . 获取 PointerId 对应的 PointerIndex
//      查找 ID值 对应的索引值
int pointerIndex = event.findPointerIndex(PointerId);
...
//      获取 索引值 对应的 ID 值
int PointerId = event.getPointerId(PointerIndex)

V . 触摸点个数获取 ( getPointerCount )

获取当前触摸点个数 :

//获取当前触摸点个数
int pointCount = event.getPointerCount();

VI . 触摸点坐标获取

获取触摸点坐标 :

① 获取当前触摸事件坐标 :

public final float getX()
public final float getY()

② 获取指定触摸点索引 PointerIndex 坐标 : ( 注意不是触摸点标识 )

public final float getX(int pointerIndex)
public final float getY(int pointerIndex)

//1 . 获取 坐标//1.1 获取 当前 触摸 事件的 x y 坐标
float x = event.getX();
float y = event.getY();//1.2 获取 指定 pointerIndex 的 x y 坐标 ( 获取第 0 个索引的坐标 )
int pointerIndex = 0;
float x_pointer = event.getX(pointerIndex);
float y_pointer = event.getY(pointerIndex);

VII . 多点触控示例代码 ( 参考 )

package kim.hsl.multitouch;import androidx.appcompat.app.AppCompatActivity;import android.os.Bundle;
import android.util.Log;
import android.view.MotionEvent;public class MainActivity extends AppCompatActivity {@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);}@Overridepublic boolean onTouchEvent(MotionEvent event) {//多点触控示例/*1 . 多点触控事件 :多点触控事件 Action 由 pointerIndex 和 动作码 进行或运算 合成调用 event.getActionMasked() 即可获取动作码 , 屏蔽 pointerIndex 触摸索引2 . PointerId 和 PointerIndex :Pointer 就是触摸点 ;两个值的特点 :PointerId : 唯一性的表示一个触摸点 , 该值如果触摸上 , 任意移动 , 只要不抬起 , 就不变 ;PointerIndex : 触摸点的索引 , 是一个从 0 开始计数的连续的数值 , 同样是第 0 个索引 , 代表的可能是不同触摸点 ;运行机制 :PointerId : 只要按下 , 不抬起 , 值不变 , 如果中间手指抬起 , 那么出现中空的情况 ;3 个手指按下 , PointerId 分别是 1 , 2 , 3 ;中间的抬起 , 那么 PointerId 的 ID 值会空着 , 两个手指的 ID 分别是 1 和 3PointerIndex : 3 个手指按下 , 如果第二个手指抬起 , 后续的第三个的索引会由 2 变成 1 , 顺序补位替补上去PointerId 与 PointerIndex 转换换 :pointerId 是确定的 , PointerIndex 有顺序补位的特征 , 是不确定的通过 findPointerIndex(int pointerId) 方法可以获取指定 pointerId 的 PointerIndex 值3 . 获取坐标 :获取当前坐标 : event.getX();获取指定 pointerIndex 坐标 : event.getX(pointerIndex);4 . 多点触控的 5 种事件 :单点触控需要处理 ACTION_DOWN , ACTION_MOVE , ACTION_UP多点触控需要处理 ACTION_DOWN , ACTION_MOVE , ACTION_UP , ACTION_POINTER_DOWN , ACTION_POINTER_UP多点触控中这些动作有不同的含义 :ACTION_DOWN : 第一个手指按下ACTION_MOVE : 所有的手指滑动事件ACTION_UP : 最后一个手指抬起ACTION_POINTER_DOWN : 中间的手指按下 ( 已经有手指按下 )ACTION_POINTER_UP : 中间手指抬起 ( 还有手指在触摸中 )5 . 多点触控与单点触控对比多了两个事件 ACTION_POINTER_DOWN 和 ACTION_POINTER_UP多了触摸点 ID 标识与触摸点索引机制*///1 . 获取 坐标//1.1 获取 当前 触摸 事件的 x y 坐标float x = event.getX();float y = event.getY();//1.2 获取 指定 pointerIndex 的 x y 坐标 ( 获取第 0 个索引的坐标 )int pointerIndex = 0;float x_pointer = event.getX(pointerIndex);float y_pointer = event.getY(pointerIndex);//2 . 获取 触摸事件 相关属性//获取当前的多点触控触摸事件int actionMasked = event.getActionMasked();//获取本事件对应的 pointerIndexint actionIndex = event.getActionIndex();//获取当前触摸点个数int pointCount = event.getPointerCount();//3 . 获取 PointerId 对应的 PointerIndex//      查找第 1 个按下的手指的索引值pointerIndex = event.findPointerIndex(0);//4 . 处理对应的事件操作switch (actionMasked){case MotionEvent.ACTION_DOWN :          //第一个手指按下Log.i("TAG", "ACTION_DOWN : 第一个手指按下");break;case MotionEvent.ACTION_MOVE :          //手指移动Log.i("TAG", "ACTION_MOVE : 手指移动");break;case MotionEvent.ACTION_UP :            //最后一个手指抬起Log.i("TAG", "ACTION_UP : 最后一个手指抬起");break;case MotionEvent.ACTION_POINTER_DOWN :  //中间的手指按下 ( 已经有手指按下 )Log.i("TAG", "ACTION_POINTER_DOWN : 中间的手指按下 ( 已经有手指按下 )");break;case MotionEvent.ACTION_POINTER_UP :    //中间手指抬起 ( 还有手指在触摸中 )Log.i("TAG", "ACTION_POINTER_UP : 中间手指抬起 ( 还有手指在触摸中 )");break;}return true;}
}