タップ操作は、ユーザーが 1 本以上の指をタッチスクリーンに置き、アプリがこのタップパターンをジェスチャーとして解釈したときに発生します。ジェスチャー検出には、次の 2 つのフェーズがあります。
- タッチイベント データを収集しています。
- データを解釈して、アプリがサポートする操作の条件を満たしているかどうかを判断する。
AndroidX クラス
このドキュメントの例では、GestureDetectorCompat
クラスと MotionEventCompat
クラスを使用しています。これらのクラスは AndroidX ライブラリに含まれています。以前のデバイスとの互換性を提供するため、可能であれば AndroidX クラスを使用してください。
MotionEventCompat
は MotionEvent
クラスに代わるものではありません。代わりに、MotionEvent
オブジェクトを渡して、そのイベントに関連付けられたアクションを受け取る静的ユーティリティ メソッドを提供します。
データを収集する
ユーザーが画面に 1 本以上の指を置くと、タッチイベントを受け取るビューでコールバック onTouchEvent()
がトリガーされます。位置、圧力、サイズ、指の追加など、一連のタップイベントがジェスチャーとして認識されると、onTouchEvent()
が複数回呼び出されます。
操作は、ユーザーが最初に画面に触れたときに開始し、その後 1 つまたは複数の指の位置をシステムが追跡する間続行され、最後の指が画面から離れる最後のイベントをキャプチャすることで終了します。このインタラクション全体を通じて、onTouchEvent()
に配信される MotionEvent
から各インタラクションの詳細が提供されます。アプリは、MotionEvent
が提供するデータを使用して、対象の操作が行われるかどうかを判断できます。
Activity または View のタップイベントをキャプチャする
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) } } }
Java
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()
の代わりに、setOnTouchListener()
メソッドを使用して View.OnTouchListener
オブジェクトを任意の View
オブジェクトにアタッチすることもできます。これにより、次の例に示すように、既存の View
をサブクラス化せずにタッチイベントをリッスンできます。
Kotlin
findViewById<View>(R.id.my_view).setOnTouchListener { v, event -> // Respond to touch events. true }
Java
View myView = findViewById(R.id.my_view); myView.setOnTouchListener(new OnTouchListener() { public boolean onTouch(View v, MotionEvent event) { // Respond to touch events. return true; } });
ACTION_DOWN
イベントに対して false
を返すリスナーを作成してください。これを行うと、後続の ACTION_MOVE
および ACTION_UP
イベント シーケンスでリスナーは呼び出されません。これは、ACTION_DOWN
がすべてのタッチイベントの開始点であるためです。
カスタムビューを作成する場合は、前述のように onTouchEvent()
をオーバーライドできます。
操作の検出
Android には、一般的な操作を検出するための GestureDetector
クラスが用意されています。サポートされている操作には、onDown()
、onLongPress()
、onFling()
などがあります。
GestureDetector
は、前述の onTouchEvent()
メソッドと組み合わせて使用できます。
サポートされている操作をすべて検出する
GestureDetectorCompat
オブジェクトをインスタンス化するときに受け取るパラメータの 1 つが、GestureDetector.OnGestureListener
インターフェースを実装するクラスです。GestureDetector.OnGestureListener
は、特定のタッチイベントが発生するとユーザーに通知します。GestureDetector
オブジェクトがイベントを受信できるようにするには、ビューまたはアクティビティの onTouchEvent()
メソッドをオーバーライドし、観測されたすべてのイベントを検出器インスタンスに渡します。
次のスニペットでは、個々の on<TouchEvent>
メソッドからの true
の戻り値は、タッチイベントが処理されたことを示しています。戻り値 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 } }
Java
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
のどちらを使用する場合でも、true
を返す onDown()
メソッドを実装することをおすすめします。これは、すべてのジェスチャーが onDown()
メッセージで始まるためです。onDown()
から false
を返すと、GestureDetector.SimpleOnGestureListener
のデフォルトのように、システムは操作の残りの部分を無視すると想定し、GestureDetector.OnGestureListener
の他のメソッドは呼び出されません。これにより、アプリで予期しない問題が発生する可能性があります。操作全体を無視する場合は、onDown()
から false
のみを返します。
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 } } }
Java
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; } } }