3.8 Gestures

标注：本文为个人学习使用，仅做自己学习参考使用，请勿转载和转发
2018-07-10: 初稿，感冒有点飘哈。参考博主coder-pig

0. 引言

Android提供手势检测，并未手势识别提供了相应的监听器！
Android运行开发者自行添加手势，并提供了相应的API识别用户手势！
官方API文档先:GestureDetector

1. Android中手势交互的执行顺序

手指触碰屏幕时，触发MotionEvent事件
该事件被onTouchListener监听，可在它的onTouch()方法中获得该MotionEvent对象！
通过GestureDetector转发MotionEvent对象给OnGestureListener
我们可以通过OnGestureListener获得该对象，然后获取相关信息，以及做相关处理！

我们来看下上述的三个类都是干嘛的:

MotionEvent: 这个类用于封装手势、触摸笔、轨迹球等等的动作事件。其内部封装了两个重要的属性X和Y，这两个属性分别用于记录横轴和纵轴的坐标。
GestureDetector: 识别各种手势。
OnGestureListener: 这是一个手势交互的监听接口，其中提供了多个抽象方法，并根据GestureDetector的手势识别结果调用相对应的方法。

2. GestureListener详解

监听手势的关键是GestureListener，它提供了一些回调方法：
1. 按下（onDown）：刚刚手指接触到触摸屏的那一刹那，就是触的那一下。
2. 抛掷（onFling）：手指在触摸屏上迅速移动，并松开的动作。
3. 长按（onLongPress）：手指按在持续一段时间，并且没有松开。
4. 滚动（onScroll）：手指在触摸屏上滑动。
5. 按住（onShowPress）：手指按在触摸屏上，它的时间范围在按下起效，在长按之前。
6. 抬起（onSingleTapUp）：手指离开触摸屏的那一刹那。

知道了GestureListener的相关方法后，实现手势检测也很简单，步骤如下：
1. Step 1: 创建GestureDetector对象，创建时需实现GestureListener传入
2. Step 2: 将Activity或者特定组件上的TouchEvent的事件交给GestureDetector处理即可！我们写个简单的代码来验证这个流程，即重写对应的方法：

代码如下：

public class MainActivity extends AppCompatActivity {

    private MyGestureListener mgListener;
    private GestureDetector mDetector;
    private final static String TAG = "MyGesture";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //实例化GestureListener与GestureDetector对象
        mgListener = new MyGestureListener();
        mDetector = new GestureDetector(this, mgListener);

    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        return mDetector.onTouchEvent(event);
    }

    //自定义一个GestureListener,这个是View类下的，别写错哦！！！
    private class MyGestureListener implements GestureDetector.OnGestureListener {

        @Override
        public boolean onDown(MotionEvent motionEvent) {
            Log.d(TAG, "onDown:按下");
            return false;
        }

        @Override
        public void onShowPress(MotionEvent motionEvent) {
            Log.d(TAG, "onShowPress:手指按下一段时间,不过还没到长按");
        }

        @Override
        public boolean onSingleTapUp(MotionEvent motionEvent) {
            Log.d(TAG, "onSingleTapUp:手指离开屏幕的一瞬间");
            return false;
        }

        @Override
        public boolean onScroll(MotionEvent motionEvent, MotionEvent motionEvent1, float v, float v1) {
            Log.d(TAG, "onScroll:在触摸屏上滑动");
            return false;
        }

        @Override
        public void onLongPress(MotionEvent motionEvent) {
            Log.d(TAG, "onLongPress:长按并且没有松开");
        }

        @Override
        public boolean onFling(MotionEvent motionEvent, MotionEvent motionEvent1, float v, float v1) {
            Log.d(TAG, "onFling:迅速滑动，并松开");
            return false;
        }
    }
}

对应操作截图：

1.按下后立即松开:
2.长按后松开：
3.轻轻一滑，同时松开：
4.按住后不放持续做滑动操作：

PS:从上述结果来看，我们发现了一个问题：我们实现OnGestureListener需要实现所有的手势，可能我针对的仅仅是滑动，但是你还是要去重载，这显得很逗逼，是吧，官方肯定会给出解决方法滴，官方另外给我们提供了一个SimpleOnGestureListener类只需把上述的OnGestureListener替换成SimpleOnGestureListener即可！

3. 代码示例

实现下滑关闭Activity，上滑启动新的Activity，这里就用上面的SimpleOnGestureListener来实现
运行效果图：

实现代码：

public class MainActivity extends AppCompatActivity {

    private GestureDetector mDetector;
    private final static int MIN_MOVE = 200;   //最小距离
    private MyGestureListener mgListener;


    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //实例化SimpleOnGestureListener与GestureDetector对象
        mgListener = new MyGestureListener();
        mDetector = new GestureDetector(this, mgListener);
    }

    @Override
    public boolean onTouchEvent(MotionEvent event) {
        return mDetector.onTouchEvent(event);
    }

    //自定义一个GestureListener,这个是View类下的，别写错哦！！！
    private class MyGestureListener extends GestureDetector.SimpleOnGestureListener {

        @Override
        public boolean onFling(MotionEvent e1, MotionEvent e2, float v, float v1) {
            if(e1.getY() - e2.getY() > MIN_MOVE){
                startActivity(new Intent(MainActivity.this, MainActivity.class));
                Toast.makeText(MainActivity.this, "通过手势启动Activity", Toast.LENGTH_SHORT).show();
            }else if(e1.getY() - e2.getY()  < MIN_MOVE){
                finish();
                Toast.makeText(MainActivity.this,"通过手势关闭Activity",Toast.LENGTH_SHORT).show();
            }
            return true;
        }
    }
}

结果分析：从上面的对比就可以知道，相比起SimpleOnGestureListener使用SimpleOnGestureListener 显得更加的简单，想重写什么方法就重写什么方法，另外例子比较简单，大家可以自己试试其他玩法，比如通过手势缩放图片~

4. 手势添加、识别

除了讲解手势检测之外，Android还运行我们的手势进行添加，然后提供了相关的识别API；
Android中使用GestureLibrary来代表手势库，提供GestureLibraries工具来创建手势库。
四个加载手势库的静态方法
1. static GestureLibrary 方法: fromFile(File path)
2. static GestureLibrary 方法: fromFile(String path)
3. static GestureLibrary 方法: fromFile(Context context, String name)
4. static GestureLibrary 方法: fromFile(Context context, int resourceId)
获得GestureLibraries对象之后，就可以使用该对象题佛那个的下述方法来做相应操作了：
相关方法
1. public void addGesture (String entryName, Gesture gesture)：添加一个名为entryName的手势
2. public Set getGestureEntries ()：获得手势库中所有手势的名称
3. public ArrayList getGestures (String entryName)：获得entryName名称对应的全部手势
4. public ArrayList recognize (Gesture gesture): 从当前手势库中识别与gesture匹配的全部手势
5. public void removeEntry (String entryName)：删除手势库中entryName名称对应的手势
6. public void removeGesture (String entryName, Gesture gesture)：删除手势库中entryName和gesture都匹配的手势
7. public abstract boolean save ()：想手势库中添加手势或从中删除手势后调用该方法保存手势库

GestureOverlayView手势编辑组件：

Android为GestureOverlayView提供了三种监听器接口，如下，一般常用的是: OnGesturePerformedListener;用于手势完成时提供响应！
1. interface GestureOverlayView.OnGestureListener
2. interface GestureOverlayView.OnGesturePerformedListener
3. interface GestureOverlayView.OnGesturingListener

5. 添加手势代码示例

PS：例子引用的是——李刚《Android疯狂讲义》的代码
运行效果图：

好吧，下面贴下实现代码：
两个布局文件：activity_main.xml和dialog_save.xml
activity_main.xml

dialog_save.xml

MainActivity.java:

public class MainActivity extends AppCompatActivity {

    private EditText editText;
    private GestureOverlayView gesture;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //获取手势编辑组件后，设置相关参数
        gesture = (GestureOverlayView) findViewById(R.id.gesture);
        gesture.setGestureColor(Color.GREEN);
        gesture.setGestureStrokeWidth(5);
        gesture.addOnGesturePerformedListener(new GestureOverlayView.OnGesturePerformedListener() {
            @Override
            public void onGesturePerformed(GestureOverlayView gestureOverlayView, final Gesture gesture) {
                View saveDialog = getLayoutInflater().inflate(R.layout.dialog_save,null,false);
                ImageView img_show = (ImageView) saveDialog.findViewById(R.id.img_show);
                final EditText edit_name = (EditText) saveDialog.findViewById(R.id.edit_name);
                Bitmap bitmap = gesture.toBitmap(128,128,10,0xffff0000);
                img_show.setImageBitmap(bitmap);
                new AlertDialog.Builder(MainActivity.this).setView(saveDialog)
                        .setPositiveButton("保存",new DialogInterface.OnClickListener()
                        {
                            @Override
                            public void onClick(DialogInterface dialogInterface, int i) {
                                //获取文件对应的手势库
                                GestureLibrary gestureLib = GestureLibraries.fromFile("/mnt/sdcard/mygestures");
                                gestureLib.addGesture(edit_name.getText().toString(),gesture);
                                gestureLib.save();
                            }
                        }).setNegativeButton("取消", null).show();
            }
        });
    }
}

最后还需要在AndroidManifest.xml中添加写入SD卡的权限：

6. 手势识别代码示例

实现代码：

public class MainActivity extends AppCompatActivity {

    private GestureOverlayView gesture;
    private GestureLibrary gestureLibrary;
    private Context mContext;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mContext = MainActivity.this;
        gestureLibrary = GestureLibraries.fromFile("mmt/sdcard/mygestures");
        if (gestureLibrary.load()) {
            Toast.makeText(mContext, "手势库加载成功", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(mContext, "手势库加载失败", Toast.LENGTH_SHORT).show();
        }

        //获取手势编辑组件后，设置相关参数
        gesture = (GestureOverlayView) findViewById(R.id.gesture);
        gesture.setGestureColor(Color.GREEN);
        gesture.setGestureStrokeWidth(5);
        gesture.addOnGesturePerformedListener(new GestureOverlayView.OnGesturePerformedListener() {
            @Override
            public void onGesturePerformed(GestureOverlayView gestureOverlayView, final Gesture gesture) {
                //识别用户刚绘制的手势
                ArrayList predictions = gestureLibrary.recognize(gesture);
                ArrayList result = new ArrayList();
                //遍历所有找到的Prediction对象
                for (Prediction pred : predictions) {
                    if (pred.score > 2.0) {
                        result.add("与手势【" + pred.name + "】相似度为" + pred.score);
                    }
                }
                if (result.size() > 0) {
                    ArrayAdapter