Android 解读开源项目UniversalMusicPlayer（播放控制层）

版权声明：本文为博主原创文章，未经博主允许不得转载
源码：AnliaLee/android-UniversalMusicPlayer
大家要是看到有错误的地方或者有啥好的建议，欢迎留言评论

前言

由于工作的原因，好久没更新博客了，之前说要写UniversalMusicPlayer（后面统一简称UAMP）的源码分析，虽然代码中许多关键的地方都已经写好了注释，同时为了方便大家阅读也把Google原有的一些注释翻译了，但一直抽不出太多时间去写博客，只能是像挤牙膏似的每天抽一个小模块出来分析的样子(:з」∠)。所以如果有急需这个项目资料的童鞋可以关注一下我fork的那个项目，一般我都会先在那写好注释然后再整理成博客，大家通过注释应该也可以将项目理清，就不需要再等我的龟速更新了~

回到项目中来，我打算按照UAMP项目各个大模块的划分来写，因此可能会写好几篇博客凑成一个系列。这几篇博客没有特定的顺序，大家按需选择某个模块来看就行。另外UAMP播放器是基于MediaSession框架的，相关资料可参考Android 媒体播放框架MediaSession分析与实践，下面就开始正文吧

参考资料
googlesamples/android-UniversalMusicPlayer

---

项目简介

UAMP播放器作为Google的官方demo展示了如何去开发一款音频媒体应用，该应用可跨多种外接设备使用，并为Android手机，平板电脑，Android Auto，Android Wear，Android TV和Google Cast设备提供一致的用户体验

项目按照标准的MVC架构管理各个模块，模块结构如下图所示

其中model、ui、playback模块分别代表MVC架构中的model层、view层以及controller层。此外，UAMP项目中深度使用了MediaSession框架实现了数据管理、播放控制、UI更新等功能，本系列博客将从各个模块入手，分析其源码及重要功能的实现逻辑，这期主要讲的是播放控制这块的内容

---

播放控制模块

在分析MediaSession框架的博客中我们讲到在客户端使用MediaController发送指令，然后调用MediaBrowserService中重写的回调接口控制播放器进行播放的工作，这样就实现了从用户操作界面到控制音频播放的过程。分析这个过程我们可以得知播放器是运行在Service层的，而为了将Service层和控制层进行解耦，UAMP项目中将播放器的控制逻辑放到了Playback的实例中，然后使用PlaybackManager作为中间者管理Service、MediaSession以及Playback之间的交互。它们之间的关联与交互主要是通过各个回调方法来完成的：

MediaBrowserService与PlaybackManager的关联

• PlaybackManager中定义回调接口PlaybackServiceCallback，MusicService（继承自MediaBrowserService）实现了接口中的方法，同时也持有PlaybackManager的实例

//PlaybackManager.java
public interface PlaybackServiceCallback {
   
  void onPlaybackStart();
  void onNotificationRequired();
  void onPlaybackStop();
  void onPlaybackStateUpdated(PlaybackStateCompat newState);
}

//MusicService.java
public class MusicService extends MediaBrowserServiceCompat implements PlaybackManager.PlaybackServiceCallback

• PlaybackManager的构造方法中需要传入实现了PlaybackServiceCallback的实例，因此在MusicService中会将自身作为参数构造PlaybackManager实例，此时MusicService和PlaybackManager之间完成了关联，可以相互调用回调方法用以传达指令和状态

//PlaybackManager.java
public PlaybackManager(PlaybackServiceCallback serviceCallback, Resources resources,
                       MusicProvider musicProvider, QueueManager queueManager,
                       Playback playback) {
    ...
    mServiceCallback = serviceCallback;
}

//MusicService.java
private PlaybackManager mPlaybackManager;

@Override
public void onCreate() {
    ...
    mPlaybackManager = new PlaybackManager(this, getResources(), mMusicProvider, queueManager,playback);
}

---

PlaybackManager与MediaSession的关联

• PlaybackManager中实现了MediaSession的回调MediaSessionCallback，在MusicService配置MediaSession时可以用PlaybackManager.getMediaSessionCallback拿到这个回调，然后调用MediaSession.setCallback传入回调。此时PlaybackManager和MediaSession之间完成了关联，后续使用MediaController发送指令时，指令通过上述回调最终会传达至PlaybackManager中

//PlaybackManager.java
private MediaSessionCallback mMediaSessionCallback;
public PlaybackManager(PlaybackServiceCallback serviceCallback, Resources resources,
                       MusicProvider musicProvider, QueueManager queueManager,
                       Playback playback) {
    ...
    mMediaSessionCallback = new MediaSessionCallback();
}

public MediaSessionCompat.Callback getMediaSessionCallback() {
    return mMediaSessionCallback;
}

private class MediaSessionCallback extends MediaSessionCompat.Callback {
   
    ...
}

//MusicService.java
@Override