Android Studio开发：基于音乐API的播放器

发布时间：2023-05-14

使用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. 在onRequestPermissionsResult()方法中处理权限请求结果，在用户授权之后初始化应用程序。
  4. 在onDestroy()方法中释放MediaPlayer对象，以确保在应用程序退出时释放音乐播放器资源。

四、结论

本文介绍了如何使用Android Studio开发基于音乐API的播放器。我们讨论了如何获取权限、获取音乐文件信息以及播放音乐。虽然本文只提供了基本的功能，但是读者可以根据需求进一步扩展。 完整代码示例请参考上述示例代码。

推荐文章