手勢識別兼容Android 1.x和2.x的代碼

由於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開發網將在以後的時間中介紹。