Android में स्वाइप डायरेक्शन (बाएं/दाएं, ऊपर/नीचे) कैसे डिटेक्ट करें?

परिचय

यह ट्यूटोरियल दर्शाता है कि Android में स्वाइप जेस्चर (बाएं, दाएं, ऊपर, नीचे) कैसे डिटेक्ट करें। हम GestureDetector और कस्टम OnTouchListener का उपयोग करेंगे।

आवश्यक चरण

चरण 1: नया प्रोजेक्ट बनाएं

Android Studio में File → New Project से नया प्रोजेक्ट बनाएं।

चरण 2: लेआउट फ़ाइल (res/layout/activity_main.xml)

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:id="@+id/relativeLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="स्वाइप करके जेस्चर डिटेक्ट करें"
        android:textSize="24sp"
        android:textStyle="bold" />

</RelativeLayout>

चरण 3: मुख्य गतिविधि (src/MainActivity.java)

import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.os.Bundle;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.view.View;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    OnSwipeTouchListener onSwipeTouchListener;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // लिस्टनर को रूट व्यू से अटैच करें
        onSwipeTouchListener = new OnSwipeTouchListener(this, findViewById(R.id.relativeLayout));
    }

    // स्वाइप डिटेक्शन के लिए कस्टम टच लिस्टनर
    public static class OnSwipeTouchListener implements View.OnTouchListener {
        private final GestureDetector gestureDetector;
        Context context;

        OnSwipeTouchListener(Context ctx, View mainView) {
            gestureDetector = new GestureDetector(ctx, new GestureListener());
            mainView.setOnTouchListener(this);
            context = ctx;
        }

        @Override
        public boolean onTouch(View v, MotionEvent event) {
            return gestureDetector.onTouchEvent(event);
        }

        private final class GestureListener extends GestureDetector.SimpleOnGestureListener {
            private static final int SWIPE_THRESHOLD = 100;           // न्यूनतम दूरी (पिक्सेल)
            private static final int SWIPE_VELOCITY_THRESHOLD = 100;  // न्यूनतम वेग

            @Override
            public boolean onDown(MotionEvent e) {
                return true; // जेस्चर शुरू होने दें
            }

            @Override
            public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
                boolean result = false;
                try {
                    float diffY = e2.getY() - e1.getY();
                    float diffX = e2.getX() - e1.getX();

                    // क्षैतिज स्वाइप (बाएं/दाएं)
                    if (Math.abs(diffX) > Math.abs(diffY)) {
                        if (Math.abs(diffX) > SWIPE_THRESHOLD && Math.abs(velocityX) > SWIPE_VELOCITY_THRESHOLD) {
                            if (diffX > 0) {
                                onSwipeRight();
                            } else {
                                onSwipeLeft();
                            }
                            result = true;
                        }
                    }
                    // लंबवत स्वाइप (ऊपर/नीचे)
                    else if (Math.abs(diffY) > SWIPE_THRESHOLD && Math.abs(velocityY) > SWIPE_VELOCITY_THRESHOLD) {
                        if (diffY > 0) {
                            onSwipeBottom();
                        } else {
                            onSwipeTop();
                        }
                        result = true;
                    }
                } catch (Exception exception) {
                    exception.printStackTrace();
                }
                return result;
            }
        }

        // कॉलबैक मेथड्स - इन्हें ओवरराइड करें
        void onSwipeRight() {
            Toast.makeText(context, "दाएं स्वाइप किया", Toast.LENGTH_SHORT).show();
        }
        void onSwipeLeft() {
            Toast.makeText(context, "बाएं स्वाइप किया", Toast.LENGTH_SHORT).show();
        }
        void onSwipeTop() {
            Toast.makeText(context, "ऊपर स्वाइप किया", Toast.LENGTH_SHORT).show();
        }
        void onSwipeBottom() {
            Toast.makeText(context, "नीचे स्वाइप किया", Toast.LENGTH_SHORT).show();
        }
    }
}

चरण 4: मैनिफेस्ट फ़ाइल (AndroidManifest.xml)

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.com.sample">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

ऐप चलाएं

डिवाइस कनेक्ट करें, Run क्लिक करें। स्क्रीन पर किसी भी दिशा में स्वाइप करें - टोस्ट मैसेज दिखाएगा कि कौन सी दिशा डिटेक्ट हुई।

महत्वपूर्ण बिंदु

• SWIPE_THRESHOLD - न्यूनतम स्वाइप दूरी (पिक्सेल में)। छोटा = अधिक संवेदनशील।
• SWIPE_VELOCITY_THRESHOLD - न्यूनतम स्वाइप गति। तेज स्वाइप ही मान्य होंगे।
• onDown() में true रिटर्न करना आवश्यक है ताकि फ्लिंग इवेंट मिले।
• यह क्लास रीयूजेबल है - किसी भी व्यू पर `setOnTouchListener(new OnSwipeTouchListener(...))` लगाएं।
• आधुनिक विकल्प: GestureDetectorCompat या Jetpack Compose में pointerInput / detectDragGestures।