系列文章
- Android開源線上音樂播放器——波尼音樂
- Android開源音樂播放器之播放器基本功能
- Android開源音樂播放器之高仿雲音樂黑膠唱片
- Android開源音樂播放器之自動滾動歌詞
- Android開源音樂播放器之線上音樂列表自動載入更多
前言
音樂播放器是我們最常用的應用之一，也是每部手機都會預裝的應用。作為一個合格的音樂播放器，應該具有哪些功能呢？“無非是播放、暫停、切換歌曲、進度調節、切換播放模式、專輯封面顯示、歌詞顯示、歌曲列表、歌曲管理（由於國產手機大多都是修改過的Android系統，因此係統自帶播放器功能也不一樣，這裡以Android原生播放器為參考）這些功能” 一開始我也是這麼認為的，但當我著手做的時候，才發現這些功能遠遠不夠。如手機來電時，音樂需要自動暫停播放，耳機拔出時，同樣需要暫停，還要支援耳機線控，等等，這些都是需要我們考慮的。
一個合格的音樂播放器應該具有哪些基本素質？
由於播放、暫停、切換歌曲、進度調節等這些功能過於簡單，因此不過多討論，這裡只討論一些容易被忽略的功能。
掃描本地音樂
掃描歌曲是播放器的基本功能，一般通過ContentProvider配合Media相關類查詢系統資料庫，獲得媒體庫中的歌曲資訊。
/**
* 掃描歌曲
*/
public static void scanMusic(Context context, List<Music> musicList) {
musicList.clear();
Cursor cursor = context.getContentResolver().query(
MediaStore.Audio.Media.EXTERNAL_CONTENT_URI,
new String[]{
BaseColumns._ID,
MediaStore.Audio.AudioColumns.IS_MUSIC,
MediaStore.Audio.AudioColumns.TITLE,
MediaStore.Audio.AudioColumns.ARTIST,
MediaStore.Audio.AudioColumns.ALBUM,
MediaStore.Audio.AudioColumns.ALBUM_ID,
MediaStore.Audio.AudioColumns.DATA,
MediaStore.Audio.AudioColumns.DISPLAY_NAME,
MediaStore.Audio.AudioColumns.SIZE,
MediaStore.Audio.AudioColumns.DURATION
},
null,
null,
MediaStore.Audio.Media.DEFAULT_SORT_ORDER);
if (cursor == null) {
return;
}
while (cursor.moveToNext()) {
// 是否為音樂
int isMusic = cursor.getInt(cursor.getColumnIndex(MediaStore.Audio.Media.IS_MUSIC));
if (isMusic == 0) {
continue;
}
long id = cursor.getLong(cursor.getColumnIndex(BaseColumns._ID));
// 標題
String title = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.TITLE)));
// 藝術家
String artist = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ARTIST));
// 專輯
String album = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM)));
// 專輯封面id，根據該id可以獲得專輯封面圖片
long albumId = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.ALBUM_ID));
// 持續時間
long duration = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.DURATION));
// 音樂檔案路徑
String path = cursor.getString(cursor.getColumnIndex(MediaStore.Audio.AudioColumns.DATA));
// 音樂檔名
String fileName = cursor.getString((cursor.getColumnIndex(MediaStore.Audio.AudioColumns.DISPLAY_NAME)));
// 音樂檔案大小
long fileSize = cursor.getLong(cursor.getColumnIndex(MediaStore.Audio.Media.SIZE));
Music music = new Music();
music.set...
musicList.add(music);
}
cursor.close();
}
/**
* 從媒體庫載入封面
*/
private Bitmap loadCoverFromMediaStore(long albumId) {
ContentResolver resolver = mContext.getContentResolver();
Uri uri = MusicUtils.getMediaStoreAlbumCoverUri(albumId);
InputStream is;
try {
is = resolver.openInputStream(uri);
} catch (FileNotFoundException ignored) {
return null;
}
BitmapFactory.Options options = new BitmapFactory.Options();
options.inPreferredConfig = Bitmap.Config.RGB_565;
return BitmapFactory.decodeStream(is, null, options);
}
複製程式碼通過以上方法基本可以獲得音樂的所有資訊，弊端是依賴於Android系統媒體庫，有時新增音樂後沒有通知系統掃描，就無法獲得該音樂的資訊，不夠靈活。
避免播放器記憶體被系統回收
我們都知道Android系統有自動回收記憶體機制，如果系統記憶體緊張，就會觸發該機制，應用就有可能被回收，不過Android提供了前臺機制，保證記憶體不足時也不會回收該應用。
/**
* 播放時啟動前臺機制
*/
public static void showPlay(Music music) {
playService.startForeground(NOTIFICATION_ID, buildNotification(playService, music, true));
}
/**
* 暫停時取消前臺機制
*/
public static void showPause(Music music) {
playService.stopForeground(false);
notificationManager.notify(NOTIFICATION_ID, buildNotification(playService, music, false));
}
複製程式碼捕獲/丟棄音樂焦點
大家可能不懂這個標題是什麼意思，彆著急，讓我細細道來。 大家有沒有試過，如果手機上安裝了兩個音樂播放器，當一個正在播放的時候，開啟第二個播放歌曲，有沒有發現第一個自動暫停了？ 或者正在聽歌時來電話了，音樂暫停了，結束通話電話後音樂又繼續播放了， 或者收到通知的時候音樂的音量變小了一下又恢復。
“-納尼！難道不是自動暫停？” “-圖樣圖森破！”
這其實是因為播放器在後臺處理了音訊焦點的原因。
public class AudioFocusManager implements AudioManager.OnAudioFocusChangeListener {
private PlayService mPlayService;
private AudioManager mAudioManager;
private boolean isPausedByFocusLossTransient;
private int mVolumeWhenFocusLossTransientCanDuck;
public AudioFocusManager(@NonNull PlayService playService) {
mPlayService = playService;
mAudioManager = (AudioManager) playService.getSystemService(AUDIO_SERVICE);
}
/**
* 播放音樂前先請求音訊焦點
*/
public boolean requestAudioFocus() {
return mAudioManager.requestAudioFocus(this, AudioManager.STREAM_MUSIC, AudioManager.AUDIOFOCUS_GAIN)
== AudioManager.AUDIOFOCUS_REQUEST_GRANTED;
}
/**
* 退出播放器後不再佔用音訊焦點
*/
public void abandonAudioFocus() {
mAudioManager.abandonAudioFocus(this);
}
/**
* 音訊焦點監聽回撥
*/
@Override
public void onAudioFocusChange(int focusChange) {
int volume;
switch (focusChange) {
// 重新獲得焦點
case AudioManager.AUDIOFOCUS_GAIN:
if (!willPlay() && isPausedByFocusLossTransient) {
// 通話結束，恢復播放
mPlayService.playPause();
}
volume = mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC);
if (mVolumeWhenFocusLossTransientCanDuck > 0 && volume == mVolumeWhenFocusLossTransientCanDuck / 2) {
// 恢復音量
mAudioManager.setStreamVolume(AudioManager.STREAM_MUSIC, mVolumeWhenFocusLossTransientCanDuck,
AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE);
}
isPausedByFocusLossTransient = false;
mVolumeWhenFocusLossTransientCanDuck = 0;
break;
// 永久丟失焦點，如被其他播放器搶佔
case AudioManager.AUDIOFOCUS_LOSS:
if (willPlay()) {
forceStop();
}
break;
// 短暫丟失焦點，如來電
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT:
if (willPlay()) {
forceStop();
isPausedByFocusLossTransient = true;
}
break;
// 瞬間丟失焦點，如通知
case AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK:
// 音量減小為一半
volume = mAudioManager.getStreamVolume(AudioManager.STREAM_MUSIC);
if (willPlay() && volume > 0) {
mVolumeWhenFocusLossTransientCanDuck = volume;
mAudioManager.setStreamVolume(AudioManager.STREAM_MUSIC, mVolumeWhenFocusLossTransientCanDuck / 2,
AudioManager.FLAG_REMOVE_SOUND_AND_VIBRATE);
}
break;
}
}
private boolean willPlay() {
return mPlayService.isPreparing() || mPlayService.isPlaying();
}
}
複製程式碼耳機拔出時暫停播放
“-納尼！難道耳機拔出時不是自動暫停嗎？” “-圖樣……”
private IntentFilter mNoisyFilter = new IntentFilter(AudioManager.ACTION_AUDIO_BECOMING_NOISY);
public class NoisyAudioStreamReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
// 耳機拔出時暫停播放
PlayService.startCommand(context, Actions.ACTION_MEDIA_PLAY_PAUSE);
}
}
複製程式碼播放時註冊廣播接收器，暫停時取消註冊即可。
聯動系統媒體中心
這個標題大家可能也不懂，先放張圖吧
允許與媒體控制器、音量鍵、媒體按鈕和傳輸控制元件互動。
一個類包含了媒體控制和線控等功能，是不是很好用。 現在support-v4包加入了MediaSessionCompat用於在低版本上也能使用這個高大上的功能， 但是低版本上並不能實現媒體控制和線控等功能，低版本的線控功能我會在後面講。
public class MediaSessionManager {
private static final String TAG = "MediaSessionManager";
private static final long MEDIA_SESSION_ACTIONS = PlaybackStateCompat.ACTION_PLAY
| PlaybackStateCompat.ACTION_PAUSE
| PlaybackStateCompat.ACTION_PLAY_PAUSE
| PlaybackStateCompat.ACTION_SKIP_TO_NEXT
| PlaybackStateCompat.ACTION_SKIP_TO_PREVIOUS
| PlaybackStateCompat.ACTION_STOP
| PlaybackStateCompat.ACTION_SEEK_TO;
private PlayService mPlayService;
private MediaSessionCompat mMediaSession;
public MediaSessionManager(PlayService playService) {
mPlayService = playService;
setupMediaSession();
}
/**
* 初始化並啟用MediaSession
*/
private void setupMediaSession() {
mMediaSession = new MediaSessionCompat(mPlayService, TAG);
mMediaSession.setFlags(MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS
| MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS);
mMediaSession.setCallback(callback);
mMediaSession.setActive(true);
}
/**
* 更新播放狀態，播放/暫停/拖動進度條時呼叫
*/
public void updatePlaybackState() {
int state = (mPlayService.isPlaying() || mPlayService.isPreparing())
? PlaybackStateCompat.STATE_PLAYING : PlaybackStateCompat.STATE_PAUSED;
mMediaSession.setPlaybackState(
new PlaybackStateCompat.Builder()
.setActions(MEDIA_SESSION_ACTIONS)
.setState(state, mPlayService.getCurrentPosition(), 1)
.build());
}
/**
* 更新正在播放的音樂資訊，切換歌曲時呼叫
*/
public void updateMetaData(Music music) {
if (music == null) {
mMediaSession.setMetadata(null);
return;
}
MediaMetadataCompat.Builder metaData = new MediaMetadataCompat.Builder()
.putString(MediaMetadataCompat.METADATA_KEY_TITLE, music.getTitle())
.putString(MediaMetadataCompat.METADATA_KEY_ARTIST, music.getArtist())
.putString(MediaMetadataCompat.METADATA_KEY_ALBUM, music.getAlbum())
.putString(MediaMetadataCompat.METADATA_KEY_ALBUM_ARTIST, music.getArtist())
.putLong(MediaMetadataCompat.METADATA_KEY_DURATION, music.getDuration())
.putBitmap(MediaMetadataCompat.METADATA_KEY_ALBUM_ART, CoverLoader.getInstance().loadThumbnail(music));
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
metaData.putLong(MediaMetadataCompat.METADATA_KEY_NUM_TRACKS, AppCache.getMusicList().size());
}
mMediaSession.setMetadata(metaData.build());
}
/**
* 釋放MediaSession，退出播放器時呼叫
*/
public void release() {
mMediaSession.setCallback(null);
mMediaSession.setActive(false);
mMediaSession.release();
}
private MediaSessionCompat.Callback callback = new MediaSessionCompat.Callback() {
@Override
public void onPlay() {
mPlayService.playPause();
}
@Override
public void onPause() {
mPlayService.playPause();
}
@Override
public void onSkipToNext() {
mPlayService.next();
}
@Override
public void onSkipToPrevious() {
mPlayService.prev();
}
@Override
public void onStop() {
mPlayService.stop();
}
@Override
public void onSeekTo(long pos) {
mPlayService.seekTo((int) pos);
}
};
}
複製程式碼耳機線控（適用於API 19及以下）
“-納尼……” “-Shut up !”
是的，需要我們自己控制。 如果你已經按照上面的方法啟用了MediaSession，那麼在5.0以上的系統你已經不需要關心線控功能了，但是在5.0以上仍然需要自己監聽耳機按鍵。
public class RemoteControlReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
KeyEvent event = intent.getParcelableExtra(Intent.EXTRA_KEY_EVENT);
if (event == null || event.getAction() != KeyEvent.ACTION_UP) {
return;
}
Intent serviceIntent;
switch (event.getKeyCode()) {
case KeyEvent.KEYCODE_MEDIA_PLAY:
case KeyEvent.KEYCODE_MEDIA_PAUSE:
case KeyEvent.KEYCODE_MEDIA_PLAY_PAUSE:
case KeyEvent.KEYCODE_HEADSETHOOK:
serviceIntent = new Intent(context, PlayService.class);
serviceIntent.setAction(Actions.ACTION_MEDIA_PLAY_PAUSE);
context.startService(serviceIntent);
break;
case KeyEvent.KEYCODE_MEDIA_NEXT:
serviceIntent = new Intent(context, PlayService.class);
serviceIntent.setAction(Actions.ACTION_MEDIA_NEXT);
context.startService(serviceIntent);
break;
case KeyEvent.KEYCODE_MEDIA_PREVIOUS:
serviceIntent = new Intent(context, PlayService.class);
serviceIntent.setAction(Actions.ACTION_MEDIA_PREVIOUS);
context.startService(serviceIntent);
break;
}
}
}
<!--在AndroidManifest中註冊Receiver-->
<receiver android:name=".receiver.RemoteControlReceiver">
<intent-filter>
<action android:name="android.intent.action.MEDIA_BUTTON" />
</intent-filter>
</receiver>
複製程式碼總結
感謝你能耐心的看到最後，本文主要討論了音樂播放器容易忽略的重要功能，如果還有其他的本文沒有提到的，請大家不吝賜教。
遷移自我的簡書 2016.06.08