萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 手勢識別封裝類:支援左右滑動切換頁面

專案需求:左右滑動切換頁面。為避免在每個 Activity 重複編寫 GestureDetector 邏輯,封裝可復用的 GestureHelper 工具類。

核心實作

public class GestureHelper implements GestureDetector.OnGestureListener {

    private final GestureDetector gestureDetector;
    private final int screenWidth;
    private OnFlingListener flingListener;

    public static abstract class OnFlingListener {
        public abstract void onFlingLeft();
        public abstract void onFlingRight();
    }

    public GestureHelper(Context context) {
        DisplayMetrics dm = context.getResources().getDisplayMetrics();
        screenWidth = dm.widthPixels;
        gestureDetector = new GestureDetector(context, this);
    }

    public void setOnFlingListener(OnFlingListener listener) {
        this.flingListener = listener;
    }

    // 由 Activity 的 onTouchEvent 委派
    public boolean onTouchEvent(MotionEvent event) {
        return gestureDetector.onTouchEvent(event);
    }

    @Override
    public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
        final int MIN_DISTANCE = (int) (screenWidth / 3.0f);
        final int MIN_VELOCITY = 200; // px/s

        float diffX = e1.getX() - e2.getX();
        if (Math.abs(diffX) > MIN_DISTANCE && Math.abs(velocityX) > MIN_VELOCITY) {
            if (diffX > 0 && flingListener != null) {
                flingListener.onFlingLeft();   // 向左滑
            } else if (diffX < 0 && flingListener != null) {
                flingListener.onFlingRight();  // 向右滑
            }
            return true;
        }
        return false;
    }

    // 其他必要介面方法保持預設實作
    @Override public boolean onDown(MotionEvent e) { return false; }
    @Override public void onLongPress(MotionEvent e) {}
    @Override public boolean onScroll(MotionEvent e1, MotionEvent e2, float dX, float dY) { return false; }
    @Override public void onShowPress(MotionEvent e) {}
    @Override public boolean onSingleTapUp(MotionEvent e) { return false; }
}

Activity 整合範例

public class MainActivity extends Activity {
    private GestureHelper gestureHelper;

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

        gestureHelper = new GestureHelper(this);
        gestureHelper.setOnFlingListener(new GestureHelper.OnFlingListener() {
            @Override public void onFlingLeft()  { /* 切換至下一頁 */ }
            @Override public void onFlingRight() { /* 切換至上一頁 */ }
        });
    }

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

參數調校建議

  • MIN_DISTANCE:預設螢幕寬 1/3,可依 UI 密度調整;
  • MIN_VELOCITY:200 px/s 過濾緩慢拖曳,避免誤觸;
  • 若需支援上下滑動,擴充 OnFlingListener 增加 onFlingUp/Down 並檢測 velocityY。
copyright © 萬盛學電腦網 all rights reserved