Androidでバックグラウンドサービスを使って音量ボタンの操作を検知する方法

Androidでバックグラウンドサービスを使って音量ボタンの操作を検知する方法

本記事では、AndroidアプリにおいてContentObserverを活用し、バックグラウンド状態でも音量ボタン（音量アップ・ダウン）の操作を検知する方法を、実際のサンプルコードとともにステップ形式で解説します。

仕組みのポイント

Androidでは、音量キーの押下イベントを直接受け取るリスナーAPIが用意されていません。そこで、システムの音量設定が保存されているSettings.System.CONTENT_URIの変更をContentObserverで監視し、前回の音量値との差分から「音量が上がったか／下がったか」を判定するのが定番の実装手法です。

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

Android Studioを起動し、メニューから「File」→「New Project」を選択します。必要な項目をすべて入力して、新しいプロジェクトを作成しましょう。

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

res/layout/activity_main.xml に以下のコードを追加します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical"
    android:padding="16sp"
    tools:context=".MainActivity">
<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="30dp"
    android:text="Increase and decrease Volume"
    android:textSize="24sp"
    android:textStyle="bold" />
</LinearLayout>

手順3：MainActivity.java を実装する

src/MainActivity.java に以下のコードを記述します。ここでは SettingsContentObserver クラスを内部クラスとして定義し、音量の変化を検知したタイミングでToastメッセージを表示しています。

import androidx.appcompat.app.AppCompatActivity;
import android.content.Context;
import android.database.ContentObserver;
import android.media.AudioManager;
import android.os.Bundle;
import android.os.Handler;
import android.widget.Toast;
import java.util.Objects;
public class MainActivity extends AppCompatActivity {
    SettingsContentObserver settingsContentObserver;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        settingsContentObserver = new SettingsContentObserver(this, new Handler());
        getApplicationContext().getContentResolver().registerContentObserver(android.provider.Settings.System.
        CONTENT_URI, true, settingsContentObserver);
    }
    public class SettingsContentObserver extends ContentObserver {
        int previousVolume;
        Context context;
        SettingsContentObserver(Context c, Handler handler) {
            super(handler);
            context = c;
            AudioManager audio = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
            previousVolume =
            Objects.requireNonNull(audio).getStreamVolume(AudioManager.STREAM_MUSIC);
        }
        @Override
        public boolean deliverSelfNotifications() {
            return super.deliverSelfNotifications();
        }
        @Override
        public void onChange(boolean selfChange) {
            super.onChange(selfChange);
            AudioManager audio = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE);
            int currentVolume =
            Objects.requireNonNull(audio).getStreamVolume(AudioManager.STREAM_MUSIC);
            int delta = previousVolume - currentVolume;
            if (delta > 0) {
                Toast.makeText(MainActivity.this, "Volume Decreased", Toast.LENGTH_SHORT).show();
                previousVolume = currentVolume;
            }
            else if (delta < 0) {
                Toast.makeText(MainActivity.this, "Volume Increased", Toast.LENGTH_SHORT).show();
                previousVolume = currentVolume;
            }
        }
    }
    @Override
    protected void onDestroy() {
        getApplicationContext().getContentResolver().unregisterContentObserver(settingsContentObserver);
super.onDestroy();
    }
}

手順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（実行）アイコンをクリックします。デバイス選択画面で自分のスマートフォンを選択すると、端末にアプリがインストールされ、デフォルト画面が表示されます。

この状態で端末の音量ボタンを押すと、音量の増減に応じて「Volume Increased」「Volume Decreased」といったToastメッセージが表示されることを確認できます。なお、Activity破棄時には onDestroy() 内でオブザーバーの登録解除を行っているため、メモリリークも防げる実装になっています。