【Android】ホームボタンの押下を検知する方法｜onUserLeaveHint()の実装手順を解説

はじめに：Androidでホームボタンは「上書き」できるのか？

結論から言うと、Androidではセキュリティ上の設計思想により、ホームボタンの動作そのものを完全に無効化したり乗っ取ったりすることはできません。これは、ユーザーがいつでもアプリから抜けられるようにするためのGoogleの意図的な仕様です。

しかし、onUserLeaveHint()というコールバックメソッドを利用すれば、「ユーザーがホームボタンを押してアプリを離れようとした瞬間」を検知することは可能です。本記事では、ホームボタンが押されたタイミングでToastメッセージを表示するサンプルアプリの作成手順を、ステップごとにわかりやすく解説していきます。

Step 1：新規プロジェクトを作成する

Android Studioを起動し、メニューから「File → New Project」を選択して新しいプロジェクトを作成します。プロジェクト名やパッケージ名など、必要な項目を入力してセットアップを完了させてください。

Step 2：レイアウトファイル（activity_main.xml）を編集する

res/layout/activity_main.xml に以下のコードを追加します。画面中央に「Press Home Button」というテキストを配置した、シンプルなレイアウトです。

<?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:text="Press Home Button"
        android:textSize="16sp"
        android:textStyle="bold"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerInParent="true"/>
</RelativeLayout>

Step 3：MainActivity.java を実装する

src/MainActivity.java に以下のコードを記述します。注目すべきはonUserLeaveHint()メソッドです。このメソッドは、ユーザーがホームボタンを押すなどの操作によってアクティビティを離れる直前に、システムから自動的に呼び出されます。

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    @Override
    protected void onUserLeaveHint(){
        Toast.makeText(getApplicationContext(), "Home Button is Pressed", Toast.LENGTH_SHORT).show();
        super.onUserLeaveHint();
    }
}

ここでは、ホームボタンが押されたことをToastで通知しています。なお、onUserLeaveHint()は最近使用したアプリボタンや別アプリへの切り替え時にも呼び出されるため、厳密には「ホームボタン専用の検知」ではない点に注意してください。

Step 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スマートフォンをPCに接続し、Android Studioでプロジェクト内の任意のアクティビティファイルを開いた状態で、ツールバーの「Run」アイコンをクリックします。実行デバイスとして接続した端末を選択すると、アプリが起動し、以下のような初期画面が表示されます。

この状態でホームボタンを押すと、画面下部に「Home Button is Pressed」というToastメッセージが表示されます。これで、ホームボタンの押下を正しく検知できていることが確認できます。

まとめ

Androidではホームボタンの挙動そのものを書き換えることはできませんが、onUserLeaveHint()を活用すれば「ユーザーがアプリを離れたこと」を確実に検知できます。ゲーム中の一時停止処理や、アプリ離脱前のデータ自動保存など、幅広い場面で役立つテクニックなので、ぜひ実装方法をマスターしておきましょう。