PineMedia之本地音乐播放器（Android实现）

项目代码地址：https://github.com/thfhongfeng/PineMedia

介绍

为了方便本地多媒体的播放与查看。基于之前写的AndroidAppTemplate项目模板和PinePlayer组件做了个PineMedia应用。

本文是其中之一的音乐播放器：
该音乐播放器（听音乐）属于个人要做的PineMedia项目的其中一个功能，另外两个是视频播放器（看影片）和图片查看器（看漫画），以后有时间再做。
界面---因为是个人项目，所以参考了某款手机的系统音乐的界面，提取了其中的本地部分而成。
图标---则是阿里的图标库里找的。链接：https://www.iconfont.cn/
效果图：

播放界面	歌单歌曲列表界面
歌曲选择界面	歌单列表界面
定时关闭设置界面	播放列表界面

PineMedia项目实现的是服务于本地多媒体的播放功能。
其中的音乐播放器主要实现了以下几个功能：

1. 自定义歌单管理，歌曲收藏，最近播放管理。
2. 歌曲播放，歌词简单展示（有时间再做延伸）。
3. 按各种顺序进行播放的功能，定时关闭功能。

基本上常用功能都有涉及，满足一般使用者的需要。

实现

1. 该项目基于PinePlayer组件，需要了解的可前往https://www.jianshu.com/p/80dc3d61bfc2
2. 该项目模板基于AndroidAppTemplate，需要了解的可前往https://www.jianshu.com/p/8f822126e490

音乐播放器功能目录结构：

项目整体目录结构.png	音乐播放器目录结构.png

数据库使用的是Room，相关知识自行查找了解。
数据表结构：

音乐播放器数据库结构.png

及其简单的关系表，不再赘述。

界面也不过是一些常用的列表数据的增删改查显示，亦不多说。

这里主要介绍下播放控件的实现：
也就是这两块：

播放控件1.jpg

播放控件2

这两块类似于浮动挂件。但实现上是当前界面的控件
这两个控件分别为ApSimpleAudioPlayerView和ApMainAudioPlayerView，均继承自AudioPlayerView。

这两个控件使用时，只需要以下几步即可：

1. 布局中引用。
2. onCreate时init，onResume时attach，onStop时detach（可选）。

    @Override
    protected void init(Bundle onCreateSavedInstanceState) {
        ……
        ApAudioPlayerHelper.getInstance().initPlayerView(mBinding.playerView);
    }

    @Override
    protected void onRealResume() {
        super.onRealResume();
        ApAudioPlayerHelper.getInstance().attachPlayerView(mBinding.playerView);
        mViewModel.refreshData();
    }

    @Override
    protected void onStop() {
        super.onStop();
        ApAudioPlayerHelper.getInstance().detachPlayerView(mBinding.playerView);
    }

ApAudioPlayerHelper是播放器的帮助类，其实质也是对AudioPlayerView进行init，attach和detach操作。

    public void initPlayerView(@NonNull AudioPlayerView playerView) {
        playerView.init(TAG, mControllerAdapter);
    }

    ……
    public void detachPlayerView(@NonNull AudioPlayerView playerView) {
        if (mPlayerViewListenerMap.containsKey(playerView.hashCode())) {
            mPlayerViewListenerMap.remove(playerView.hashCode());
        }
        playerView.detachView();
    }

那么AudioPlayerView是如何同播放器关联的呢，又是如果做到切换界面时，播放器不受影响，且新的界面也能同步到播放器的状态的呢。
这里也是用到了PinePlayer的特点：
多个PlayerView共用一个MediaControllerAdapter
这里使用的是ApAudioControllerAdapter，它负责了播放器界面的适配，AlbumArt图片和歌词文件的获取与匹配。
关联关系如下图：

播放器控件关联关系.png

这种方式的实现基于下面几个条件：

1. Player独立保存，PinePlayer中Player是保存在PlayerServer服务中的。
2. 播放控件界面是统一适配并且可以随时attach和detach，PinePlayer中PineMediaController是通过MediaControllerAdapter来统一实现界面的适配添加的，且可以随时attach和detach。
3. Player可以随时和播放控件界面进行解绑和绑定，PinePlayer中遵循这一原则，由PineMediaController进行了实现。
4. 使用相同的MediaControllerAdapter。
   因此，新的PlayerView随时可获取到mPlayer，并在init时将Player关联关联到新的PlayerView和PineMediaController中，并为该PineMediaController设置新的MediaControllerAdapter，在attach时为MediaControllerAdapter绑定对应的布局。这样，在mPlayer绑定了新的界面控件时，其界面提供者就是同一个MediaControllerAdapter了，MediaControllerAdapter里所有的资源就实现了共用。而这个MediaControllerAdapter则保存在了ApAudioPlayerHelper中。