개요
이 튜토리얼에서는 안드로이드 앱에서 화면상의 특정 위치(X, Y 좌표)에서 발생하는 터치 이벤트를 감지하고, 터치의 종류(누름·이동·떼기)에 따라 다르게 처리하는 방법을 단계별로 살펴봅니다. 핵심은 MotionEvent 객체와 onTouchEvent() 콜백 메서드입니다.
1단계 — 새 프로젝트 만들기
안드로이드 스튜디오를 실행한 뒤 File ⇒ New Project를 선택하여 새 프로젝트를 생성합니다. 프로젝트 생성에 필요한 모든 정보를 입력하고 빈 Activity 템플릿으로 진행하세요.
2단계 — 레이아웃 작성 (res/layout/activity_main.xml)
메인 레이아웃 파일에 아래 코드를 추가합니다. 이 예제에서는 별도의 위젯 없이 화면 전체에서 터치를 받을 수 있도록 RelativeLayout만 사용합니다.
<?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:layout_width="match_parent" android:layout_height="match_parent" android:padding="4dp" tools:context=".MainActivity"> </RelativeLayout>
3단계 — 터치 이벤트 처리 코드 작성 (src/MainActivity.java)
액티비티에서 onTouchEvent(MotionEvent event)를 오버라이드하면 사용자가 화면을 터치할 때마다 해당 메서드가 호출됩니다. 여기서 터치 좌표와 액션 타입을 읽어 Toast로 출력합니다.
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.MotionEvent;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
private boolean isTouch = false;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
@Override
public boolean onTouchEvent(MotionEvent event) {
int X = (int) event.getX();
int Y = (int) event.getY();
int eventAction = event.getAction();
switch (eventAction) {
case MotionEvent.ACTION_DOWN:
// 화면을 처음 누른 순간
Toast.makeText(this, "ACTION_DOWN " + "X: " + X + " Y: " + Y,
Toast.LENGTH_SHORT).show();
isTouch = true;
break;
case MotionEvent.ACTION_MOVE:
// 손가락을 누른 상태로 움직일 때
Toast.makeText(this, "MOVE " + "X: " + X + " Y: " + Y,
Toast.LENGTH_SHORT).show();
break;
case MotionEvent.ACTION_UP:
// 화면에서 손가락을 뗀 순간
Toast.makeText(this, "ACTION_UP " + "X: " + X + " Y: " + Y,
Toast.LENGTH_SHORT).show();
break;
}
return true;
}
}주요 포인트:
event.getX(),event.getY(): 현재 터치 지점의 X, Y 좌표(px)를 반환합니다.ACTION_DOWN: 터치가 시작되는 순간ACTION_MOVE: 터치 중 손가락이 이동하는 동안 반복적으로 호출ACTION_UP: 터치가 끝나는 순간- 최신 프로젝트에서는
android.support.v7.app.AppCompatActivity대신 AndroidX의androidx.appcompat.app.AppCompatActivity를 사용하는 것이 좋습니다.
4단계 — 매니페스트 확인 (androidManifest.xml)
매니페스트 파일은 기본 설정 그대로 사용하면 됩니다. MainActivity가 LAUNCHER 인텐트 필터로 등록되어 있는지만 확인하세요.
<?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 버튼을 클릭하고, 목록에서 자신의 모바일 기기를 선택하세요. 앱이 실행되면 화면을 터치하거나 드래그할 때마다 터치 액션과 함께 해당 지점의 X, Y 좌표가 Toast 메시지로 표시되는 것을 확인할 수 있습니다.
추가 팁 — 실제로 터치를 주입하는 방법
위 예제는 터치 이벤트를 감지·처리하는 방법입니다. 반대로 코드나 명령어로 특정 좌표에 터치를 주입(simulate)하고 싶다면 다음 방법들을 활용할 수 있습니다.
- ADB 명령어:
adb shell input tap X Y로 지정한 좌표에 탭 이벤트를 전송할 수 있습니다. - Instrumentation: 테스트 코드에서
Instrumentation.sendPointerSync()를 사용해 프로그래매틱하게 터치 이벤트를 생성할 수 있습니다. - dispatchTouchEvent(): 액티비티 내부에서 직접 MotionEvent 객체를 만들어 전달하면 UI 테스트나 데모 구현에 유용합니다.
이처럼 MotionEvent의 액션 타입과 좌표 정보를 활용하면 다양한 제스처 기반 인터랙션(스와이프, 드래그, 커스텀 버튼 등)을 손쉽게 구현할 수 있습니다.