Android開源音樂播放器之播放器基本功能

時間  2019-11-07
標籤 android 開源 音樂 播放 基本 功能 欄目 Android 简体版
原文   原文鏈接

系列文章

前言

音樂播放器是咱們最經常使用的應用之一，也是每部手機都會預裝的應用。做爲一個合格的音樂播放器，應該具備哪些功能呢？「無非是播放、暫停、切換歌曲、進度調節、切換播放模式、專輯封面顯示、歌詞顯示、歌曲列表、歌曲管理（因爲國產手機大多都是修改過的Android系統，所以系統自帶播放器功能也不同，這裏以Android原生播放器爲參考）這些功能」 一開始我也是這麼認爲的，但當我着手作的時候，才發現這些功能遠遠不夠。如手機來電時，音樂須要自動暫停播放，耳機拔出時，一樣須要暫停，還要支持耳機線控，等等，這些都是須要咱們考慮的。html

一個合格的音樂播放器應該具備哪些基本素質？

因爲播放、暫停、切換歌曲、進度調節等這些功能過於簡單，所以不過多討論，這裏只討論一些容易被忽略的功能。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系統媒體庫，有時新增音樂後沒有通知系統掃描，就沒法得到該音樂的信息，不夠靈活。bash

避免播放器內存被系統回收

咱們都知道Android系統有自動回收內存機制，若是系統內存緊張，就會觸發該機制，應用就有可能被回收，不過Android提供了前臺機制，保證內存不足時也不會回收該應用。session

/**
 * 播放時啓動前臺機制
 */
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));
}
複製代碼

捕獲/丟棄音樂焦點

你們可能不懂這個標題是什麼意思，彆着急，讓我細細道來。 你們有沒有試過，若是手機上安裝了兩個音樂播放器，當一個正在播放的時候，打開第二個播放歌曲，有沒有發現第一個自動暫停了？ 或者正在聽歌時來電話了，音樂暫停了，掛斷電話後音樂又繼續播放了， 或者收到通知的時候音樂的音量變小了一下又恢復。ide

「-納尼！難道不是自動暫停？」 「-圖樣圖森破！」post

這實際上是由於播放器在後臺處理了音頻焦點的緣由。ui

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();
    }
}
複製代碼

耳機拔出時暫停播放

「-納尼！難道耳機拔出時不是自動暫停嗎？」 「-圖樣……」this

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);
    }
}
複製代碼

播放時註冊廣播接收器，暫停時取消註冊便可。google

聯動系統媒體中心

這個標題你們可能也不懂，先放張圖吧

明白了吧，個人播放器除了播放了一首音樂以外什麼都沒作，就能夠分別在任務管理、鎖屏、負一屏控制個人播放器了，是否是感受碉堡了。 這些圖是在個人小米手機上截的，不保證全部手機都有這些控制功能，可是隻要你的Android版本是5.0以上，應該都會有媒體中心，無非是表現形式不一樣。 Android 5.0中新增了 MediaSession類，官方說明是

容許與媒體控制器、音量鍵、媒體按鈕和傳輸控件交互。

一個類包含了媒體控制和線控等功能，是否是很好用。 如今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

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程