[Android] 簡単なMediaPlayerで音楽を再生する

MediaPlayer()を使って簡単な音楽再生アプリが作れます。Audioを扱うものとしては他にはSoundPoolやAudioTrackがあります。

Android Studio
2021.2.1

MediaPlayer

　
MediaPlayerの特徴としては、呼び出してから再生まである程度時間がかかります。ゲームで言うとBGMを流しっぱなしには向きますが、爆発音を出したい時はタイミングが合わないかもしれません。
　
ゲームでの爆発音などは SoundPool が使えます。更に、時間遅延が無いのは AudioTrack です。それぞれ一長一短がありますので用途に合わせた使い方が必要です。
　
MediaPlayerでの音楽ファイルはassetsあるいはrawに置きます。
assetsとrawの違いは、

assets：フォルダー分けができる
- たくさんファイルがあるケースではassetsが便利

raw：ベタにただファイルを入れる配置

目次
1. assetsの設定
2. サンプルコード
3. rawフォルダを使う
4. サンプル動画

assetsの設定

　
mp3ファイルを入れるため「assets」フォルダーを作ります。appを選択した状態で
「New」->「Folder」->「assets folder」からフォルダを作成して、そこにmp3ファイルを入れます。
　

あるいは直接フォルダーをmainの下に作ることでもできます。
..\app\src\main\assets
手順としては

assetsをオープンして音楽素材を取得
MediaPlayerのインスタンスを生成して
音楽素材を設定
準備ができるまで待ち
再生を始める

// assetsのファイルをオープン
AssetFileDescriptor afdescripter = getAssets().openFd(filePath);

// MediaPlayer のインスタンス生成
MediaPlayer　mediaPlayer = new MediaPlayer();

// 音楽ファイルをmediaplayerに設定
mediaPlayer.setDataSource(afdescripter.getFileDescriptor(), 
    afdescripter.getStartOffset(),afdescripter.getLength());

// 再生準備、再生可能状態になるまでブロック
mediaPlayer.prepare();

// 再生開始
mediaPlayer.start();

// 再生終了
mediaPlayer.stop();

// リセット
mediaPlayer.reset();

// リソースの解放
mediaPlayer.release();

// assetsのファイルをオープン

AssetFileDescriptor afdescripter = getAssets().openFd(filePath);

// MediaPlayer のインスタンス生成

MediaPlayer　mediaPlayer = new MediaPlayer();

// 音楽ファイルをmediaplayerに設定

mediaPlayer.setDataSource(afdescripter.getFileDescriptor(),

afdescripter.getStartOffset(),afdescripter.getLength());

// 再生準備、再生可能状態になるまでブロック

mediaPlayer.prepare();

// 再生開始

mediaPlayer.start();

// 再生終了

mediaPlayer.stop();

// リセット

mediaPlayer.reset();

// リソースの解放

mediaPlayer.release();

音量を調整する場合、アプリでボリュームを作成することもできますが、もともとある音量調整ボタンでユーザーが好みで設定できる方が無駄がなく、ユーザーにとっても便利です。そこで setVolumeControlStream を使います。

setVolumeControlStream(AudioManager.STREAM_MUSIC);

1	setVolumeControlStream(AudioManager.STREAM_MUSIC);

　
これを設定しないと、ボリュームでコントロールされるのは（通知音と着信音）となります。

サンプルコード

　
まとめるとこうなります
MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import android.media.AudioManager;
import android.media.MediaPlayer;
import android.util.Log;
import android.widget.Button;
import android.content.res.AssetFileDescriptor;
import android.widget.Toast;
import java.io.IOException;

public class MainActivity extends AppCompatActivity {

    private MediaPlayer mediaPlayer;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 音楽開始ボタン
        Button buttonStart = findViewById(R.id.start);

        // リスナーをボタンに登録
        buttonStart.setOnClickListener( v ->  {
            // 音楽再生
            audioPlay();
        });

        // 音楽停止ボタン
        Button buttonStop = findViewById(R.id.stop);

        // リスナーをボタンに登録
        buttonStop.setOnClickListener( v -> {
            if (mediaPlayer != null) {
                // 音楽停止
                audioStop();
            }
        });
    }


    private boolean audioSetup(){
        // インタンスを生成
        mediaPlayer = new MediaPlayer();

        //音楽ファイル名, あるいはパス
        String filePath = "music.mp3";

        boolean fileCheck = false;

        // assetsから mp3 ファイルを読み込み
        try(AssetFileDescriptor afdescripter = getAssets().openFd(filePath))
        {
            // MediaPlayerに読み込んだ音楽ファイルを指定
            mediaPlayer.setDataSource(afdescripter.getFileDescriptor(),
                    afdescripter.getStartOffset(),
                    afdescripter.getLength());
            // 音量調整を端末のボタンに任せる
            setVolumeControlStream(AudioManager.STREAM_MUSIC);
            mediaPlayer.prepare();
            fileCheck = true;
        } catch (IOException e1) {
            e1.printStackTrace();
        }

        return fileCheck;
    }

    private void audioPlay() {

        if (mediaPlayer == null) {
            // audio ファイルを読出し
            if (audioSetup()){
                Toast.makeText(getApplication(), "Rread audio file", Toast.LENGTH_SHORT).show();
            }
            else{
                Toast.makeText(getApplication(), "Error: read audio file", Toast.LENGTH_SHORT).show();
                return;
            }
        }
        else{
            // 繰り返し再生する場合
            mediaPlayer.stop();
            mediaPlayer.reset();
            // リソースの解放
            mediaPlayer.release();
        }

        // 再生する
        mediaPlayer.start();

        // 終了を検知するリスナー
//        mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
//            @Override
//            public void onCompletion(MediaPlayer mp) {
//                Log.d("debug","end of audio");
//                audioStop();
//            }
//        });
        // lambda
        mediaPlayer.setOnCompletionListener( mp -> {
            Log.d("debug","end of audio");
            audioStop();
        });

    }

    private void audioStop() {
        // 再生終了
        mediaPlayer.stop();
        // リセット
        mediaPlayer.reset();
        // リソースの解放
        mediaPlayer.release();

        mediaPlayer = null;
    }
}

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

import android.media.AudioManager;

import android.media.MediaPlayer;

import android.util.Log;

import android.widget.Button;

import android.content.res.AssetFileDescriptor;

import android.widget.Toast;

import java.io.IOException;

public class MainActivity extends AppCompatActivity {

private MediaPlayer mediaPlayer;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

// 音楽開始ボタン

Button buttonStart = findViewById(R.id.start);

// リスナーをボタンに登録

buttonStart.setOnClickListener( v -> {

// 音楽再生

audioPlay();

});

// 音楽停止ボタン

Button buttonStop = findViewById(R.id.stop);

// リスナーをボタンに登録

buttonStop.setOnClickListener( v -> {

if (mediaPlayer != null) {

// 音楽停止

audioStop();

}

});

}

private boolean audioSetup(){

// インタンスを生成

mediaPlayer = new MediaPlayer();

//音楽ファイル名, あるいはパス

String filePath = "music.mp3";

boolean fileCheck = false;

// assetsから mp3 ファイルを読み込み

try(AssetFileDescriptor afdescripter = getAssets().openFd(filePath))

{

// MediaPlayerに読み込んだ音楽ファイルを指定

mediaPlayer.setDataSource(afdescripter.getFileDescriptor(),

afdescripter.getStartOffset(),

afdescripter.getLength());

// 音量調整を端末のボタンに任せる

setVolumeControlStream(AudioManager.STREAM_MUSIC);

mediaPlayer.prepare();

fileCheck = true;

} catch (IOException e1) {

e1.printStackTrace();

}

return fileCheck;

}

private void audioPlay() {

if (mediaPlayer == null) {

// audio ファイルを読出し

if (audioSetup()){

Toast.makeText(getApplication(), "Rread audio file", Toast.LENGTH_SHORT).show();

}

else{

Toast.makeText(getApplication(), "Error: read audio file", Toast.LENGTH_SHORT).show();

return;

}

else{

// 繰り返し再生する場合

mediaPlayer.stop();

mediaPlayer.reset();

// リソースの解放

mediaPlayer.release();

}

// 再生する

mediaPlayer.start();

// 終了を検知するリスナー

// mediaPlayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {

// @Override

// public void onCompletion(MediaPlayer mp) {

// Log.d("debug","end of audio");

// audioStop();

// }

// });

// lambda

mediaPlayer.setOnCompletionListener( mp -> {

Log.d("debug","end of audio");

audioStop();

});

}

private void audioStop() {

// 再生終了

mediaPlayer.stop();

// リセット

mediaPlayer.reset();

// リソースの解放

mediaPlayer.release();

mediaPlayer = null;

}

その他ファイル

レイアウト
activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    android:background="#def"
    tools:context=".MainActivity">

    <Button
        android:id="@+id/start"
        android:text="@string/start"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="40dp" />

    <Button
        android:id="@+id/stop"
        android:text="@string/stop"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="40dp" />

</LinearLayout>

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical"

android:gravity="center"

android:background="#def"

tools:context=".MainActivity">

<Button

android:id="@+id/start"

android:text="@string/start"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_margin="40dp" />

<Button

android:id="@+id/stop"

android:text="@string/stop"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:layout_margin="40dp" />

</LinearLayout>

リソース
strings.xml

<resources>
    <string name="app_name">YourAppName</string>
    <string name="start">start</string>
    <string name="stop">stop</string>
</resources>

<string name="app_name">YourAppName</string>

<string name="start">start</string>

</resources>

　
BGMとして繰り返し再生させる場合は、release()でリソースを解放しないと、メモリーが圧迫されて止まりますので注意です。再生終了を検知させてもいいのですが、ここは簡単にインスタンスを生成する前にリリースさせます。

// 繰り返し再生する場合
if (mediaPlayer != null) {
       mediaPlayer.stop();
        mediaPlayer.reset();
        // リソースの解放
        mediaPlayer.release();
 }

// 繰り返し再生する場合

if (mediaPlayer != null) {

mediaPlayer.stop();

mediaPlayer.reset();

// リソースの解放

mediaPlayer.release();

}

rawフォルダを使う

　
assetsからデータを取り出しましたが、参考のためrawフォルダに置いた場合です。
この場合mp3などの拡張子はいりません。

rawフォルダをresの下に作成して
音楽素材を入れます。
あるいは直接作ってもできます。
..\app\src\main\res\raw
　
前のコードの audioSetup() の部分のみ変更します。この場合 try catch や prepare() もいりません。
　
MainActivity.java

...
    private boolean audioSetup(){
        boolean fileCheck = false;

        // rawにファイルがある場合
        mediaPlayer = MediaPlayer.create(this, R.raw.music);
        // 音量調整を端末のボタンに任せる
        setVolumeControlStream(AudioManager.STREAM_MUSIC);
        fileCheck = true;

        return fileCheck;
    }
...

...

private boolean audioSetup(){

boolean fileCheck = false;

// rawにファイルがある場合

mediaPlayer = MediaPlayer.create(this, R.raw.music);

// 音量調整を端末のボタンに任せる

setVolumeControlStream(AudioManager.STREAM_MUSIC);

fileCheck = true;

return fileCheck;

}

...

サンプル動画

実際には、メールやLineなどしながら音楽を聴くという状況が多いと思います。その場合はMediaPlayerはバックグラウンドで再生した方がいいのでServiceとNotificationを使います。

https://akira-watson.com/android/service.html

関連ページ
- 簡単なMediaPlayerで音楽を再生
- WAV音声ファイルをAudioTrackで再生
- SoundPoolで効果音を鳴らす

Reference:
MediaPlayer | Android Developers