ব্যবহারকারী টাচস্ক্রিনে এক বা একাধিক আঙ্গুল রাখলে টাচ জেসচার হয় এবং আপনার অ্যাপ এই প্যাটার্নকে জেসচার হিসেবে ইন্টারপ্রেট করে। জেসচার শনাক্তকরণের দুটি পর্যায় আছে:
- টাচ ইভেন্ট ডেটা সংগ্রহ করা হচ্ছে।
- আপনার অ্যাপে কাজ করে এমন জেসচারের মাপকাঠি পূরণ করছে কিনা তা নির্ধারণ করতে ডেটা বিশ্লেষণ করা।
AndroidX ক্লাস
এই ডকুমেন্টের উদাহরণে
GestureDetectorCompat
এবং
MotionEventCompat
ক্লাস ব্যবহার করা হয়েছে। এই ক্লাসগুলি AndroidX
লাইব্রেরি-তে রয়েছে। আগের ডিভাইসগুলির সাথে মানানসই হওয়ার জন্য যেখানে সম্ভব সেখানে AndroidX ক্লাস ব্যবহার করুন।
MotionEventCompat হল
MotionEvent
ক্লাসের বিকল্প নয়। বরং, এটি স্ট্যাটিক ইউটিলিটি পদ্ধতি প্রদান করে, যেখানে আপনি সেই
ইভেন্টের সাথে যুক্ত অ্যাকশন পেতে আপনার
MotionEvent অবজেক্ট পাস করেন।
ডেটা সংগ্রহ করা
ব্যবহারকারী স্ক্রিনে এক বা একাধিক আঙুল রাখলে, এটি টাচ ইভেন্ট গ্রহণকারী ভিউতে
কলব্যাক
onTouchEvent()
ট্রিগার করে। টাচ ইভেন্টের প্রতিটি সিকোয়েন্সের জন্য—যেমন পজিশন, প্রেসার, সাইজ এবং অন্য আঙুল যোগ করা—যা জেসচার হিসেবে শনাক্ত করা হয়, onTouchEvent() বেশ কয়েকবার ফায়ার করা হয়।
ব্যবহারকারী প্রথমবার স্ক্রিন স্পর্শ করলে জেসচার শুরু হয়, ব্যবহারকারীর আঙুল বা আঙুলগুলির পজিশন সিস্টেম ট্র্যাক করার সাথে সাথে তা চলতে থাকে এবং ব্যবহারকারীর শেষ আঙুল স্ক্রিন ছেড়ে যাওয়ার
ফাইনাল ইভেন্ট ক্যাপচার করার মাধ্যমে শেষ হয়।
এই ইন্টার্যাকশন জুড়ে, MotionEvent-এ দেওয়া
onTouchEvent() প্রতিটি ইন্টার্যাকশনের বিবরণ প্রদান করে। MotionEvent-এর দেওয়া ডেটা ব্যবহার করে আপনার অ্যাপ
নির্ধারণ করতে পারে যে সেটি
যে জেসচার সম্পর্কে আগ্রহী সেটি ঘটেছে কিনা।
কোনও অ্যাক্টিভিটি বা ভিউয়ের জন্য টাচ ইভেন্ট ক্যাপচার করুন
Activity বা
View-এ টাচ ইভেন্ট ইন্টারসেপ্ট করতে, onTouchEvent() কলব্যাক ওভাররাইড করুন।
নিচের কোড স্নিপেটটি
getAction()
ব্যবহার করে event প্যারামিটার থেকে ব্যবহারকারীর করা অ্যাকশন এক্সট্র্যাক্ট করে।
এটি আপনাকে সেই র ডেটা দেয় যা আপনার পছন্দের কোনও জেসচার হয়েছে কিনা তা নির্ধারণ করতে প্রয়োজন।
Kotlin
class MainActivity : Activity() { ... // This example shows an Activity. You can use the same approach if you are // subclassing a View. override fun onTouchEvent(event: MotionEvent): Boolean { return when (event.action) { MotionEvent.ACTION_DOWN -> { Log.d(DEBUG_TAG, "Action was DOWN") true } MotionEvent.ACTION_MOVE -> { Log.d(DEBUG_TAG, "Action was MOVE") true } MotionEvent.ACTION_UP -> { Log.d(DEBUG_TAG, "Action was UP") true } MotionEvent.ACTION_CANCEL -> { Log.d(DEBUG_TAG, "Action was CANCEL") true } MotionEvent.ACTION_OUTSIDE -> { Log.d(DEBUG_TAG, "Movement occurred outside bounds of current screen element") true } else -> super.onTouchEvent(event) } } }
জাভা
public class MainActivity extends Activity { ... // This example shows an Activity. You can use the same approach if you are // subclassing a View. @Override public boolean onTouchEvent(MotionEvent event){ switch(event.getAction()) { case (MotionEvent.ACTION_DOWN) : Log.d(DEBUG_TAG,"Action was DOWN"); return true; case (MotionEvent.ACTION_MOVE) : Log.d(DEBUG_TAG,"Action was MOVE"); return true; case (MotionEvent.ACTION_UP) : Log.d(DEBUG_TAG,"Action was UP"); return true; case (MotionEvent.ACTION_CANCEL) : Log.d(DEBUG_TAG,"Action was CANCEL"); return true; case (MotionEvent.ACTION_OUTSIDE) : Log.d(DEBUG_TAG,"Movement occurred outside bounds of current screen element"); return true; default : return super.onTouchEvent(event); } }
ব্যবহারকারী ট্যাপ, টাচ ও হোল্ড এবং টেনে আনার সময় এই কোড Logcat-এ নিম্নলিখিত মেসেজ তৈরি করে:
GESTURES D Action was DOWN GESTURES D Action was UP GESTURES D Action was MOVE
কাস্টম জেসচারের জন্য, আপনি তারপরে এইসব ইভেন্ট নিয়ে নিজের প্রসেসিং করতে পারবেন যাতে
নির্ধারণ করা যায় যে সেগুলি এমন কোনও জেসচারকে প্রতিনিধিত্ব করে কিনা যা আপনাকে ম্যানেজ করতে হবে। তবে, আপনার
অ্যাপ যদি ডবল ট্যাপ, টাচ করে ধরে রাখা, ফ্লিং ইত্যাদি সাধারণ জেসচার ব্যবহার করে,
তাহলে আপনি
GestureDetector
ক্লাসের সুবিধা নিতে পারবেন। GestureDetector আপনাকে সাধারণ
জেসচার শনাক্ত করতে সাহায্য করে, এর জন্য আপনাকে আলাদা আলাদা টাচ ইভেন্ট প্রসেস করতে হয় না। জেসচার শনাক্ত করা নিবন্ধে
এই বিষয়ে আরও আলোচনা করা হয়েছে।
একটি ভিউয়ের জন্য টাচ ইভেন্ট ক্যাপচার করুন
onTouchEvent()-এর বিকল্প হিসেবে, আপনি
View.OnTouchListener
পদ্ধতি ব্যবহার করে যেকোনও View
অবজেক্টের সাথে কোনও
setOnTouchListener()
অবজেক্ট অ্যাটাচ করতে পারবেন। এর ফলে, নিম্নলিখিত উদাহরণে দেখানো হয়েছে যে, আগে থেকে থাকা View-এর সাবক্লাস না বানিয়েই টাচ ইভেন্ট শোনা সম্ভব হয়:
Kotlin
findViewById<View>(R.id.my_view).setOnTouchListener { v, event -> // Respond to touch events. true }
জাভা
View myView = findViewById(R.id.my_view); myView.setOnTouchListener(new OnTouchListener() { public boolean onTouch(View v, MotionEvent event) { // Respond to touch events. return true; } });
false রিটার্ন করে এমন লিসনার তৈরি করা থেকে সাবধান থাকুন
ACTION_DOWN ইভেন্ট।
আপনি এটি করলে, পরবর্তী
ACTION_MOVE এবং
ACTION_UP ইভেন্টের
ক্রমের জন্য লিসনারকে কল করা হয় না। এর কারণ হল, ACTION_DOWN হল সব
টাচ ইভেন্টের শুরুর পয়েন্ট।
আপনি কাস্টম ভিউ তৈরি করলে, আগে যেভাবে বর্ণনা করা হয়েছে সেইভাবে
onTouchEvent() ওভাররাইড করতে পারবেন।
জেসচার শনাক্ত করা
Android সাধারণ জেসচার শনাক্ত করার জন্য GestureDetector ক্লাস প্রদান করে। এটি যেসব জেসচার ব্যবহার করতে দেয় তার মধ্যে রয়েছে
onDown(),
onLongPress(),
এবং
onFling()।
আগে বর্ণিত onTouchEvent() পদ্ধতির সাথে আপনি GestureDetector ব্যবহার করতে পারেন।
কাজ করে এমন সব জেসচার শনাক্ত করুন
আপনি যখন GestureDetectorCompat অবজেক্ট ইনস্ট্যান্টিয়েট করেন, তখন এটি যে প্যারামিটারগুলি নেয় তার মধ্যে একটি হল এমন একটি ক্লাস যা
GestureDetector.OnGestureListener
ইন্টারফেস প্রয়োগ করে। নির্দিষ্ট কোনও টাচ ইভেন্ট ঘটলে
GestureDetector.OnGestureListener ব্যবহারকারীদের বিজ্ঞপ্তি পাঠায়। আপনার
GestureDetector অবজেক্ট যাতে ইভেন্ট পেতে পারে, তার জন্য ভিউ বা
অ্যাক্টিভিটির onTouchEvent() মেথড ওভাররাইড করুন এবং ডিটেক্টর ইনস্ট্যান্সকে
সব পর্যবেক্ষণ করা ইভেন্ট পাস করুন।
নিচের স্নিপেটে, true রিটার্ন ভ্যালু
ইন্ডিভিজুয়াল on<TouchEvent> পদ্ধতি থেকে পাওয়া যায়, এটি ইঙ্গিত করে যে
টাচ ইভেন্ট হ্যান্ডেল করা হয়েছে। false-এর রিটার্ন ভ্যালু ভিউ স্ট্যাকের মাধ্যমে ইভেন্ট পাস করে
যতক্ষণ না টাচ সঠিকভাবে ম্যানেজ করা হচ্ছে।
আপনি যদি কোনও টেস্ট অ্যাপে নিম্নলিখিত স্নিপেটটি চালান, তাহলে আপনি বুঝতে পারবেন যে কীভাবে টাচ স্ক্রিনের সাথে ইন্টার্যাক্ট করার সময়
অ্যাকশন ট্রিগার হয় এবং প্রতিটি টাচ ইভেন্টের জন্য MotionEvent-এর
কন্টেন্ট কী হয়। তারপর আপনি দেখতে পাবেন যে
সাধারণ ইন্টার্যাকশনের জন্য কত ডেটা তৈরি হচ্ছে।
Kotlin
private const val DEBUG_TAG = "Gestures" class MainActivity : Activity(), GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener { private lateinit var mDetector: GestureDetectorCompat // Called when the activity is first created. public override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) // Instantiate the gesture detector with the // application context and an implementation of // GestureDetector.OnGestureListener. mDetector = GestureDetectorCompat(this, this) // Set the gesture detector as the double-tap // listener. mDetector.setOnDoubleTapListener(this) } override fun onTouchEvent(event: MotionEvent): Boolean { return if (mDetector.onTouchEvent(event)) { true } else { super.onTouchEvent(event) } } override fun onDown(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDown: $event") return true } override fun onFling( event1: MotionEvent, event2: MotionEvent, velocityX: Float, velocityY: Float ): Boolean { Log.d(DEBUG_TAG, "onFling: $event1 $event2") return true } override fun onLongPress(event: MotionEvent) { Log.d(DEBUG_TAG, "onLongPress: $event") } override fun onScroll( event1: MotionEvent, event2: MotionEvent, distanceX: Float, distanceY: Float ): Boolean { Log.d(DEBUG_TAG, "onScroll: $event1 $event2") return true } override fun onShowPress(event: MotionEvent) { Log.d(DEBUG_TAG, "onShowPress: $event") } override fun onSingleTapUp(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onSingleTapUp: $event") return true } override fun onDoubleTap(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDoubleTap: $event") return true } override fun onDoubleTapEvent(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDoubleTapEvent: $event") return true } override fun onSingleTapConfirmed(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onSingleTapConfirmed: $event") return true } }
জাভা
public class MainActivity extends Activity implements GestureDetector.OnGestureListener, GestureDetector.OnDoubleTapListener{ private static final String DEBUG_TAG = "Gestures"; private GestureDetectorCompat mDetector; // Called when the activity is first created. @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Instantiate the gesture detector with the // application context and an implementation of // GestureDetector.OnGestureListener. mDetector = new GestureDetectorCompat(this,this); // Set the gesture detector as the double-tap // listener. mDetector.setOnDoubleTapListener(this); } @Override public boolean onTouchEvent(MotionEvent event){ if (this.mDetector.onTouchEvent(event)) { return true; } return super.onTouchEvent(event); } @Override public boolean onDown(MotionEvent event) { Log.d(DEBUG_TAG,"onDown: " + event.toString()); return true; } @Override public boolean onFling(MotionEvent event1, MotionEvent event2, float velocityX, float velocityY) { Log.d(DEBUG_TAG, "onFling: " + event1.toString() + event2.toString()); return true; } @Override public void onLongPress(MotionEvent event) { Log.d(DEBUG_TAG, "onLongPress: " + event.toString()); } @Override public boolean onScroll(MotionEvent event1, MotionEvent event2, float distanceX, float distanceY) { Log.d(DEBUG_TAG, "onScroll: " + event1.toString() + event2.toString()); return true; } @Override public void onShowPress(MotionEvent event) { Log.d(DEBUG_TAG, "onShowPress: " + event.toString()); } @Override public boolean onSingleTapUp(MotionEvent event) { Log.d(DEBUG_TAG, "onSingleTapUp: " + event.toString()); return true; } @Override public boolean onDoubleTap(MotionEvent event) { Log.d(DEBUG_TAG, "onDoubleTap: " + event.toString()); return true; } @Override public boolean onDoubleTapEvent(MotionEvent event) { Log.d(DEBUG_TAG, "onDoubleTapEvent: " + event.toString()); return true; } @Override public boolean onSingleTapConfirmed(MotionEvent event) { Log.d(DEBUG_TAG, "onSingleTapConfirmed: " + event.toString()); return true; } }
কাজ করে এমন জেসচারের সাবসেট শনাক্ত করা
আপনি যদি শুধুমাত্র কয়েকটি জেসচার প্রসেস করতে চান, তাহলে GestureDetector.OnGestureListener
ইন্টারফেস প্রয়োগ করার পরিবর্তে আপনি
GestureDetector.SimpleOnGestureListener
প্রয়োগ করতে পারেন।
GestureDetector.SimpleOnGestureListener সবকটি
on<TouchEvent> পদ্ধতির জন্য
false রিটার্ন করে
ইমপ্লিমেন্টেশন প্রদান করে। এর ফলে আপনি শুধুমাত্র সেইসব পদ্ধতি ওভাররাইড করতে পারবেন যেগুলি
আপনার কাছে গুরুত্বপূর্ণ। যেমন, নিম্নলিখিত কোড স্নিপেট এমন একটি ক্লাস তৈরি করে যা
GestureDetector.SimpleOnGestureListener এক্সটেন্ড করে এবং
onFling() ও onDown() ওভাররাইড করে।
আপনি GestureDetector.OnGestureListener বা
GestureDetector.SimpleOnGestureListener যাই ব্যবহার করুন না কেন, onDown() পদ্ধতি প্রয়োগ করা একটি পেশাদার পদ্ধতি যা true রিটার্ন করে।
এর কারণ হল, সব জেসচারই একটি onDown() মেসেজ দিয়ে শুরু হয়। আপনি যদি onDown() থেকে false-এ
ফেরেন, যেমন
GestureDetector.SimpleOnGestureListener ডিফল্ট হিসেবে করে, তাহলে সিস্টেম
ধরে নেয় যে আপনি জেসচারের বাকি অংশটি উপেক্ষা করতে চান এবং GestureDetector.OnGestureListener-এর
অন্যান্য পদ্ধতি কল করা হয় না। এর ফলে আপনার অ্যাপে
অপ্রত্যাশিত সমস্যা হতে পারে। আপনি সত্যিই কোনও সম্পূর্ণ জেসচার উপেক্ষা করতে চাইলে, তবেই false থেকে
onDown() রিটার্ন করুন।
Kotlin
private const val DEBUG_TAG = "Gestures" class MainActivity : Activity() { private lateinit var mDetector: GestureDetectorCompat public override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) mDetector = GestureDetectorCompat(this, MyGestureListener()) } override fun onTouchEvent(event: MotionEvent): Boolean { mDetector.onTouchEvent(event) return super.onTouchEvent(event) } private class MyGestureListener : GestureDetector.SimpleOnGestureListener() { override fun onDown(event: MotionEvent): Boolean { Log.d(DEBUG_TAG, "onDown: $event") return true } override fun onFling( event1: MotionEvent, event2: MotionEvent, velocityX: Float, velocityY: Float ): Boolean { Log.d(DEBUG_TAG, "onFling: $event1 $event2") return true } } }
জাভা
public class MainActivity extends Activity { private GestureDetectorCompat mDetector; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); mDetector = new GestureDetectorCompat(this, new MyGestureListener()); } @Override public boolean onTouchEvent(MotionEvent event){ if (this.mDetector.onTouchEvent(event)) { return true; } return super.onTouchEvent(event); } class MyGestureListener extends GestureDetector.SimpleOnGestureListener { private static final String DEBUG_TAG = "Gestures"; @Override public boolean onDown(MotionEvent event) { Log.d(DEBUG_TAG,"onDown: " + event.toString()); return true; } @Override public boolean onFling(MotionEvent event1, MotionEvent event2, float velocityX, float velocityY) { Log.d(DEBUG_TAG, "onFling: " + event1.toString() + event2.toString()); return true; } } }