안드로이드 앱에서 흔들기 제스처로 새로고침하는 기능 구현 방법

이 튜토리얼에서는 안드로이드 앱에서 휴대폰을 흔들면 화면을 새로고침하는 기능을 구현하는 방법을 단계별로 알아봅니다. 가속도 센서(Accelerometer)를 활용해 흔들기 동작을 감지하고, 이를 원하는 기능과 연결할 수 있습니다.

1단계: 새 프로젝트 생성

Android Studio를 실행한 후 File → New Project 메뉴로 이동하여 새 프로젝트를 생성합니다. 필요한 모든 세부 정보를 입력하고 프로젝트 설정을 완료하세요.

2단계: 레이아웃 파일 작성 (res/layout/activity_main.xml)

아래 코드를 activity_main.xml 파일에 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp"
    android:orientation="vertical" >
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="24sp"
        android:textStyle="bold"
        android:text="Shake your phone to detect shake Feature...."/>
</LinearLayout>

레이아웃은 간단한 LinearLayout 구조로, 흔들기 기능을 안내하는 TextView 하나만 포함되어 있습니다.

3단계: 메인 액티비티 코드 작성 (src/MainActivity.java)

가속도 센서를 등록하고 흔들기 동작을 감지하는 핵심 로직입니다. 아래 코드를 MainActivity.java에 추가하세요.

import android.content.Context;
import android.hardware.Sensor;
import android.hardware.SensorEvent;
import android.hardware.SensorEventListener;
import android.hardware.SensorManager;
import android.os.Bundle;
import android.widget.Toast;
import java.util.Objects;
import androidx.appcompat.app.AppCompatActivity;
public class MainActivity extends AppCompatActivity {
    private SensorManager sensorManager;
    private float mAccel;
    private float mAccelCurrent;
    private float mAccelLast;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
        Objects.requireNonNull(sensorManager).registerListener(mSensorListener,
                sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER), SensorManager.SENSOR_DELAY_NORMAL);
        mAccel = 10f;
        mAccelCurrent = SensorManager.GRAVITY_EARTH;
        mAccelLast = SensorManager.GRAVITY_EARTH;
    }
    private final SensorEventListener mSensorListener = new SensorEventListener() {
        public void onSensorChanged(SensorEvent se) {
            float x = se.values[0];
            float y = se.values[1];
            float z = se.values[2];
            mAccelLast = mAccelCurrent;
            mAccelCurrent = (float) Math.sqrt((double) (x * x + y * y + z * z));
            float delta = mAccelCurrent - mAccelLast;
            mAccel = mAccel * 0.9f + delta;
            if (mAccel > 12) {
                Toast toast = Toast.makeText(getApplicationContext(), "Shake feature detected..",
                        Toast.LENGTH_LONG);
                toast.show();
            }
        }
        public void onAccuracyChanged(Sensor sensor, int accuracy) {
        }
    };
    @Override
    protected void onResume() {
        super.onResume();
        sensorManager.registerListener(mSensorListener,
                sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER), SensorManager.SENSOR_DELAY_NORMAL);
    }
    @Override
    protected void onPause() {
        sensorManager.unregisterListener(mSensorListener);
        super.onPause();
    }
}

코드 핵심 설명

흔들기 감지의 핵심 원리는 다음과 같습니다.

① 센서 값 계산: X, Y, Z 축의 가속도 값을 이용해 현재 가속도 크기를 피타고라스 정리(√(x² + y² + z²))로 계산합니다.

② 변화량 필터링: 이전 값과 현재 값의 차이(delta)를 구하고, 저역 통과 필터 역할을 하는 mAccel = mAccel * 0.9f + delta 공식으로 노이즈를 줄입니다.

③ 임계값 판정: 가속도 변화량이 12를 초과하면 흔들기로 판단하여 토스트 메시지를 표시합니다. 실제 새로고침 기능을 연결하려면 이 부분에 원하는 코드를 작성하면 됩니다.

④ 생명주기 관리: onResume()에서 리스너를 등록하고 onPause()에서 해제하여 배터리 소모를 최소화합니다.

4단계: 매니페스트 확인 (androidManifest.xml)

아래는 참고용 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>

가속도 센서 사용에는 별도의 권한 선언이 필요하지 않으므로, 일반적인 매니페스트 설정만으로 충분합니다.

앱 실행 및 테스트

이제 애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 열고 툴바의 Run ▶ 버튼을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면 기기에 앱이 설치되어 실행됩니다.

앱이 실행되면 기본 화면이 표시됩니다. 이제 휴대폰을 실제로 흔들어 보세요! 흔들기 동작이 감지되면 "Shake feature detected.."라는 토스트 메시지가 나타납니다.

실제 기기에서 직접 테스트해 보는 것이 가장 좋은 결과를 얻는 방법입니다. 에뮬레이터는 가속도 센서 시뮬레이션이 제한적일 수 있으므로, 가능하다면 실제 스마트폰으로 확인하는 것을 권장합니다.