手势识别兼容Android 1.x和2.x的代码【转】

摘要: 由于Android 2.x开始很多API变动比较大新增了一些比如多点触控的支持，对于屏幕触控手势识别中我们需要考虑更多的实现方法，下面是一段兼容Android 1.x和2.x的代码，可以让我们的程序兼容几乎99%的Android手机。 一 ...

 由于Android 2.x开始很多API变动比较大新增了一些比如多点触控的支持，对于屏幕触控手势识别中我们需要考虑更多的实现方法，下面是一段兼容Android 1.x和2.x的代码，可以让我们的程序兼容几乎99%的Android手机。
  一、首先新建一个抽象类判断SDK版本问题
 public abstract class VersionedGestureDetector {
    private static final String TAG = "VersionedGestureDetector";
    OnGestureListener mListener;
    public static VersionedGestureDetector newInstance(Context context,
            OnGestureListener listener) {  //设计实例化构造方法，这里Android123提示大家目前有3种API的实现方法，我们需要逐一考虑最优的解决方法，以满足高平台更多的功能实现。
        final int sdkVersion = Integer.parseInt(Build.VERSION.SDK); //使用android.os.Build判断API Level，但需要将字符串转换为整形
        VersionedGestureDetector detector = null;
        if (sdkVersion < Build.VERSION_CODES.ECLAIR) { //如果版本小于2.0则使用1.5版本的API，可以兼容1.5和1.6
            detector = new CupcakeDetector();
        } else if (sdkVersion < Build.VERSION_CODES.FROYO) { //如果版本小于2.1则使用2.0版本的API，可以兼容2.0,2.0.1和2.1这三个版本
            detector = new EclairDetector();
        } else {  //否则使用2.2开始的新的触控API
            detector = new FroyoDetector(context);
        }
        Log.d(TAG, "Created new " + detector.getClass()); //判断最终选择的到底是哪个版本的类
        detector.mListener = listener;
        return detector;
    }
    public abstract boolean onTouchEvent(MotionEvent ev); //我们需要根据版本决定onTouchEvent的实现
    public interface OnGestureListener { //手势判断接口主要是实现两个方法
        public void onDrag(float dx, float dy);  //拖拽
        public void onScale(float scaleFactor); //缩放
    }
    private static class CupcakeDetector extends VersionedGestureDetector { //针对Android 1.5和1.6设计的兼容方式
        float mLastTouchX;
        float mLastTouchY;
        float getActiveX(MotionEvent ev) { //获得当前X坐标
            return ev.getX();
        }
        float getActiveY(MotionEvent ev) { //获得当前Y坐标
            return ev.getY();
        }
        boolean shouldDrag() { //是否是拖拽中或者说移动中
            return true;
        }
        @Override
        public boolean onTouchEvent(MotionEvent ev) { //重写onTouchEvent方法
            switch (ev.getAction()) {
            case MotionEvent.ACTION_DOWN: {  //向下
                mLastTouchX = getActiveX(ev);
                mLastTouchY = getActiveY(ev);
                break;
            }
            case MotionEvent.ACTION_MOVE: { //Android开发网提醒大家，由于1.x时代的API比较简单，很多手势没有封装，我们只能从ACTION_MOVE中根据坐标变化判断手势样式
                final float x = getActiveX(ev);
                final float y = getActiveY(ev);
                if (shouldDrag()) {
                    mListener.onDrag(x - mLastTouchX, y - mLastTouchY); //处理拖拽移动
                }
                mLastTouchX = x;
                mLastTouchY = y;
                break;
            }
            }
            return true;
        }
    }
    private static class EclairDetector extends CupcakeDetector { //这个是针对Android 2.0,2.0.1和2.1提供的解决方法，可以看到有很多多点触控相关API出现
        private static final int INVALID_POINTER_ID = -1;
        private int mActivePointerId = INVALID_POINTER_ID;
        private int mActivePointerIndex = 0;
        @Override
        float getActiveX(MotionEvent ev) {
            return ev.getX(mActivePointerIndex);
        }
        @Override
        float getActiveY(MotionEvent ev) {
            return ev.getY(mActivePointerIndex);
        }
        @Override
        public boolean onTouchEvent(MotionEvent ev) {
            final int action = ev.getAction();
            switch (action & MotionEvent.ACTION_MASK) {
            case MotionEvent.ACTION_DOWN:
                mActivePointerId = ev.getPointerId(0);
                break;
            case MotionEvent.ACTION_CANCEL:
            case MotionEvent.ACTION_UP:
                mActivePointerId = INVALID_POINTER_ID;
                break;
            case MotionEvent.ACTION_POINTER_UP: //有个点松开
                final int pointerIndex = (ev.getAction() & MotionEvent.ACTION_POINTER_INDEX_MASK)
                        >> MotionEvent.ACTION_POINTER_INDEX_SHIFT;
                final int pointerId = ev.getPointerId(pointerIndex); //获取第几个点
                if (pointerId == mActivePointerId) {
                    final int newPointerIndex = pointerIndex == 0 ? 1 : 0;
                    mActivePointerId = ev.getPointerId(newPointerIndex);
                    mLastTouchX = ev.getX(newPointerIndex); //处理第newPointerIndex个点的x位置
                    mLastTouchY = ev.getY(newPointerIndex);
                }
                break;
            }
            mActivePointerIndex = ev.findPointerIndex(mActivePointerId);
            return super.onTouchEvent(ev);
        }
    }
    private static class FroyoDetector extends EclairDetector { //从Android 2.2开始可以很好的处理多点触控的缩放问题
        private ScaleGestureDetector mDetector;
        public FroyoDetector(Context context) {
            mDetector = new ScaleGestureDetector(context,
                    new ScaleGestureDetector.SimpleOnScaleGestureListener() {
                @Override public boolean onScale(ScaleGestureDetector detector) {
                    mListener.onScale(detector.getScaleFactor()); //根据 ScaleGestureDetector.SimpleOnScaleGestureListener这个系统类处理缩放情况通过onScale方法
                    return true;
                }
            });
        }
        @Override
        boolean shouldDrag() {
            return !mDetector.isInProgress();
        }
        @Override
        public boolean onTouchEvent(MotionEvent ev) {
            mDetector.onTouchEvent(ev);
            return super.onTouchEvent(ev);
        }
    }
}
 有关调用方法，我们可以自定义一个View，取名为TouchExampleView类，这里来处理触控相关的问题
public class TouchExampleView extends View {
    private Drawable mIcon; //我们以一个图片为参照物，根据手势控制
    private float mPosX;
    private float mPosY;
    private VersionedGestureDetector mDetector;
    private float mScaleFactor = 1.f; //原始缩放比例为1.0
    public TouchExampleView(Context context) {
        this(context, null, 0);
    }
    public TouchExampleView(Context context, AttributeSet attrs) {
        this(context, attrs, 0);
    }
    public TouchExampleView(Context context, AttributeSet attrs, int defStyle) { //实现我们自定义View的构造
        super(context, attrs, defStyle);
        mIcon = context.getResources().getDrawable(R.drawable.icon);
        mIcon.setBounds(0, 0, mIcon.getIntrinsicWidth(), mIcon.getIntrinsicHeight());
        mDetector = VersionedGestureDetector.newInstance(context, new GestureCallback()); //实例化刚才的版本自适应手势控制类
    }
    @Override
    public boolean onTouchEvent(MotionEvent ev) { //重写onTouchEvent方法，使用VersionedGestureDetector类得出的数据。
        mDetector.onTouchEvent(ev);
        return true;
    }
    @Override
    public void onDraw(Canvas canvas) { //处理自定义View绘制方法
        super.onDraw(canvas);
        canvas.save();
        canvas.translate(mPosX, mPosY); //进行平移操作，根据mPosX和mPosY坐标
        canvas.scale(mScaleFactor, mScaleFactor); //进行缩放操作，参数就是刚才定义的float类型的缩放比例
        mIcon.draw(canvas); //直接绘制图片变化到画布中
        canvas.restore();
    }
    private class GestureCallback implements VersionedGestureDetector.OnGestureListener {
        public void onDrag(float dx, float dy) { //这里Android123提示大家在2.2中这个回调方法将可以支持拖拽的坐标处理
            mPosX += dx;
            mPosY += dy;
            invalidate();
        }
        public void onScale(float scaleFactor) {
            mScaleFactor *= scaleFactor; //缩放控制
            mScaleFactor = Math.max(0.1f, Math.min(mScaleFactor, 5.0f)); //限制最小缩放比例为1.0最大为5.0倍数
            invalidate();
        }
    }
}
 有关调用我们的自定义的TouchExampleView可以在Activity的onCreate方法中加入以下代码，
     TouchExampleView view = new TouchExampleView(this);
     view.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
      ViewGroup.LayoutParams.MATCH_PARENT));
     setContentView(view);  //替换掉原始的res.layout.main
最后Android123需要给大家说明的是使用本例子，直接使用Android 2.2的SDK创建工程，即API Level为8，发布时在androidmanifest.xml中加入uses-sdk android:minSdkVersion="3" android:targetSdkVersion="8"这句可以兼容从Android 1.5到2.2的版本，有关2.3中新增的一个可以处理5个或5个以上的多点触控增强类Android开发网将在以后的时间中介绍。