【Android】assetsフォルダからオーディオファイルを再生する方法をわかりやすく解説

はじめに

Androidアプリ開発では、効果音やBGMなどの音声ファイルをAPKに同梱したいケースがよくあります。そんなときに便利なのがassetsフォルダです。この記事では、assetsフォルダに格納したオーディオファイル（MP3など）をMediaPlayerクラスで再生する方法を、サンプルコードとともにステップごとに解説します。

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

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

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

res/layout/activity_main.xml に以下のコードを追加します。ここでは画面中央にオーディオ再生用のボタンを1つ配置しています。

<?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">
    <Button
        android:id="@+id/btnPlayAudio"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text=" Play audio"
        android:textStyle="italic"
        android:layout_centerInParent="true" />
</RelativeLayout>

手順3：assetsフォルダを作成して音声ファイルを配置する

プロジェクト上で右クリック →「New」→「Folder」→「Assets Folder」の順に選択して、assetsフォルダを作成します。作成できたら、再生したいオーディオファイル（例：audio.mp3）をコピーして、assetsフォルダ内に貼り付けてください。

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

src/MainActivity.java に以下のコードを記述します。ボタンがタップされると、getAssets().openFd()でアセットからファイルディスクリプタを取得し、MediaPlayerによって再生が開始される仕組みです。

import android.content.res.AssetFileDescriptor;
import android.media.MediaPlayer;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
import java.io.IOException;

public class MainActivity extends AppCompatActivity {
    Button button;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        button = findViewById(R.id.btnPlayAudio);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                MediaPlayer mediaPlayer = new MediaPlayer();
                AssetFileDescriptor afd;
                try {
                    afd = getAssets().openFd("audio.mp3");
                    mediaPlayer.setDataSource(afd.getFileDescriptor());
                    mediaPlayer.prepare();
                    mediaPlayer.start();
                } catch (IOException e) {
                    e.printStackTrace();
                }
                Toast.makeText(MainActivity.this,
                        "Playing audio from Asset directory",
                        Toast.LENGTH_SHORT).show();
            }
        });
    }
}

手順5：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」アイコンをクリックしてください。デバイス選択のダイアログで自分のスマートフォンを選ぶと、実機にアプリがインストールされ、以下のようなデフォルト画面が表示されます。

補足：より堅牢な実装のためのポイント

• prepare() と prepareAsync()： prepare()は同期処理のためUIスレッドを一時的にブロックします。大きなファイルを扱う場合はprepareAsync()の使用も検討しましょう。
• リソースの解放： 再生終了後やActivity破棄時にはmediaPlayer.release()を呼び出してリソースを解放するのがベストプラクティスです。
• データソースの指定： アセットから再生する場合は、setDataSource(afd.getFileDescriptor(), afd.getStartOffset(), afd.getLength())のようにオフセットと長さを指定すると、より確実に動作します。
• ライブラリの移行： サンプルではandroid.support.v7.app.AppCompatActivityを使用していますが、現在の開発ではandroidx.appcompat.app.AppCompatActivity（AndroidX）への移行が推奨されています。

まとめ

assetsフォルダに音声ファイルを配置し、AssetFileDescriptor経由でMediaPlayerにデータソースを設定すれば、簡単にオーディオを再生できます。効果音やBGMをアプリに組み込みたいときは、ぜひこの手法を参考にしてみてください。