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

//获取当前的多点触控触摸事件
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;

}

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

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

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

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

//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);

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 {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    public 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 和 3

                    PointerIndex : 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();

        //获取本事件对应的 pointerIndex
        int 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;
    }
}