Computer >> 컴퓨터 >  >> 프로그래밍 >> Android

안드로이드 앱에서 플링(Fling) 제스처 감지 구현하기 – 단계별 완벽 가이드

플링 제스처 감지란?

이 튜토리얼에서는 안드로이드 앱에서 플링(fling) 제스처 감지를 구현하는 방법을 단계별로 알아봅니다. 플링이란 사용자가 화면을 빠르게 쓸어 넘기는 스와이프 동작을 말하며, 이미지 갤러리 넘기기, 리스트 새로고침, 페이지 전환 등 다양한 UI에서 활용됩니다.

안드로이드에서는 GestureDetector 클래스와 SimpleOnGestureListener를 사용하면 복잡한 터치 계산 없이도 플링 제스처를 손쉽게 감지할 수 있습니다.

1단계: 새 프로젝트 만들기

Android Studio를 실행한 후 File → New Project를 선택하고, 프로젝트 생성에 필요한 모든 정보를 입력하여 새 프로젝트를 만듭니다.

2단계: 레이아웃 작성 (activity_main.xml)

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다. 화면 중앙에 "Swipe the screen"(화면을 스와이프하세요)이라는 안내 문구가 표시되는 간단한 레이아웃입니다.

<?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"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"
        android:text="Swipe the screen"
        android:textStyle="bold"/>
</RelativeLayout>

3단계: MainActivity.java 작성

src/MainActivity.java 파일에 다음 코드를 추가합니다. 이 코드가 플링 제스처 감지의 핵심 부분입니다.

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.GestureDetector;
import android.view.MotionEvent;
import android.widget.Toast;
public class MainActivity extends AppCompatActivity {
    GestureDetector gestureDetector;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        gestureDetector = new GestureDetector(this, new GestureListener());
    }
    private class GestureListener extends GestureDetector.SimpleOnGestureListener {
        @Override
        public boolean onFling(MotionEvent e1, MotionEvent e2, float velocityX, float velocityY) {
            Toast.makeText(MainActivity.this, "Fling", Toast.LENGTH_SHORT).show();
            return super.onFling(e1, e2, velocityX, velocityY);
        }
    }
    @Override
    public boolean onTouchEvent(MotionEvent event) {
        gestureDetector.onTouchEvent(event);
        return super.onTouchEvent(event);
    }
}

코드 핵심 설명

  • GestureDetector: 사용자의 터치 이벤트를 분석하여 탭, 롱프레스, 플링 등의 제스처를 자동으로 판별해 주는 클래스입니다.
  • SimpleOnGestureListener: 필요한 콜백만 오버라이드하면 되는 편리한 리스너 클래스입니다. 여기서는 onFling()만 재정의했습니다.
  • onFling(e1, e2, velocityX, velocityY): 플링이 감지되면 호출됩니다. e1은 터치 시작 지점, e2는 종료 지점이며, velocityX와 velocityY는 각각 X축과 Y축 방향의 이동 속도(초당 픽셀)입니다. 이 값을 활용하면 스와이프 방향까지 판별할 수 있습니다.
  • onTouchEvent() 오버라이드: 액티비티에서 발생하는 모든 터치 이벤트를 gestureDetector에 전달해야 제스처 인식이 정상적으로 동작합니다.

참고: 최신 Android Studio 버전에서는 서포트 라이브러리 대신 AndroidX를 사용하므로, import 문을 androidx.appcompat.app.AppCompatActivity로 변경하면 됩니다.

4단계: AndroidManifest.xml 설정

androidManifest.xml 파일에 아래 코드를 추가합니다. 특별한 권한은 필요하지 않으며, MainActivity가 런처 액티비티로 등록되어 있는지만 확인하면 됩니다.

<?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>

앱 실행 및 결과 확인

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기를 컴퓨터에 연결했다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 연 뒤 툴바의 Run(실행) 아이콘을 클릭하고, 옵션 목록에서 자신의 모바일 기기를 선택합니다.

앱이 실행되면 기본 화면이 표시되며, 화면을 빠르게 스와이프(플링)할 때마다 "Fling"이라는 토스트 메시지가 나타나는 것을 확인할 수 있습니다.

안드로이드 앱에서 플링(Fling) 제스처 감지 구현하기 – 단계별 완벽 가이드