Android Studio開發：基於音樂API的播放器

隨著音樂的普及，以及音樂App的崛起，越來越多的開發者開始嘗試開發自己的音樂播放器。本文將介紹如何使用Android Studio開發基於音樂API的播放器，並提供完整的代碼示例。

一、概述

音樂播放器是一個非常常見的應用程序。在Android上，我們可以使用MediaPlayer類進行音樂的播放和控制。但是，使用MediaPlayer類並不能滿足我們的需求，因為它只提供了基本的音樂播放功能。為了滿足用戶的需求，我們需要使用音樂API。

音樂API是一個允許應用程序訪問和控制操作系統中音樂庫的介面。使用音樂API，我們可以獲取音樂文件的元數據、播放音樂、停止音樂、暫停音樂等操作。Android平台提供了MediaStore類，它允許我們訪問系統中的音樂庫，以及獲取音樂文件的信息。

二、獲取許可權和音樂文件信息

在使用音樂API之前，我們需要獲取相關的許可權。在AndroidManifest.xml文件中添加以下代碼：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

代碼解釋：這個許可權允許應用程序讀取外部設備的存儲，以獲取音樂文件的元數據。

在獲取許可權之後，我們需要使用ContentResolver類來獲取音樂文件的信息，包括歌曲名、歌手名、專輯名、時長等。以下是獲取歌曲名和歌手名的代碼：

String[] projection = { MediaStore.Audio.Media.TITLE, MediaStore.Audio.Media.ARTIST };
Cursor cursor = getContentResolver().query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, projection, null, null, null);
if (cursor != null) {
    while (cursor.moveToNext()) {
        String title = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.TITLE));
        String artist = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.ARTIST));
    }
    cursor.close();
}

代碼解釋：首先，我們定義了一個String類型的數組projection，它指定了要查詢的欄位。然後，我們使用getContentResolver()方法獲取ContentResolver對象，它允許我們訪問系統中的數據。接著，我們調用query()方法來查詢音樂庫中的數據。最後，我們從Cursor對象中讀取歌曲名和歌手名。

三、播放音樂

使用音樂API播放音樂非常簡單。以下是播放音樂的代碼：

MediaPlayer mMediaPlayer = new MediaPlayer();
mMediaPlayer.setDataSource(musicFile.getAbsolutePath());
mMediaPlayer.prepare();
mMediaPlayer.start();

代碼解釋：首先，我們創建了一個MediaPlayer對象mMediaPlayer。然後，我們使用setDataSource()方法設置音樂文件的路徑。接著，我們調用prepare()方法準備播放器，最後調用start()方法開始播放。

以上是一個非常簡單的音樂播放器示例。在實際應用中，我們還需要添加其他的功能，例如暫停、停止、播放列表等。完整的代碼示例，請參考下面的代碼：

public class MainActivity extends AppCompatActivity {

    private ListView mListView;
    private ArrayList<Music> mMusicList;
    private MusicAdapter mMusicAdapter;
    private MediaPlayer mMediaPlayer;

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

        // 獲取許可權
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                requestPermissions(new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 1);
            } else {
                init();
            }
        } else {
            init();
        }
    }

    private void init() {
        // 獲取音樂列表
        mMusicList = new ArrayList<>();
        String[] projection = {MediaStore.Audio.Media._ID, MediaStore.Audio.Media.TITLE, MediaStore.Audio.Media.ARTIST, MediaStore.Audio.Media.ALBUM, MediaStore.Audio.Media.DURATION, MediaStore.Audio.Media.DATA};
        String selection = MediaStore.Audio.Media.IS_MUSIC + "!= 0";
        Cursor cursor = getContentResolver().query(MediaStore.Audio.Media.EXTERNAL_CONTENT_URI, projection, selection, null, null);
        if (cursor != null) {
            while (cursor.moveToNext()) {
                int id = cursor.getInt(cursor.getColumnIndex(MediaStore.Audio.Media._ID));
                String title = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.TITLE));
                String artist = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.ARTIST));
                String album = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.ALBUM));
                int duration = cursor.getInt(cursor.getColumnIndex(MediaStore.Audio.Media.DURATION));
                String path = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.Media.DATA));
                Music music = new Music(id, title, artist, album, duration, path);
                mMusicList.add(music);
            }
            cursor.close();
        }

        // 初始化UI
        mListView = findViewById(R.id.lv_music);
        mMusicAdapter = new MusicAdapter(MainActivity.this, mMusicList);
        mListView.setAdapter(mMusicAdapter);
        mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
            @Override
            public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
                if (mMediaPlayer != null) {
                    mMediaPlayer.release();
                }
                mMediaPlayer = new MediaPlayer();
                try {
                    mMediaPlayer.setDataSource(mMusicList.get(position).getPath());
                    mMediaPlayer.prepare();
                    mMediaPlayer.start();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        });
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == 1) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                init();
            } else {
                Toast.makeText(MainActivity.this, "無法獲取許可權", Toast.LENGTH_SHORT).show();
            }
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (mMediaPlayer != null) {
            mMediaPlayer.release();
        }
    }
}

代碼解釋：

1. 在init()方法中獲取音樂列表，並初始化UI。

2. 在onItemClick()方法中處理列表項單擊事件，並根據點擊的項來播放相應的音樂。我們使用MediaPlayer類來實現音樂播放功能

3. 在requestPermissionsResult()方法中處理許可權請求結果，在用戶授權之後初始化應用程序。

4. 在onDestroy()方法中釋放MediaPlayer對象，以確保在應用程序退出時釋放音樂播放器資源。

四、結論

本文介紹了如何使用Android Studio開發基於音樂API的播放器。我們討論了如何獲取許可權、獲取音樂文件信息以及播放音樂。雖然本文只提供了基本的功能，但是讀者可以根據需求進一步擴展。

完整代碼示例請參考上述示例代碼。