【Android】MediaPlayerクラスで基本的なオーディオプレーヤーを実装する方法

このチュートリアルでは、Android標準のMediaPlayerクラスを使用して、再生・一時停止・5秒単位の早送り／巻き戻し・進行状況表示といった基本機能を備えたオーディオプレーヤーをアプリに実装する方法を、ステップ形式で解説します。

MediaPlayerクラスとは

MediaPlayerは、Android SDKに標準搭載されているメディア再生用APIです。アプリ内のリソースファイル、ローカルストレージ上のファイル、ネットワーク経由のストリーミングなど、さまざまな音源を再生できます。「アイドル → 初期化 → 準備完了 → 再生中」といった内部状態の遷移を意識しながら扱うのが特徴で、本記事ではその基本となる使い方を紹介します。

事前準備：音声ファイルの配置

再生する音声ファイル（例：bohemian_rhapsody.mp3）を app/res/raw フォルダに格納しておきます。rawフォルダが存在しない場合は、resディレクトリを右クリックし「New → Android Resource Directory」から作成してください。

ステップ1：新規プロジェクトの作成

Android Studioで「File → New Project」を選択し、必要事項を入力して新しいプロジェクトを作成します。テンプレートは「Empty Activity」で問題ありません。

ステップ2：レイアウトの作成（activity_main.xml）

res/layout/activity_main.xml を以下のように記述します。再生中の曲名や時間を表示するTextView、操作ボタン（巻き戻し・再生・一時停止・早送り）、再生位置を示すSeekBarをRelativeLayoutで配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
   android:layout_height="match_parent"
   android:paddingLeft="10dp"
   android:paddingRight="10dp">
   <TextView
      android:id="@+id/textView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Now Playing: "
      android:layout_marginTop="30dp"
      android:textAppearance="?android:attr/textAppearanceMedium" />
   <TextView
      android:id="@+id/txtSongName"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignBaseline="@+id/textView"
      android:layout_toEndOf="@+id/textView" />
   <ImageButton
      android:id="@+id/btnBackward"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignParentBottom="true"
      android:layout_marginBottom="44dp"
      android:layout_marginLeft="20dp"
      android:src="@drawable/ic_back" />
   <ImageButton
      android:id="@+id/btnPlay"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignTop="@+id/btnBackward"
      android:layout_marginLeft="20dp"
      android:layout_toRightOf="@+id/btnBackward"
      android:src="@drawable/ic_play" />
   <ImageButton
      android:id="@+id/btnPause"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignTop="@+id/btnPlay"
      android:layout_marginLeft="20dp"
      android:layout_toRightOf="@+id/btnPlay"
      android:src="@drawable/ic_pause" />
   <ImageButton
      android:id="@+id/btnForward"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignTop="@+id/btnPause"
      android:layout_marginLeft="20dp"
      android:layout_toRightOf="@+id/btnPause"
      android:contentDescription="@+id/imageButton3"
      android:src="@drawable/ic_forward" />
   <TextView
      android:id="@+id/txtStartTime"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_alignTop="@+id/seekBar"
      android:text="0 min, 0 sec" />
   <SeekBar
      android:id="@+id/seekBar"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:layout_above="@+id/btnBackward"
      android:layout_toLeftOf="@+id/txtSongTime"
      android:layout_toRightOf="@+id/txtStartTime" />
   <TextView
      android:id="@+id/txtSongTime"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_toRightOf="@+id/btnForward"
      android:layout_alignTop="@+id/seekBar"
      android:text="0 min, 0 sec " />
</RelativeLayout>

ボタン用のアイコン（ic_back、ic_play、ic_pause、ic_forward）はdrawableリソースとして各自で用意してください。Android StudioのVector Assetツールを使えば、標準のマテリアルアイコンを簡単に追加できます。

ステップ3：MainActivity.javaの実装

続いて、src/MainActivity.java に以下のコードを記述します。主な処理内容は次のとおりです。

• MediaPlayer.create() でrawリソースからプレーヤーを生成
• 再生ボタンで start() を呼び出し、曲の総時間をSeekBarの最大値に設定
• Handler.postDelayed() を利用し、100ミリ秒ごとに再生位置とラベルを更新
• 一時停止ボタンで pause() を呼び出し、ボタンの有効／無効を切り替え
• 早送り・巻き戻しボタンで seekTo() により5秒（5000ミリ秒）移動

import android.media.MediaPlayer;
import android.os.Handler;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageButton;
import android.widget.SeekBar;
import android.widget.TextView;
import android.widget.Toast;
import java.util.concurrent.TimeUnit;
public class MainActivity extends AppCompatActivity {
   private ImageButton forwardBtn, backwardBtn, pauseBtn, playBtn;
   private MediaPlayer mediaPlayer;
   private TextView songName, startTime, songTime;
   private SeekBar songProgress;
   private static int onTime =0, playTime =0, endTime =0, forwardTime = 5000, backwardTime = 5000;
   private Handler handler = new Handler();
   @Override
   protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
      backwardBtn = findViewById(R.id.btnBackward);
      forwardBtn = findViewById(R.id.btnForward);
      playBtn = findViewById(R.id.btnPlay);
      pauseBtn = findViewById(R.id.btnPause);
      songName = findViewById(R.id.txtSongName);
      startTime = findViewById(R.id.txtStartTime);
      songTime = findViewById(R.id.txtSongTime);
      songName.setText("Bohemian_Rhapsody");
      mediaPlayer = MediaPlayer.create(this, R.raw.bohemian_rhapsody);
      songProgress = findViewById(R.id.seekBar);
      songProgress.setClickable(false);
      pauseBtn.setEnabled(false);
      playBtn.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            Toast.makeText(MainActivity.this, "Playing Audio", Toast.LENGTH_SHORT).show();
            mediaPlayer.start();
            endTime = mediaPlayer.getDuration();
            playTime = mediaPlayer.getCurrentPosition();
            if (onTime == 0) {
               songProgress.setMax(endTime);
               onTime = 1;
            }
            songTime.setText(String.format("%d min, %d sec",
            TimeUnit.MILLISECONDS.toMinutes(endTime),
            TimeUnit.MILLISECONDS.toSeconds(endTime) -
            TimeUnit.MINUTES.toSeconds(TimeUnit.MILLISECONDS.toMinutes(endTime))));
            startTime.setText(String.format("%d min, %d sec",
            TimeUnit.MILLISECONDS.toMinutes(playTime),
            TimeUnit.MILLISECONDS.toSeconds(playTime) -
            TimeUnit.MINUTES.toSeconds(TimeUnit.MILLISECONDS.toMinutes(playTime))));
            songProgress.setProgress(playTime);
            handler.postDelayed(UpdateSongTime, 100);
            pauseBtn.setEnabled(true);
            playBtn.setEnabled(false);
         }
      });
      pauseBtn.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            mediaPlayer.pause();
            pauseBtn.setEnabled(false);
            playBtn.setEnabled(true);
            Toast.makeText(getApplicationContext(), "Pausing Audio", Toast.LENGTH_SHORT).show();
         }
      });
      forwardBtn.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            if ((playTime + forwardTime) <= endTime) {
               playTime = playTime + forwardTime;
               mediaPlayer.seekTo(playTime);
            } else {
               Toast.makeText(getApplicationContext(), "Cannot jump forward 5 seconds", Toast.LENGTH_SHORT).show();
            }
            if (!playBtn.isEnabled()) {
               playBtn.setEnabled(true);
            }
         }
      });
      backwardBtn.setOnClickListener(new View.OnClickListener() {
         @Override
         public void onClick(View v) {
            if ((playTime - backwardTime) > 0) {
               playTime = playTime - backwardTime;
               mediaPlayer.seekTo(playTime);
            } else {
               Toast.makeText(getApplicationContext(), "Cannot jump backward 5 seconds", Toast.LENGTH_SHORT).show();
            }
            if (!playBtn.isEnabled()) {
               playBtn.setEnabled(true);
            }
         }
      });
   }
   private Runnable UpdateSongTime = new Runnable() {
      @Override
      public void run() {
         playTime = mediaPlayer.getCurrentPosition();
         startTime.setText(String.format("%d min, %d sec",
         TimeUnit.MILLISECONDS.toMinutes(playTime),
         TimeUnit.MILLISECONDS.toSeconds(playTime) -
         TimeUnit.MINUTES.toSeconds(TimeUnit.MILLISECONDS.toMinutes(playTime))) );
         songProgress.setProgress(playTime);
         handler.postDelayed(this, 100);
      }
   };
}

ステップ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」アイコンをクリックし、接続したデバイスを選択します。アプリが起動すると、以下のような画面が表示されます。

実装時の注意点

• Activityが破棄される際には、onDestroy() 内で mediaPlayer.release() を呼び出し、リソースを必ず解放しましょう。解放を怠るとメモリリークの原因になります。
• バックグラウンドでも再生を継続したい場合は、ServiceやMediaSessionとの連携が必要になります。
• ストリーミング対応・キャッシュ・プレイリスト管理など、より高度な制御が必要な場合は、Jetpack Media3（旧ExoPlayer）の採用も検討する価値があります。