專案需求:左右滑動切換頁面。為避免在每個 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; }
}
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。