Android车载多媒体开发MediaSession框架理解

车载多媒体开发MediaSession框架，本篇.应该是.目前.国内网上关于MediaSession的最全面的一篇了，建议收藏。本文的目的之一就是通过梳理总结MediaSession框架相关的知识点.

1、关键词

Android、MediaSession、MediaSession框架、车载多媒体开发、Android历史发布版本、media3、ExoPlayer、Automotive
   《谷歌官网：媒体应用架构(点我跳转)》、  《谷歌官网：Build media apps for cars(点我跳转)》》  2、目录结构

1. 一、MediaSession概述
2. 二、MediaSession接口
3. 三、MediaSession构建一个简单的播放器
4. 四、附录（可选）
5. 致谢（引用和推荐）
6. @©LICENSE（版权和更新记录）

复制代码

一、MediaSession概述

Android 5.0开始（当前最新是
）引入的媒体应用框架，分为媒体控制器MediaController（用于界面UI）和媒体会话MediaSession（用于播放器Player）。MediaSession框架，利用一套接口，淘汰了许多流程的繁琐和service的通讯等，实现多个设备大概UI的统一调用，其代码可读性、结构耦合度（解耦UI和播放器：MediaPlayer、ExoPlayer等）方面都控制得非常好
MediaSession紧张应用于播放音频或视频的多媒体应用中
⚠️ 注意
   可以对比一下视频和音频的区别：还有传统播放音乐的APP架构的区别。在下面  ↓↓↓<  一.3、多媒体应用架构>会进行补充阐明  1、历史

2014年Google I/O会上发布了Android5.0，这个版本上引入了的媒体应用框架，也就是MediaSession。Android Auto也是首次表态、于2015年3月19日发布，2015年Hyundai Sonata是第一个支持Android Auto的汽车
背面陆续发布了：N O P Q R S T U 各版本，下表为我整理的一个Android历史版本映射表
1.1、Android历史发布版本和API对照

下面记录Android版本号、发布日期、版本名称代号和API级别对照表
Android版本发布日期代号和API LevelAndroid 142023年10 ️04日U→34Android 132022年8 ️15日T→33Android 12L2022年2 ️，Android 12L Beta 3 版本发布，首次支持了 Pixel 6 和 Pixel 6 ProS→32Android 122021年10 ️4日S→31Android 112020年9 ️8日R→30Android 102019年9 ️3日Q→29Android 92018年8 ️6日Pie→28Android 8.12017年12 ️5日Orea→27Android 82017年8 ️21日Orea→26Android 7.1.12016年12 ️5日Nougat→25Android 72016年8 ️22日Nougat→24Android 62015年10 ️5日MarshMallow→23 ⑴、统一各个CAA中引用Android版本的代号

前面的数字是Android的版本号、中心的字母是Android的代号、背面的数字为Android的API版本号




⚠️ 注意：这是第三次统一阐明标准了、未来在CAA中涉及到Android版本的内容，都接纳上面↑↑↑的格式做版本阐明
2、概念类

2.1、Android Automotive OS

Automotive指车载体系。视频应用可在运行Android Automotive OS的停放车辆上运行，这一点通过利用与驱动你的移动应用代码几乎雷同，如许针对可折叠设备平静板电脑的大屏幕优化，就改善了汽车内置屏幕的用户体验



⚠️ 注意

• MediaSession也就是运行在Automotive体系之上的API服务
  
• 最新的
  

、发布的Automotive OS可以很方便的驱动移动应用代码适配到车机上

2.2、Android Auto

Android Auto（我们一样平常简称AA）指车载投屏，是一个Android端的App，是专门为驾驶情况而设计的。类似还有CarLife投屏，CarPlay投屏、HiCar。当AA接到汽车屏幕上其界面看起来是下面这个样子(补充图片)


⚠️ 注意

• 运行AA须要Android 5.0或更高版本的体系，并且还须要Google地图和Google Play音乐应用。国内一样平常用不了
  
• AA是谷歌也就是Android自己的标准，CarLife是百度的标准，CarPlay是iOS(苹果）的投屏方案。这三个都是必须把握和学习的技术
  
• 用不了AA，国内许多车厂替换的方案就是，CarLife和CarPlay，HiCar是华为搞的。CarLife可以在Android和iOS上利用，CarPlay则只能利用iPhone手机才能利用投屏功能
  
• HiCar是华为2019年9月，它是人-车-家全场景聪明互联解决方案。像问界M9也是搭载了HiCar的
  

用AA，CarLife，CarPlay播放音乐，他们都会用到MediaSession，这就是我为什么要在这里引出他们的缘故原由
2.3、车载专业术语

在车载开发中有许多的专业术语，你须要有肯定的了解。这里是网上关于 **车联网常见缩写，已经很详细了
否则，你看余承东怼行业内说连AEB都不知道


   AEB，全称Advanced Emergency Braking System，即高级紧急制动体系。这是一种主动安全技术，旨在通过车辆传感器和算法，主动检测前方障碍物和潜伏危险，并在须要时主动刹车以避免或淘汰碰撞  2.4、开发播放操作词汇

⑴、上一曲|下一曲

• PlaybackState.STATE_FAST_FORWARDING 下一曲4
  
• PlaybackState.STATE_REWINDING 上一曲5
  
• fast forwarding 下一曲
  
• rewinding 上一曲
  

⑵、快进|快退/快倒

• fastforward快进
  
• fastrewind快退/快倒
  

⑶、快退播放

一样平常指长按上一曲键，视频大概音频会以2x倍速快退播放，然后松开手大概鼠标，视频大概音频会恢复播放（继承以正常的1x倍速） * Fast Reverse Playback快退播放（Fast Reverse快退）
⑷、快进播放

一样平常指长按下一曲键，视频大概音频会以2x倍速，逐渐向16x倍速的速率，快进播放，然后松开手大概鼠标，视频大概音频会恢复播放（继承以正常的1x倍速）
⑸、慢进播放

一样平常指设置倍速为0.5x，视频大概音频会以0.5x的倍速播放 * Slow Forward Playback慢进播放
⑹、倍速播放

一样平常指设置倍速为1.5x、2x、2.5x、3x，视频大概音频会以对应的倍速播放
⚠️ 注意_跑题了（没关系）

• rewind自己是“倒带”，“倒回”。指的是将录音带、录像带或其他录像设备上的录像拉回到播放前的位置，以重新播放。rewinding以直觉来判断它纵然rewind的动名词/现在分词的情势
  
• 除了录像设备上的举动，rewind还有其他用法。例如，rewind也可以用来描述某件事情重新发生的意思，就像将时间倒转一样，将事情重新发生
  
• 别的，rewind也可以用来描述某种感情的回溯，比如当某人想起某个过去的经历时，他大概会说“我被rewind了”，表现他回想起了过去的经历
  

3、多媒体应用架构

刚刚提及过，那么大致知道，播放音频、视频，还有图片（图片也是可以播的哈）的多媒体应用通常是由两部分组成即界面UI和播放器Player两部分组成。而基于MediaSession的媒体应用框架就是解耦，多了MediaController和MediaSession（可以通过下面架构图一览无余）
3.1、播放器Player

用于吸收数字媒体并将其呈现为视频/音频。可以是MediaPlayer、ExoPlayer或其他Player

• MediaPlayer ：提供准体系播放器的根本功能，支持最常见的音频/视频格式和数据源
  
• ExoPlayer ：一个提供低层级Android音频API的开放源代码库。ExoPlayer支持DASH和HLS流等高性能功能，这些功能在MediaPlayer中未提供
  

⚠️ 注意_2023年IO大会中的原话

• 现在Exoplayer位于Media3中，在Media3中，你还可以找到熟悉API的最新版本，比如向后兼容的ExoPlayer和MediaSession，它们可自定义且易于利用，这些API的更新便于你更轻松地构建丰富的媒体体验
  
• 更新后的MeidaSession API，可以更轻松地让播放状态和元数据保持最新状态，因此你可以实现与Android Auto、Wear OS Android TV等平台的高质量集成
  

3.2、界面UI

用于表现、控制播放器状态界面

3.3、传统应用架构



我们先来看看怎样设计一款音乐播放App的架构，假如要求音频可以配景继承播放。传统的做法是如许的： 注册一个Service，用于异步获取音乐库数据、音乐控制等，在Service中我们大概还须要自定义一些状态值和回调接口用于流程控制 把Player放置在这个Service中，Service提供一个Binder大概广播（其他方式如接口、Messenger都可以）实现Activity和Service之间的通讯，使得用户可以通过界面上的组件控制音乐的播放、暂停、拖动进度条等操作
假如我们的音乐播放器还须要支持通知栏快捷控制音乐播放的功能，那么又得新增一套广播和相应的接口去响应通知栏按钮的变乱
假如遇到锁屏时，要与Service之间进行通讯就不得不用到AIDL接口/广播/ContentProvider来完成与其它应用之间的通讯，这些通讯本领既增加了应用开发者之间的沟通本钱，也增加了应用之间的耦合度
假如还须要支持多端（电视、手表、耳机、车机等）控制同一个播放器，那么整个体系架构大概会变得非常复杂，我们要耗费大量的时间和精力去设计、优化代码的结构。那么有什么方法可以节省这些工作，进步我们的服从，然后还可以优雅地实现上述这些功能呢？
它就是MediaSession框架
3.4、MediaSession架构


MediaSession框架专门用来解决媒体播放时界面和Service通讯的标题，意在规范上述这些功能的流程。MediaSession框架规范了音视频应用中界面与播放器之间的通讯接口，属于典范的 C/S 架构，实现界面与播放器之间的完全解耦。框架定义了两个紧张的类媒体会话和媒体控制器，它们为构建多媒体播放器应用提供了一个完善的结构。
媒体会话和媒体控制器通过以下方式相互通讯：利用与标准播放器操作（播放、暂停、停止等）相对应的预定义回调，以及用于定义应用独有的特别举动的可扩展自定义调用
⚠️ 注意

• support-v4中提供了MediaSession相应的兼容包，相关的类是以Compat结尾，API完全一致。若文中有提到的类似MediaBrowserCompat就得明白它和MediaBrowser是指同一个类
  
• 我们公司计划2023/11要替换成androidx，建议各人还是升级适配androidx吧
  

优点

总结一下优点就是，利用一套接口，淘汰了许多流程的繁琐和service的通讯等，实现多个设备大概UI的统一调用 。。 这个图得自己画


3.5、媒体会话MediaSession

媒体会话负责与播放器的所有通讯。它会对应用的其他部分潜伏播放器的 API。只能从控制播放器的媒体会话中调用播放器。
会话会维护播放器状态（播放/暂停）的表现情势以及播放内容的相关信息。会话可以吸收来自一个或多个媒体控制器的回调。如许一来，应用的界面以及搭载 Wear OS 和 Android Auto 的配套设备便可以控制您的播放器。响应回调的逻辑必须保持一致。无论由哪个客户端应用发起回调，对 MediaSession 回调的响应都应该雷同。
3.6、媒体控制器MediaController

媒体控制器会隔离您的界面。界面代码只与媒体控制器（而非播放器自己）通讯。媒体控制器会将传输控制操作转换为对媒体会话的回调。每当会话状态发生变革时，它也会吸收来自媒体会话的回调。这提供了一种主动更新关联界面的机制。一个媒体控制器一次只能连接到一个媒体会话。
当您利用媒体控制器和媒体会话时，您可以在运行时部署不同的接口和/或播放器。您可以根据运行应用的设备的功能单独更改该应用的外貌和/或性能。
3.7、视频APP中MediaSession的不同

ui + player，不能在配景播放，必然是暂停大概退出的，那么他可以是单Activity的完成，呈现视频的屏幕是Activity的一部分，如下


视频也是媒体media，那么同样可以利用MediaSession，其它的还有图片也是一样。由于视频中不须要MediaBrowserService的配景服务，所以视频app中MediaSession和MediaController连接，看下图相信你就明白了，MediaController提供了两个连接MediaSession的方式


⚠️ 注意
   两个构造方法的在最新的源码里面移除了，但不影响构建媒体类应用视频，图片，音频利用MediaSession  

---

下面开始介绍MediaSession框架的核心成员和利用流程
二、MediaSession接口

MediaSession框架相当于C/S架构

1. 1、核心类
2. 1.1 MediaBrowser
3. 2023-12-28:新增《非主线程创建MediaBrowser》
4. ⑴、MediaBrowser相关API列表（可选）
5. ⑵、MediaBrowser.ConnectionCallback
6. ⑶、MediaBrowser.ItemCallback
7. ⑷、MediaBrowser.MediaItem
8. ⑸、MediaBrowser.SubscriptionCallback
10. 1.2、MediaBrowserService
11. ⑴、MediaBrowserService相关API列表（可选）
12. ⑵、MediaBrowserService.BrowserRoot
13. ⑶、MediaBrowserService.Result
15. 1.3、MediaSession
16. ⑴、MediaSession相关API列表（可选）
17. ⑵、MediaSession.Callback
18. ⑶、MediaSession.QueueItem
19. ⑷、MediaSession.Token
21. 1.4、MediaController
22. ⑴、MediaController相关组件API列表（可选）
23. ⑵、MediaController.Callback
24. ⑶、MediaController.PlaybackInfo
25. ⑷、MediaController.TransportControls
27. 2、其它相关API
28. 2.1、播放器状态 - PlaybackState
29. ⑴、PlaybackState相关组件API列表（可选）
30. ⑵、PlaybackState.Builder
31. ⑶、PlaybackState.CustomAction
33. 2.2、元数据类 - MediaMetadata
34. ⑴、MediaMetadata API 说明
35. ⑵、MediaMetadata 常用Key
37. 2.3、MediaDescription
39. 3、连接订阅/数据加载/媒体控制的流程
40. 3.1、连接订阅
41. 3.2、数据加载
42. 3.3、媒体控制
44. 4、MediaSession实战项⽬接⼝对照表
45. 4.1、MediaSession API对照关系
46. 4.2、实战项⽬ExternalService对照表

复制代码

1、核心类

MediaSession框架中有四个常用的成员类，MediaBrowser、MediaBrowserService、MediaSession、MediaController，它们是MediaSession整个流程控制的核心

1.1、MediaBrowser

媒体欣赏器、就是Client，用来连接MediaBrowserService服务端（Server）、调用它的onGetRoot()方法，在连接成功的结果回调后，获取token（配对令牌），并以此得到MediaController媒体控制器，在它的回调接口中可以获取和Service的连接状态以及获取在Service中异步获取的音乐库数据。然后可以有订阅并设置订阅信息回调功能来订阅数据
媒体欣赏器一样平常创建于客户端（Client APP）（可以理解为各个终端负责控制音乐播放的界面）中，不是线程安全的，所有调用都应在构造MediaBrowser的线程上进行

1. override fun onCreate(savedInstanceState: Bundle?) {
2.     super.onCreate(savedInstanceState)
3.     setContentView(R.layout.activity_main)
5.     //MediaService继承于MediaBrowserService
6.     val component = ComponentName(this, MediaService::class.java)
7.     //新建MediaBrowser,第一个参数是context
8.     //第二个参数是CompoentName,有多种构造方法,指向要连接的服务
9.     //第三个参数是连接结果的回调connectionCallback，第四个参数为Bundle
10.     mMediaBrowser = MediaBrowser(this, component, connectionCallback, null);
11.     mMediaBrowser.connect()
12. }

复制代码

2023-12-28：新增《非主线程创建MediaBrowser》

非主线程创建MediaBrowser并connect的时候会报错。这是因为连接时底层代码会利用Handler，并且接纳Handler handler = new Handler()的创建方式，如此利用必然会报错。解决办法：

1. Looper.prepare()
2. mMediaBrowser = MediaBrowser(BaseApplication.getInstance(),
3.         //绑定服务，这里绑定的是系统蓝牙音乐的核心服务，a2dp为蓝牙的一个协议
4.         new ComponentName("com.android.bluetooth",
5.         "com.android.bluetooth.a2dpsink.mbs.A2dpMediaBrowserService"),
6.         connectionCallback,//关联连接回调
7.         null)
8. mMediaBrowser.connect()
9. Looper.loop()

复制代码

⑴、MediaBrowser相关API列表（可选）

除了上面刚用到的connect()以外，其它MediaBrowser的API如下所示：
方法名阐明void connect()连接到媒体欣赏器服务void disconnect()断开与媒体欣赏器服务的连接Bundle getExtras()获取介质服务的任何附加信息void getItem(String mediaId, MediaBrowser.ItemCallback cb)从连接的服务中检索特定的MediaItemString getRoot()获取根IDComponentName getServiceComponent()获取媒体欣赏器连接到的服务组件MediaSession.Token getSessionToken()获取与媒体欣赏器关联的媒体会话Tokenboolean isConnected()返回欣赏器是否连接到服务void subscribe(String parentId,Bundle options, MediaBrowser.SubscriptionCallback callback)利用特定于服务的参数进行查询，以获取有关指定 ID 中包含的媒体项的信息，并订阅以在更新更改时吸收更新void subscribe(String parentId, MediaBrowser.SubscriptionCallback callback)询有关包含在指定 ID 中的媒体项的信息，并订阅以在更改时吸收更新void unsubscribe(String parentId)取消订阅指定媒体 IDvoid unsubscribe(String parentId, MediaBrowser.SubscriptionCallback callback)通过回调取消订阅对指定媒体 ID ⑵、MediaBrowser.ConnectionCallback

吸收与MediaBrowserService连接状态的回调，在创建MediaBrowser时传入，当MediaBrowser向service发起连接请求后，请求结果将在这个ConnectionCallback中返回，获取到的meidaId对应服务端在onGetRoot()函数中设置的mediaId，假如连接成功那么就可以做创建媒体控制器之类的操作了

1. override fun onCreate(savedInstanceState: Bundle?) {
2.     super.onCreate(savedInstanceState)
3.     setContentView(R.layout.activity_main)
5.     val component = ComponentName(this, MediaService::class.java)//MediaService继承于MediaBrowserService
6.     mMediaBrowser = MediaBrowser(this, component, connectionCallback, null);
7.     mMediaBrowser.connect()
8. }
9. //连接结果的回调
10. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
11.     override fun onConnected() {
12.       //与MediaBrowserService连接成功。在调用MediaBrowser.connect()后才会有回调。
13.         super.onConnected()
14.     }
16.     override fun onConnectionFailed() {
17.       //与MediaBrowserService连接失败。比如onGetRoot返回null
18.         super.onConnectionFailed()
19.     }
21.     override fun onConnectionSuspended() {
22.       //与MediaBrowserService连接断开。进程死掉
23.         super.onConnectionSuspended()
24.     }
25. }

复制代码

⑶、MediaBrowser.ItemCallback

用于接受调用MediaBrowser.getItem()后，MediaService返回的结果。媒体控制器MediaController负责向service中session发送例如播放暂停之类的指令的，这些指令的执行结果将在这个ItemCallback回调中返回，可重写的函数有许多，比如播放状态的改变，音乐信息的改变等

1. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
2.     override fun onConnected() {
3.         super.onConnected()
4.         // ...
5.         if(mMediaBrowser.isConnected) {
6.             val mediaId = mMediaBrowser.root
7.             mMediaBrowser.getItem(mediaId, itemCallback)
8.         }
9.     }
10. }
12. @RequiresApi(Build.VERSION_CODES.M)
13. private val itemCallback = object : MediaBrowser.ItemCallback(){
14.     override fun onItemLoaded(item: MediaBrowser.MediaItem?) {
15.       //返回Item时调用
16.         super.onItemLoaded(item)
17.     }
19.     override fun onError(mediaId: String) {
20.       //检索时出错，或者连接的服务不支持时回调
21.         super.onError(mediaId)
22.     }
23. }

复制代码

⑷、MediaBrowser.MediaItem

包含有关单个媒体项的信息，用于欣赏/搜刮媒体。MediaItem依靠于服务端提供，因此框架自己无法保证它包含的值都是正确的
方法名阐明int describeContents()描述此可打包实例的封送处理表现中包含的特别对象的种类MediaDescription getDescription()获取介质的阐明。包含媒体的基础信息如：标题、封面等等int getFlags()获取项的标记。FLAG_BROWSABLE：表现Item具有自己的子项（是一个文件夹）。FLAG_PLAYABLE：表现Item可播放String getMediaId()返回此项的媒体 IDboolean isBrowsable()返回此项目是否可欣赏boolean isPlayable()返回此项是否可播放 ⚠️ 紧张
   FLAG_BROWSABLE：表现Item具有自己的子项（是一个文件夹）FLAG_PLAYABLE：表现Item可播放。这对于MediaBrowserTree理解很有帮助  p.s. 注意区别：媒体信息对象 MediaMetadata、MediaSession.QueueItem、MediaBrowser.MediaItem、MediaDescription（背面提到的都在这里）

• MediaSession.QueueItem比MediaMetadata《2、其它API》多了一个唯一的id
  
• MediaBrowser.MediaItem跟MediaSession.QueueItem很相似，不同的是唯一的id，酿成了flags
  

相互转换的代码：

1. //构建，传入MediaDescription 和id
2. MediaDescription description = new MediaDescription.Builder()
3.                 .setMediaId(song.mediaId)
4.                 .setTitle(song.title)
5.                 .setSubtitle(song.subtitle)
6.                 .setExtras(bundle)
7.                 .build();
8. QueueItem queueItem = new QueueItem(description, song.queueId);
9. //MediaMetadata转化为QueueItem
10. QueueItem queueItem = new QueueItem(mediaMetadata.getDescription(), id);
11. //解析跟MediaMetadata一样，获取MediaDescription
12. MediaDescription description = queueItem.getDescription();
13. //获取标题
14. String title = description.getTitle().toString();
16. //....................分割线.........................
18. //MediaMetadata转化为MediaItem,构造方法第一个都是MediaDescription,第二个是flags
19. MediaBrowser.MediaItem mediaItem = new MediaBrowser.MediaItem(metadata.getDescription(), MediaBrowser.MediaItem.FLAG_PLAYABLE);
20. //解析一样用MediaDescription
21. MediaDescription description = queueItem.getDescription();
22. //获取标题
23. String title = description.getTitle().toString();

复制代码

⑸、MediaBrowser.SubscriptionCallback

连接成功后，起首客户端调用subscribe()订阅MediaBrowserService服务，同样还须要注册订阅回调，订阅成功的话服务端可以返回一个音乐信息的序列，可以在客户端展示获取的音乐列表数据MediaBrowser.MediaItem
下面这就是订阅MediaBrowserService中MediaBrowser.MediaItem列表变革的回调

1. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
2.     override fun onConnected() {
3.         super.onConnected()
4.         // ...
5.         if(mMediaBrowser.isConnected) {
6.             val mediaId = mMediaBrowser.root
7.             // 重复订阅会报错，所以先解除订阅  这样可以进行异步数据回调
8.             mMediaBrowser.unsubscribe(mediaId)
9.             //第一个参数是String类型的parentId(标识)
10.             //第二个参数为订阅的回调MediaBrowser.SubscriptionCallback
11.             // 服务端会调用onLoadChildren
12.             mMediaBrowser.subscribe(mediaId, subscribeCallback)
13.         }
14.     }
15. }
17. private val subscribeCallback = object : MediaBrowser.SubscriptionCallback(){
18.     override fun onChildrenLoaded(parentId: String,children: MutableList<MediaBrowser.MediaItem>) {
19.       //在客户端调用mMediaBrowser.subscribe()，服务端MediaBrowserService会调用onLoadChildren()，服务端会去browse()浏览数据。
20.       //浏览完后，加载或更新子项列表时 服务端调用result.sendResult()方法（详见二.MediaSession接口1.2MediaBrowserService.(二)、MediaBrowserService.Result<T>中），会回调到客户端这里。下同
21.         super.onChildrenLoaded(parentId, children)
22.     }
24.     override fun onChildrenLoaded(parentId: String,children: MutableList<MediaBrowser.MediaItem>,options: Bundle) {
25.         super.onChildrenLoaded(parentId, children, options)
26.     }
28.     override fun onError(parentId: String) {
29.       //当 ID 不存在或订阅时出现其他错误时回调。下同
30.         super.onError(parentId)
31.     }
33.     override fun onError(parentId: String, options: Bundle) {
34.         super.onError(parentId, options)
35.     }
36. }

复制代码

⚠️ 紧张

• onChildrenLoaded() 是MediaBrowser客户端的方法
  
• onLoadChildren() 是MediaBrowserService服务端的方法
  
• 不能重复订阅雷同parentId的，会报错，建议订阅时都先做解除订阅操作
  
• 在 mMediaBrowser.subscribe(…)方法中，可以添加第三个Bundle参数，此时回调到同存在Bundle参数的onChildrenLoaded(…)方法中，注意别弄错了回调方法
  

1.2、MediaBrowserService



媒体欣赏器服务MediaBrowserService继承自Service，MediaBrowserService属于服务端。提供onGetRoot（接受客户端媒体欣赏器MediaBrowser的连接请求，通过返回值决定是否允许该客户端连接服务）和onLoadChildren（媒体欣赏器MediaBrowser向Service发送数据订阅时调用，一样平常在这执行异步获取数据的操作，最后将数据发送至媒体欣赏器的回调接口onChildrenLoaded()中）这两个抽象方法

• 一样平常在onCreate()中用setSessionToken(...)来设置token。在重写的onGetRoot(…)中判断是否允许连接，在onLoadChildren(…)中处理订阅信息
  
• 同时MediaBrowserService还作为承载媒体播放器（如MediaPlayer、ExoPlayer等）和MediaSession的容器。也就是可以在这里创建Player
  

客户端调用MediaBrowser.subscribe时会触发onLoadChildren方法

1. const val FOLDERS_ID = "__FOLDERS__"
2. const val ARTISTS_ID = "__ARTISTS__"
3. const val ALBUMS_ID = "__ALBUMS__"
4. const val GENRES_ID = "__GENRES__"
5. const val ROOT_ID = "__ROOT__"
7. class MediaService : MediaBrowserService() {
8.     // 获取供特定客户端浏览的根信息，控制是否允许客户端连接，并返回root media id给客户端
9.     override fun onGetRoot(clientPackageName: String,clientUid: Int,rootHints: Bundle?): BrowserRoot? {
10.         //由MediaBrowser.connect触发，可以通过返回null拒绝客户端的连接
11.         return BrowserRoot(ROOT_ID, null)
12.     }
13.     // 处理客户端的订阅信息，由MediaBrowser.subscribe触发
14.     override fun onLoadChildren(parentId: String,result: Result<MutableList<MediaBrowser.MediaItem>>) {
15.       //获取有关媒体项的子项的信息。由MediaBrowser.subscribe触发
16.       //一般在这执行**异步获取数据**的操作，最后将数据通过sendResult()发送至MediaBrowser.SubscriptionCallback(如上面↑↑↑<1.1、MediaBrowser#⑷、MediaBrowser.SubscriptionCallback>)的回调接口中
17.         val mediaItems = arrayList<MediaBrowser.MediaItem>()
18.         when (parentId) {
19.             ROOT_ID -> {
20.                 // 查询本地媒体库
21.                 // ...
22.                 // 将此消息与当前线程分离，并允许稍后进行sendResult调用
23.                 result.detach()
24.                 //发送数据，他会回调客户端的onChildrenLoaded()方法
25.                 result.sendResult()
26.             }
27.             FOLDERS_ID -> {
29.             }
30.             ALBUMS_ID -> {
32.             }
33.             ARTISTS_ID -> {
35.             }
36.             GENRES_ID -> {
38.             }
39.             MEDIA_ID_ROOT -> {
41.             }
42.             PARENT_ID_1 -> {
43.                 //模拟数据
44.                 val metadata = MediaMeadata.Builder().putString(MediaMetadata.METADATA_KEY_MEDIA_ID, "101")
45.                 .putString(MediaMetadata.METADATA_KEY_TITLE, "一首歌").build()
46.                 mediaItems.add(MediaBrowser.MediaItem(metadata.getDescription(),
47.                                             MediaBrowser.MediaItem.FLAG_PLAYABLE))
48.             }
49.             else -> {
51.             }
52.         }
53.     }
54.     //获取有关特定媒体项的信息。由MediaBrowser.getItem触发。
55.     override fun onLoadItem(itemId: String?, result: Result<MediaBrowser.MediaItem>?) {
56.         super.onLoadItem(itemId, result)
57.         Log.e("TAG", "onLoadItem: $itemId")
58.         // 根据itemId，返回对用MediaItem
59.         result?.detach()
60.         result?.sendResult(null)
61.     }
62. }

复制代码

然后还须要在manifest中注册这个Service

1. <service
2.     android:name=".MediaService"
3.     android:label="@string/service_name">
4.     <intent-filter>
5.         <action android:name="android.media.browse.MediaBrowserService" />
6.     </intent-filter>
7. </service>

复制代码

⑴、MediaBrowserService相关API列表（可选）

MediaBrowserService除了上面onGetRoot、onLoadChildren、onLoadItem方法，其它相关组件API如下所示：
方法名阐明final Bundle getBrowserRootHints()获取从当前连接MediaBrowser的发送的根提示final MediaSessionManager.RemoteUserInfo getCurrentBrowserInfo()获取发送当前请求的欣赏器信息MediaSession.Token getSessionToken()获取会话令牌，假如尚未创建会话令牌或已销毁会话令牌，则获取 nullvoid notifyChildrenChanged(String parentId)通知所有连接的媒体欣赏器指定父 ID 的子级已经更改void notifyChildrenChanged(String parentId, Bundle options)通知所有连接的媒体欣赏器指定父 ID 的子级已经更改void onLoadChildren(String parentId, Result> result,Bundle options)获取有关媒体项的子项的信息。由MediaBrowser.subscribe触发void setSessionToken(MediaSession.Token token)设置媒体会话 ⚠️ 注意 有两个方法比力类似：

• mMediaBrowser.getItem(rootMediaId,itemCallback)，会触发MediaBrowserService.onLoadItem方法来获取根mediaId的item列表
  
• 订阅之前须要先unsubscribe
  

1. MediaBrowser.unsubscribe(rootMediaId)
2. // media item的改变，会触发服务端MediaBrowserService.onLoadChildren方法
3. mMediaBrowser.subscribe(rootMediaId, subscribeCallback)

复制代码

• 服务端重写的onLoadChildren(…)用作订阅不同parentId返回不同的媒体数据。别的进行订阅后，服务端可以通过notifyChildrenChanged(String parentId)发送消息来进行回调自己的onLocadChildren()
  
• 服务端MediaBrowserService可以直接利用notifyChildrenChanged(String)，内部会触发MediaBrowserService自己的onLocadChildren()方法，并回调数据。假如客户端订阅了对应parentId,那么在MediaBrowser.SubscriptionCallback中就能收到媒体数据
  

1. notifyChildrenChanged("parentId_1");

复制代码

p.s. 紧张：所以这里得出一个结论：onLocadChildren()有两种方式可以触发

• 1、当客户端调用MediaBrowser.subscribe(rootMediaId, subscribeCallback)时会触发onLoadChildren()方法。一样平常来说是客户端点击子项目就会触发subscribe()
  
• 2、服务端MediaBrowserService自己调用notifyChildrenChanged(String)也会触发onLoadChildren()。假如onLocadChildren在欣赏数据，那么这种情况会接着一级一级的browse数据
  

⑵、MediaBrowserService.BrowserRoot

返回包含欣赏器服务首次连接时须要发送给客户端的信息。构造函数

1. MediaBrowserService.BrowserRoot(String rootId, Bundle extras)

复制代码

它有两个方法API： getExtras()：获取有关欣赏器服务的附加信息 getRootId()：获取用于欣赏的根 ID
⑶、MediaBrowserService.Result

包含欣赏器服务返回给客户端的结果集。通过调用sendResult()将结果返回给调用方，但是在此之前须要调用detach()

• MediaBrowserService.Result API 列表
  

方法名阐明void detach()0将此消息与当火线程分离，并允许稍后进行调用sendResult(T)void sendResult(T result)将结果发送回调用方
1.3、MediaSession

媒体会话，即受控端，通过设置MediaSession.Callback回调来吸收媒体控制器MediaController发送的指令，当收到指令时会触发Callback中各个指令对应的回调方法（回调方法中会执行播放器相应的操作，如播放、暂停等）


Session一样平常在Service.onCreate方法中创建，最后须要调用上面↑↑↑<1.2、MediaBrowserService>中setSessionToken()方法设置用于和控制器配对的令牌。当媒体信息或状态改变后，可以利用形如mediaSession.setMetadata(mediaMetadata)来通知客户端

1. const val FOLDERS_ID = "__FOLDERS__"
2. const val ARTISTS_ID = "__ARTISTS__"
3. const val ALBUMS_ID = "__ALBUMS__"
4. const val GENRES_ID = "__GENRES__"
5. const val ROOT_ID = "__ROOT__"
7. class MediaService : MediaBrowserService() {
8.     private lateinit var mediaSession: MediaSession;
10.     override fun onCreate() {
11.         super.onCreate()
12.         //初始化，第一个参数为context，第二个参数为String类型tag，这里可以设置为类名
13.         mediaSession = MediaSession(this, "TAG")
14.         //设置callback，这里的callback就是客户端对服务指令到达处
15.         mediaSession.setCallback(callback)
16.         //设置token
17.         sessionToken = mediaSession.sessionToken
18.     }
20.     // 与MediaController.transportControls中的大部分方法都是一一对应的
21.     // 在该方法中实现对 播放器 的控制，
22.     private val callback = object : MediaSession.Callback() {
23.         override fun onPlay() {
24.             super.onPlay()
25.             //客户端mMediaController.getTransportControls().play()就会调用到这里，以下类推
26.             // 处理 播放器 的播放逻辑。
27.             // 车载应用，别忘了处理音频焦点requestAudoFocus()，因为有VPA，电话，抢占音频焦点
28.         }
30.         override fun onPause() {
31.             //暂停
32.             super.onPause()
33.         }
35.     }
36.     // 控制是否允许客户端连接，并返回root media id给客户端
37.     // 第一个参数为客户端的packageName，第二个参数为Uid
38.     // 第三个参数是从客户端传递过来的Bundle
39.     override fun onGetRoot(clientPackageName: String,clientUid: Int,rootHints: Bundle?): BrowserRoot? {
40.         Log.e("TAG", "onGetRoot: $rootHints")
41.         // 通过以上参数来进行判断，若同意连接，则返回BrowserRoot对象，否则返回null
43.         // 构造BrowserRoot的第一个参数为rootId(自定义)，第二个参数为Bundle;
44.         return BrowserRoot(ROOT_ID, null)
45.     }
46.     // 处理客户端的订阅信息
47.     override fun onLoadChildren(parentId: String,result: Result<MutableList<MediaBrowser.MediaItem>>) {
48.       // 由MediaBrowser.subscribe触发
49.         Log.e("TAG", "onLoadChildren: $parentId")
50.         result.detach()
51.         when (parentId) {
52.             ROOT_ID -> {
53.                 result.sendResult(null)
54.             }
55.             FOLDERS_ID -> {
57.             }
58.             ALBUMS_ID -> {
60.             }
61.             ARTISTS_ID -> {
63.             }
64.             GENRES_ID -> {
66.             }
67.             else -> {
69.             }
70.         }
71.     }
73.     override fun onLoadItem(itemId: String?, result: Result<MediaBrowser.MediaItem>?) {
74.         super.onLoadItem(itemId, result)
75.         Log.e("TAG", "onLoadItem: $itemId")
76.     }
77. }

复制代码

⑴、MediaSession相关API列表（可选）

部分方法如setExtras()与MediaController.Callback（详见下面↓↓↓<1.4、MediaController#⑵、MediaController.Callback>）中，如onExtrasChanged()，onAudioInfoChanged()逐一对应
方法名阐明MediaController getController()获取此会话的控制器MediaSessionManager.RemoteUserInfo getCurrentControllerInfo()获取发送当前请求的控制器信息MediaSession.Token getSessionToken()获取此会话令牌对象boolean isActive()获取此会话的当前活动状态void release()当应用完成播放时，必须调用此项void sendSessionEvent (String event, Bundle extras)将专有变乱发送给监听此会话的所有MediaController。会触发MediaController.Callback.onSessionEventvoid setActive(boolean active)设置此会话当前是否处于活动状态并准备好吸收下令void setCallback (MediaSession.Callback callback)设置回调以吸收媒体会话的更新void setCallback (MediaSession.Callback callback,Handler handler)设置回调以吸收媒体会话的更新void setExtras(Bundle extras)设置一些可与MediaSession关联的附加功能void setFlags(int flags)为会话设置标记void setMediaButtonBroadcastReceiver(ComponentName broadcastReceiver)设置应吸收媒体按钮的清单声明类的组件名称void setMediaButtonReceiver(PendingIntent mbr)此方法在 API 级别 31 中已弃用。改用setMediaButtonBroadcastReceiver（android.content.ComponentName）void setMetadata(MediaMetadata metadata)更新当前MediaMetadatavoid setPlaybackState(PlaybackState state)更新当前播放状态void setPlaybackToLocal(AudioAttributes attributes)设置此会话音频的属性void setPlaybackToRemote(VolumeProvider volumeProvider)将此会话设置为利用远程音量处理void setQueue(List queue)更新播放队列中的项目列表void setQueueTitle(CharSequence title)设置播放队列的标题void setRatingType(int type)设置此会话利用的评级样式void setSessionActivity(PendingIntent pi)设置启动此会话的Activity的Intent ⑵、MediaSession.Callback

吸收来自控制器MediaController和体系的媒体按钮（像方向盘上面的按钮）、传输控件和下令，如【上一曲】、【下一曲】。也是与下面↓↓↓<1.4、MediaController#⑷、MediaController.TransportControls>中方法逐一对应

1. override fun onCreate() {
2.     super.onCreate()
3.     mediaSession = MediaSession(this, "TAG")
4.     mediaSession.setCallback(callback)
5.     sessionToken = mediaSession.sessionToken
6. }
8. // 与MediaController.transportControls中的方法是一一对应的。
9. // 在该方法中实现对 播放器 的控制，
10. private val callback = object : MediaSession.Callback() {
11.     override fun onPlay() {
12.         super.onPlay()
13.         // 处理 播放器 的播放逻辑。
14.         // 车载应用的话，别忘了处理音频焦点
15.         // ...
16.         if (!mediaSession.isActive) {
17.             mediaSession.isActive = true
18.         }
19.         // 更新播放状态.
20.         val state = PlaybackState.Builder()
21.             .setState(
22.                 PlaybackState.STATE_PLAYING,1,1f
23.             )
24.             .build()
25.         // 此时MediaController.Callback.onPlaybackStateChanged会回调
26.         mediaSession.setPlaybackState(state)
27.     }
29.     override fun onPause() {
30.       //处理暂停播放的请求
31.         super.onPause()
32.     }
34.     override fun onStop() {
35.       //处理停止播放的请求
36.         super.onStop()
37.     }
38.     override fun onSkipToNext(){
39.         super.onSkipToNext();
40.         //下一首
41.         .....
42.         //通知媒体信息改变
43.         mediaSession.setMetadata(mediaMetadata)
44.     }
45. }

复制代码

❶、MediaSession.Callback相关组件API列表（可选）

除了上面提到的onPlay()，onPause()，onStop()以外，其它MediaController.transportControls回调到MediaSession.Callback的API如下所示：
方法名阐明void onCommand(String command,Bundle args,ResultReceiver cb)当控制器已向此会话发送下令时调用void onCustomAction(String action, Bundle extras)当要执行MediaController.PlaybackState.CustomAction时调用。对应客户端 mMediaController.getTransportControls().sendCustomAction(...)void onFastForward()处理快进请求boolean onMediaButtonEvent(Intent mediaButtonIntent)当按下媒体按钮并且此会话具有最高优先级或控制器向会话发送媒体按钮变乱时调用void onPlayFromMediaId(String mediaId, Bundle extras)处理播放应用提供的特定mediaId的播放请求void onPlayFromSearch(String query, Bundle extras)处理从搜刮查询开始播放的请求void onPlayFromUri(Uri uri, Bundle extras)处理播放由URI表现的特定媒体项的请求void onPrepare()处理准备播放的请求void onPrepareFromMediaId(String mediaId, Bundle extras)处理应用提供的特定mediaId的准备播放请求void onPrepareFromSearch(String query, Bundle extras)处理准备从搜刮查询播放的请求void onPrepareFromUri(Uri uri, Bundle extras)处理由URI表现的特定媒体项的准备请求void onRewind()处理倒带请求void onSeekTo(long pos)处理跳转到特定位置的请求void onSetPlaybackSpeed(float speed)处理修改播放速度的请求void onSetRating(Rating rating)处理设定评级的请求void onSetRating(RatingCompat rating, Bundle extras)处理设定评级的请求。可以用extras接受如mediaId等参数void onSkipToNext()处理要跳到下一个媒体项的请求void onSkipToPrevious()处理要跳到上一个媒体项的请求void onSkipToQueueItem(long id)处理跳转到播放队列中具有给定 ID 的项目的请求 ⑶、MediaSession.QueueItem

作为播放队列一部分的单个项目。相比MediaMetadata多了一个ID属性
❶、MediaSession.QueueItem相关组件API列表（可选）


方法名阐明MediaDescription getDescription()返回介质的阐明。包含媒体的基础信息如：标题、封面等等long getQueueId()获取此项目的队列 ID ⑷、MediaSession.Token

表现正在进行的会话。可以通过会话所有者通报给客户端，以允许客户端与服务端之间创建通讯
1.4、MediaController

媒体控制器，在客户端中开发者不仅可以利用控制器向Service中的受控端发送指令（播放、暂停），还可以通过设置MediaController.Callback回调方法吸收MediaSession受控端的状态，从而根据相应的状态刷新界面UI。MediaController的创建须要受控端的配对令牌，因此需在MediaBrowser成功连接服务的回调执行创建的操作，媒体控制器是线程安全的
   如用mMediaController.getTransportControls().skipToNext()来发送播放下一曲的控制指令；也可以用mMediaController.getMetadata()等方法来主动获取媒体信息  

MediaController还有一个关联的权限android.permission.MEDIA_CONTENT_CONTROL（不是必须加的权限）必须是体系级应用才可以获取，荣幸的是车载应用一样平常都是体系级应用。（但是我们公司项目中在
上面谷歌对于OEM体系的权限收紧后，我们的MCS服务不能放在/system/priv-app/下面，后来统一修改到vendor后就不能工作了，这种情况就须要加上相应的权限）。MediaController必须在MediaBrowser连接成功后才可以创建

1. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
3.     override fun onConnected() {
4.         super.onConnected()
5.         // ...
6.         if(mMediaBrowser.isConnected) {
7.             //获取配对令牌
8.             val sessionToken = mMediaBrowser.sessionToken
9.             //通过token，获取MediaController,第一个参数是context，第二个参数为token
10.             mMediaController = MediaController(applicationContext,sessionToken)
11.         }
12.     }
13. }

复制代码

⑴、MediaController相关组件API列表（可选）


方法名阐明void adjustVolume (int direction, int flags)调解此会话正在播放的输出的音量boolean dispatchMediaButtonEvent (KeyEvent keyEvent)将指定的媒体按钮变乱发送到会话Bundle getExtras()获取此会话的附加内容long getFlags()获取此会话的标记MediaMetadata getMetadata()获取此会话的当前MetadataString getPackageName()获取会话所有者的程序包名称MediaController.PlaybackInfo getPlaybackInfo()获取此会话的当前播放信息PlaybackState getPlaybackState()获取此会话的当前播放状态List getQueue()获取此会话的当前播放队列（假如已设置）CharSequence getQueueTitle()获取此会话的队列标题int getRatingType()获取会话支持的评级类型PendingIntent getSessionActivity()获取启动与此会话关联的 UI 的意图（假如存在）Bundle getSessionInfo()获取创建会话时设置的其他会话信息MediaSession.Token getSessionToken()获取连接到的会话的令牌String getTag()获取会话的标记以进行调试MediaController.TransportControls getTransportControls()获取TransportControls实例以将控制操作发送到关联的会话void registerCallback (MediaController.Callback callback, Handler handler)注册回调以从会话吸收更新void registerCallback (MediaController.Callback callback)注册回调以从会话吸收更新void sendCommand (String command, Bundle args, ResultReceiver cb)向会话发送通用下令void setVolumeTo (int value, int flags)设置此会话正在播放的输出的音量void unregisterCallback (MediaController.Callback callback)注销指定的回调 ⑵、MediaController.Callback

用于从MediaSession吸收回调，它也是与上面↑↑↑<1.3、MediaSession#⑴、MediaSession相关组件API列表>的接口逐一对应

1. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
2.     override fun onConnected() {
3.         super.onConnected()
4.         // ...
5.         if(mMediaBrowser.isConnected) {
6.             val sessionToken = mMediaBrowser.sessionToken
7.             mMediaController = MediaController(applicationContext,sessionToken)
8.             //mediaController注册回调，callback就是媒体信息改变后，服务给客户端的回调
9.             mMediaController.registerCallback(controllerCallback)
10.         }
11.     }
12. }
13. //服务对客户端的信息回调
14. private val controllerCallback = object : MediaController.Callback() {
15.     //音频信息，音量
16.     override fun onAudioInfoChanged(info: MediaController.PlaybackInfo?) {
17.       //当前音频信息发生改变。
18.         super.onAudioInfoChanged(info)
19.         val currentVolume = info?.currentVolume
20.         // 显示在 UI 上
21.     }
23.     override fun onExtrasChanged(extras: Bundle?) {
24.       //当前附加内容发生改变。
25.         super.onExtrasChanged(extras)
26.         val artUri = metadata?.getString(MediaMetadata.METADATA_KEY_ALBUM_ART_URI)
27.         // 显示 UI 上
28.     }
29.     // ...
30. }

复制代码

这里我们取得了mMediaController，并且注册了一个回调，用于知晓服务端通知的媒体信息变更。在背面的代码中，就可以用mMediaController为所欲了（内容太多了，皮一下(^_^)，没打错）

1. //在需要的地方使用以下代码
2. //控制媒体服务的一些方法，播放、暂停、上下首、跳转某个时间点...
3. // 更多参考下面↓↓↓<1.4、MediaController#⑷、MediaController.TransportControls>的内容
4. mMediaController.transportControls.play()
5. mMediaController.transportControls.pause()
6. mMediaController.transportControls.skipToPrevious()
7. mMediaController.transportControls.skipToNext()
8. mMediaController.transportControls.seekTo(...)
9. ....
10. //主动获取媒体信息的一些操作，获取媒体信息，播放状态...
11. // 下面↓↓↓<2、其它API#⑷、PlaybackState>的内容
12. val metadata = mMediaController.metadata
13. val playbackState = mMediaController.playbackState
14. ....

复制代码

❶、MediaController.Callback相关组件API列表（可选）

除了上面onAudioInfoChanged()、onExtrasChanged两个方法，其它相关API列表
方法名阐明void onMetadataChanged (MediaMetadata metadata)当前Metadata发生改变。服务端运行mediaSession.setMetadata(mediaMetadata)就会到达此处，以下类推void onPlaybackStateChanged(PlaybackState state)当前播放状态发生改变。客户端通过该回调来表现界面上音视频的播放状态void onQueueChanged (List queue)当前队列中项目发生改变void onQueueTitleChanged (CharSequence title)当前队列标题发生改变void onSessionDestroyed()会话销毁void onSessionEvent (String event, Bundle extras)MediaSession所有者发送的自定义变乱 ⚠️ 注意：这里表明一下

• onMetadataChange(MediaMetadataCompat mediaMetadata)比如收藏状态，歌曲的歌名改变，播放切歌，（switch play list）等都会触发该方法
  
• onSessionEvent(String event, Bundle extras)切源，比如正在播放CarPlay的歌曲，然后插上了U盘，切放播放源（source list）这种场景会触发该方法
  
• 项目中有时候会将这个方法起名为：onActiveSourceChange()//表现活动的源变革了；同样的看到还有SessionChange()类似如许的方法也是指会话发生了变革
  
• 在谷歌MediaSessionManager中有：addOnActiveSessionsChangedListener(listener)
  

❷、其它逻辑处理

另外比如要处理一些逻辑上的标题
   当两个源切换的时候，肯定会触发SessionChange相关的回调。假如先前的源存在，那么就会将先前的源的Controller设置为false，再将当前源的Controller设置为true，因为播放的时候，每个源都会有一个Controller  详细的案例可以本公司的：ExternalMediaServer中MediaSessionController.java。Trigger Session Change false for previous Source if previous source exists. 都会调用notifySessionChange(MediaController mc, boolean flag)
⑶、MediaController.PlaybackInfo

保存有关当前播放以及怎样处理此会话的音频的信息，也可以获取当前播放的音频信息，包含播放的进度、时长等

1. // 获取当前回话播放的音频信息
2. val playbackInfo = mMediaController.playbackInfo

复制代码

❶、MediaController.PlaybackInfo相关组件API列表（可选）

除了上面onAudioInfoChanged()、onExtrasChanged两个方法，其它相关API列表
方法名阐明AudioAttributes getAudioAttributes()获取此会话的音频属性int getCurrentVolume()获取此会话的当前音量int getMaxVolume()获取可为此会话设置的最大音量int getPlaybackType()获取影响音量处理的播放类型int getVolumeControl()获取可以利用的音量控件的类型String getVolumeControlId()获取此会话的音量控制 ID ⑷、MediaController.TransportControls

用于控制MediaSession会话中媒体播放的接口。这允许客户端利用控制器MediaController，来发送如体系的媒体按钮（像方向盘上面的按钮）、下令（如【上一曲】、【下一曲】）和传输控件到MediaSession。它也与MediaSession.Callback（上面↑↑↑<二.1.3、MediaSession#MediaSession.Callback>）中方法一对应

1. private val connectionCallback = object : MediaBrowser.ConnectionCallback() {
3.     override fun onConnected() {
4.         super.onConnected()
5.         // ...
6.         if(mMediaBrowser.isConnected) {
7.             val sessionToken = mMediaBrowser.sessionToken
8.             mMediaController = MediaController(applicationContext,sessionToken)
9.             // 请求播放器在其当前位置开始播放。
10.             mMediaController.transportControls.play()
11.             // 请求播放器暂停播放并保持在当前位置。
12.             mMediaController.transportControls.pause()
13.         }
14.     }
15. }

复制代码

❶、MediaController.TransportControls相关组件API列表（可选）

除了上面play()和pause()两个方法以外，其它API如下所示
方法名阐明void fastForward()开始快进void playFromMediaId (String mediaId, Bundle extras)请求播放器开始播放特定媒体 IDvoid playFromSearch (String query, Bundle extras)请求播放器开始播放特定的搜刮查询void playFromUri (Uri uri, Bundle extras)请求播放器开始播放特定Urivoid prepare()请求播放器准备播放void prepareFromMediaId (String mediaId, Bundle extras)请求播放器为特定媒体 ID 准备播放void prepareFromSearch (String query, Bundle extras)请求播放器为特定搜刮查询准备播放void prepareFromUri (Uri uri, Bundle extras)请求播放器为特定Urivoid rewind()开始倒退void seekTo(long pos)移动到媒体流中的新位置void sendCustomAction (PlaybackState.CustomAction customAction, Bundle args)发送自定义操作以供MediaSession执行void sendCustomAction (String action,Bundle args)将自定义操作中的 id 和 args 发送回去，以便MediaSession执行void setPlaybackSpeed (float speed)设置播放速度void setRating(Rating rating)对当前内容进行评级void setRating(RatingCompat rating, Bundle extras)对当前内容进行评级，可以用extras通报如mediaId等参数void skipToNext()跳到下一项void skipToPrevious()跳到上一项void skipToQueueItem(long id)在播放队列中播放具有特定 ID 的项目void stop()请求播放器停止播放;它可以以任何适当的方式清除其状态 2、其它相关API

MediaSession框架中还有一些同样紧张的类

• 封装了各种播放状态的PlaybackState，PlaybackState类为我们定义了各种状态的规范
  
• 与Map相似通过键值对保存媒体信息的MediaMetadata
  
• 在MediaBrowser和MediaBrowserService之间进行数据交互的MediaItem（见上面↑↑↑<二、1.1、MediaBrowser#⑷、MediaBrowser.MediaItem>的内容）
  

2.1、播放器状态 - PlaybackState



用于承载播放状态的类。如当前播放位置和当前控制功能。在MediaSession.Callback更改状态后须要调用MediaSession.setPlaybackState把状态同步给客户端，回调客户端的MediaController.Callback的onPlaybackStateChanged()

1. private val callback = object : MediaSession.Callback() {
2.     override fun onPlay() {
3.         super.onPlay()
4.         // ...
5.         // 更新状态
6.         val state = PlaybackState.Builder()
7.             .setState(
8.                 PlaybackState.STATE_PLAYING,1,1f
9.             )
10.             .build()
11.         mediaSession.setPlaybackState(state)
12.     }
13. }

复制代码

⑴、PlaybackState相关组件API列表（可选）


方法名阐明long getActions()获取此会话上可用的当前操作long getActiveQueueItemId()获取队列中当前活动项的 IDlong getBufferedPosition()获取当前缓冲位置（以毫秒为单位）List getCustomActions()获取自定义操作的列表CharSequence getErrorMessage()获取用户可读的错误消息Bundle getExtras()获取在此播放状态下设置的任何自定义附加内容getLastPositionUpdateTime获取上次更新位置的经过的实时时间float getPlaybackSpeed()获取当前播放速度作为正常播放的倍数long getPosition()获取当前播放位置（以毫秒为单位）int getState()获取当前播放状态boolean isActive()返回是否将其视为活动播放状态 ⑵、PlaybackState.Builder

PlaybackState.Builder 紧张用来创建 PlaybackState 对象，创建它利用的是建造者模式

1. //PlaybackState的构建
2. PlaybackState state = new PlaybackState.Builder()
3.         //三个参数分别是，状态，位置，播放速度
4.         .setState(PlaybackState.STATE_PLAYING,
5.                 mMediaPlayer.getCurrentPosition(), PLAYBACK_SPEED)
6.         .setActions(PLAYING_ACTIONS)
7.         .addCustomAction(mShuffle)
8.         .setActiveQueueItemId(mQueue.get(mCurrentQueueIdx).getQueueId())
9.         .build();

复制代码

❶、PlaybackState.Builder相关组件API列表（可选）


方法名阐明PlaybackState.Builder addCustomAction(String action, String name, int icon)将自定义操作添加到播放状态PlaybackState.Builder addCustomAction (PlaybackState.CustomAction customAction)将自定义操作添加到播放状态PlaybackState.Builder setActions(long actions)设置此会话上可用的当前操作PlaybackState.Builder setActiveQueueItemId(long id)通过指定活动项目的 id 来设置播放队列中的活动项目PlaybackState.Builder setBufferedPosition(long bufferedPosition)设置当前缓冲位置（以毫秒为单位）PlaybackState.Builder setErrorMessage(CharSequence error)设置用户可读的错误消息PlaybackState.Builder setExtras(Bundle extras)设置要包含在播放状态中的任何自定义附加内容PlaybackState.Builder setState(int state, long position, float playbackSpeed)设置当前播放状态，三个参数分别是，状态，位置，播放速度，他会调用下面这个同名方法默认更新时间为开机时间PlaybackState.Builder setState(int state, long position, float playbackSpeed, long updateTime)设置当前播放状态，四个参数分别是，状态，位置，播放速度，更新时间PlaybackState build()天生并返回具有这些值的PlaybackState实例 ❷、MediaController.Callback PlaybackState的解析

1. //PlaybackState的解析
2. private MediaController.Callback mCallBack = new MediaController.Callback() {
3.      ....
4.      @Override
5.      public void onPlaybackStateChanged(PlaybackState playbackState) {
6.         super.onPlaybackStateChanged(state);
7.         //获得进度时长
8.         long position = playbackState.getPosition();
10.         //获得当前状态
11.         switch(playbackState.getState()){
12.             case PlaybackState.STATE_PLAYING:
13.                 //正在播放
14.                 ...
15.                 break;
16.             case PlaybackState.STATE_PAUSED:
17.                 //暂停
18.                 ...
19.                 break;
20.             case PlaybackState.ACTION_SKIP_TO_NEXT:
21.                 //跳到下一首
22.                 ...
23.                 break;
24.             ...//还有很多状态标志,按需求添加
25.         }
26.     }
27. }

复制代码

⚠️ 注意

• 播放进度的获取须要详细逻辑进行计算，客户端和服务端逻辑统一就可以了。 简单的直接通过position表现播放进度也是ok的
  

⑶、PlaybackState.CustomAction

CustomActions可用于通过将特定于应用程序的操作发送给MediaControllers，如许就可以扩展标准传输控件的功能

1. CustomAction action = new CustomAction
2.         .Builder("android.car.media.localmediaplayer.shuffle",
3.         mContext.getString(R.string.shuffle),
4.         R.drawable.shuffle)
5.         .build();
7. PlaybackState state = new PlaybackState.Builder()
8.         .setState(PlaybackState.STATE_PLAYING,
9.                 mMediaPlayer.getCurrentPosition(), PLAYBACK_SPEED)
10.         .setActions(PLAYING_ACTIONS)
11.         .addCustomAction(action)
12.         .setActiveQueueItemId(mQueue.get(mCurrentQueueIdx).getQueueId())
13.         .build();

复制代码

• PlaybackState.CustomAction API 阐明
  

方法名阐明String getAction()返回CustomAction的actionBundle getExtras()返回附加项，这些附加项提供有关操作的其他特定于应用程序的信息，假如没有，则返回 nullint getIcon()返回package中图标的资源 IDCharSequence getName()返回此操作的表现名称
2.2、元数据类 - MediaMetadata

和Map相似通过键值对保存媒体信息，包含有关项目的基础数据，例如标题、艺术家、专辑名、总时长等。一样平常须要服务端从本地数据库或远端查询出原始数据在封装成MediaMetadata再通过MediaSession.setMetadata(metadata)返回到客户端的MediaController.Callback.onMetadataChanged中
注意与MediaSession.QueueItem、MediaBrowser.MediaItem之间的差异


⑴、MediaMetadata API 阐明


方法名阐明boolean containsKey(String key)假如给定的key包含在元数据中，则返回 trueint describeContents()描述此可打包实例的封送处理表现中包含的特别对象的种类Bitmap getBitmap(String key)返回给定的key的Bitmap;假如给定key不存在位图，则返回 nullint getBitmapDimensionLimit()获取创建此元数据时位图的宽度/高度限制（以像素为单位）MediaDescription getDescription()获取此元数据的简单阐明以进行表现long getLong(String key)返回与给定key关联的值，假如给定key不再存在，则返回 0LRating getRating(String key)对于给定的key返回Rating;假如给定key不存在Rating，则返回 nullString getString(String key)以String格式返回与给定key关联的文本值，假如给定key不存在所需类型的映射，大概null值显式与该key关联，则返回 nullCharSequence getText(String key)返回与给定键关联的值，假如给定键不存在所需类型的映射，大概与该键显式关联 null 值，则返回 nullSet keySet()返回一个 Set，此中包含在此元数据中用作key的字符串int size()返回此元数据中的字段数 ⑵、MediaMetadata 常用Key


方法名阐明METADATA_KEY_ALBUM媒体的唱片集标题METADATA_KEY_ALBUM_ART媒体原始来源的相册的插图，Bitmap格式METADATA_KEY_ALBUM_ARTIST媒体原始来源的专辑的艺术家METADATA_KEY_ALBUM_ART_URI媒体原始源的相册的图稿，Uri格式（推荐利用）METADATA_KEY_ART媒体封面，Bitmap格式METADATA_KEY_ART_URI媒体的封面，Uri格式METADATA_KEY_ARTIST媒体的艺术家METADATA_KEY_AUTHOR媒体的作者METADATA_KEY_BT_FOLDER_TYPE蓝牙 AVRCP 1.5 的 6.10.2.2 节中指定的媒体的蓝牙文件夹类型METADATA_KEY_COMPILATION媒体的编译状态METADATA_KEY_COMPOSER媒体的作曲家METADATA_KEY_DATE媒体的创建或发布日期METADATA_KEY_DISC_NUMBER介质原始来源的光盘编号METADATA_KEY_DISPLAY_DESCRIPTION适合向用户表现的阐明METADATA_KEY_DISPLAY_ICON适合向用户表现的图标或缩略图METADATA_KEY_DISPLAY_ICON_URI适合向用户表现的图标或缩略图， Uri格式METADATA_KEY_DISPLAY_SUBTITLE适合向用户表现的副标题METADATA_KEY_DISPLAY_TITLE适合向用户表现的标题METADATA_KEY_DURATION媒体的持续时间（以毫秒为单位）METADATA_KEY_GENRE媒体的流派METADATA_KEY_MEDIA_ID用于标识内容的字符串KeyMETADATA_KEY_MEDIA_URI媒体内容，Uri格式METADATA_KEY_NUM_TRACKS媒体原始源中的曲目数METADATA_KEY_RATING媒体的总体评分METADATA_KEY_TITLE媒体的标题METADATA_KEY_TRACK_NUMBER媒体的磁道编号METADATA_KEY_USER_RATING用户对媒体的分级METADATA_KEY_WRITER媒体作家METADATA_KEY_YEAR媒体创建或发布为长的年份 2.3、MediaDescription

解析媒体信息类。与MediaMetadata的作用相对应

1. Bundle bundle = new Bundle();
2. bundle.putLong(Constants.EXTRA_MEDIA_NODE_ID, node.getNodeId());
3. MediaDescriptionCompat desc = new MediaDescriptionCompat.Builder()
4.         .setMediaId(mediaId)
5.         .setIconBitmap(iconBitmap)
6.         .setMediaUri(createUri(mediaUri, mediaPath))
7.         .setTitle(mediaTitle)
8.         .setExtras(bundle)
9.         .setIconUri(thumbnail != Uri.EMPTY ? thumbnail : Uri.parse(""))
10.         .setSubtitle(getSubtitle(node, isSearching))
11.         .build();

复制代码

• 此中setIconBitmap()可以用于通报一些图片的位图，比如我们在MtpDocumentsProvider中获取到视频大概音频的缩略图，thumbli等可以放在这里面
  
• setMediaUri用于通报媒体（图片，视频，音频的）ContentUri
  

⚠️ 注意
   通过subscribe的客户端就可以通过拿到的MediaDescription来解析数据，做表现UI的操作  3、连接订阅/数据加载/媒体控制的流程

上面↑↑↑的内容根本上把MediaSession框架的所有API都理清楚和讲解清楚了，俗话说戎马未动，粮草先行。在实战之前（在下面↓↓↓<三、MediaSession构建简单的播放器>），先来画一下连接订阅、数据加载，媒体控制的大致流程，通过这个图也能帮助各人理解，和了解到开发一个媒体类别的框架设计思想思路
3.1、连接订阅



3.2、数据加载



3.3、媒体控制




4、MediaSession实战项目接口对照表

在上面↑↑↑提到了许多逐一对应的接口关系，本文内容比力重，一个个不方便，故整理一版MediaSession客户端和服务端调用方法的对照关系。在你学习一个新的东西的时候，这种整理习惯是很有用处的，比如画画图
4.1、MediaSession API对照关系

⑴、服务端类


方法名阐明android.media.session.MediaSession受控端android.media.session.MediaSession.Token配对密钥android.media.session.MediaSession.Callback受控端回调，可以接受到控制端的指令 ⑵、客户端类


方法名阐明android.media.session.MediaController控制端android.media.session.MediaController.TransportControls控制端的控制器，用于发送指令android.media.session.MediaController.Callback控制端回调，可以接受到受控端的状态android.media.browse.MediaBrowser.SubscriptionCallback订阅信息回调 ⑶、客户端调用服务端


TransportControlsMediaSession.Callback阐明play()onPlay()播放pause()onPause()暂停seekTo(long pos)onSeekTo(long)指定播放位置fastForward()onFastForward()快进rewind()onRewind()回倒skipToNext()onSkipToNext()下一首skipToPrevious()onSkipToPrevious()上一首skipToQueueItem(long)onSkipToQueueItem(long)指定id播放。指定的是Queue的idplayFromMediaId(String,Bundle)onPlayFromMediaId(String,Bundle)指定id播放。指定的是MediaMetadata的idplayFromSearch(String,Bundle)onPlayFromSearch(String,Bundle)搜刮播放。比如像globalSearch APP中可以用playFromUri(Uri,Bundle)onPlayFromUri(Uri,Bundle)指定uri播放sendCustomAction(String,Bundle)onCustomAction(String,Bundle)发送自定义动作。可用来更换播放模式、重新加载音乐列表等setRating(Rating rating)onSetRating(Rating)打分。内置的评分体系有星级、红心、赞/踩、百分比setRating(RatingCompat rating, Bundle extras)onSetRating(RatingCompat rating, Bundle extras)打分。内置的评分体系有星级、红心、赞/踩、百分比。可以用extras接受如mediaId等参数 ⑷、服务端回调至客户端


MediaSessionMediaController.Callback阐明setMetadata(MediaMetadata)onMetadataChanged(MediaMetadata)当前播放音乐setPlaybackState(PlaybackState)onPlaybackStateChanged(PlaybackState)播放状态setQueue(List MediaSession.QueueItem>)onQueueChanged(List MediaSession.QueueItem>)播放队列setQueueTitle(CharSequence)onQueueTitleChanged(CharSequence)播放队列标题setExtras(Bundle)onExtrasChanged(Bundle)额外信息。可以记录播放模式等信息sendSessionEvent(String,Bundle)onSessionEvent(String, Bundle)自定义变乱 4.2、实战项目ExternalService对照表

这是公司项目ExternalService学习中整理的MediaSession接口对照ExternalService。当时还在用support.v4


三、MediaSession构建一个简单的播放器

demo结果图如下，只提供简单的播放暂停操作，音乐数据源从raw资源文件夹中获取
1、客户端类DemoActivity.java

起首界面上方添加一个RecyclerView来展示获取的音乐列表
1.1、RecyclerView的初始化

1. public class DemoActivity extends AppCompatActivity {
2.     private RecyclerView recyclerView;
3.     private List<MediaBrowserCompat.MediaItem> list;
4.     private DemoAdapter demoAdapter;
5.     private LinearLayoutManager layoutManager;
7.     @Override
8.     protected void onCreate(Bundle savedInstanceState) {
9.         super.onCreate(savedInstanceState);
10.         setContentView(R.layout.activity_demo);
12.         list = new ArrayList<>();
13.         layoutManager = new LinearLayoutManager(this);
14.         layoutManager.setOrientation(LinearLayoutManager.VERTICAL);
15.         demoAdapter = new DemoAdapter(this,list);
17.         recyclerView = (RecyclerView) findViewById(R.id.recyclerView);
18.         recyclerView.setLayoutManager(layoutManager);
19.         recyclerView.setAdapter(demoAdapter);
20.     }
21. }

复制代码

⚠️ 注意
   注意List元素的类型为MediaBrowserCompat.MediaItem，因为MediaBrowser从服务中获取的每一首音乐都会封装成MediaItem对象  1.2、创建MediaBrowser，并执行连接服务端和订阅数据的操作

1. public class DemoActivity extends AppCompatActivity {
2.     ...
3.     private MediaBrowserCompat mBrowser;
5.     @Override
6.     protected void onCreate(Bundle savedInstanceState) {
7.         ...
8.         mBrowser = new MediaBrowserCompat(
9.                 this,
10.                 new ComponentName(this, MusicService.class),//绑定浏览器服务
11.                 BrowserConnectionCallback,//设置连接回调
12.                 null
13.         );
14.     }
16.     @Override
17.     protected void onStart() {
18.         super.onStart();
19.         //Browser发送连接请求
20.         mBrowser.connect();
21.     }
23.     @Override
24.     protected void onStop() {
25.         super.onStop();
26.         mBrowser.disconnect();
27.     }
29.     /**
30.      * 连接状态的回调接口，连接成功时会调用onConnected()方法
31.      */
32.     private MediaBrowserCompat.ConnectionCallback BrowserConnectionCallback =
33.             new MediaBrowserCompat.ConnectionCallback(){
34.                 @Override
35.                 public void onConnected() {
36.                     Log.e(TAG,"onConnected------");
37.                     //必须在确保连接成功的前提下执行订阅的操作
38.                     if (mBrowser.isConnected()) {
39.                         //mediaId即为MediaBrowserService.onGetRoot的返回值
40.                         //若Service允许客户端连接，则返回结果不为null，其值为数据内容层次结构的根ID
41.                         //若拒绝连接，则返回null
42.                         String mediaId = mBrowser.getRoot();
44.                         //Browser通过订阅的方式向Service请求数据，发起订阅请求需要两个参数，其一为mediaId
45.                         //而如果该mediaId已经被其他Browser实例订阅，则需要在订阅之前取消mediaId的订阅者
46.                         //虽然订阅一个 已被订阅的mediaId 时会取代原Browser的订阅回调，但却无法触发onChildrenLoaded回调
48.                         //ps：虽然基本的概念是这样的，但是Google在官方demo中有这么一段注释...
49.                         // This is temporary: A bug is being fixed that will make subscribe
50.                         // consistently call onChildrenLoaded initially, no matter if it is replacing an existing
51.                         // subscriber or not. Currently this only happens if the mediaID has no previous
52.                         // subscriber or if the media content changes on the service side, so we need to
53.                         // unsubscribe first.
54.                         //大概的意思就是现在这里还有BUG，即只要发送订阅请求就会触发onChildrenLoaded回调
55.                         //所以无论怎样我们发起订阅请求之前都需要先取消订阅
56.                         mBrowser.unsubscribe(mediaId);
57.                         //之前说到订阅的方法还需要一个参数，即设置订阅回调SubscriptionCallback
58.                         //当Service获取数据后会将数据发送回来，此时会触发SubscriptionCallback.onChildrenLoaded回调
59.                         mBrowser.subscribe(mediaId, BrowserSubscriptionCallback);
60.                     }
61.                 }
63.                 @Override
64.                 public void onConnectionFailed() {
65.                     Log.e(TAG,"连接失败！");
66.                 }
67.             };
68.     /**
69.      * 向媒体浏览器服务(MediaBrowserService)发起数据订阅请求的回调接口
70.      */
71.     private final MediaBrowserCompat.SubscriptionCallback BrowserSubscriptionCallback =
72.             new MediaBrowserCompat.SubscriptionCallback(){
73.                 @Override
74.                 public void onChildrenLoaded(@NonNull String parentId,
75.                                              @NonNull List<MediaBrowserCompat.MediaItem> children) {
76.                     Log.e(TAG,"onChildrenLoaded------");
77.                     //children 即为Service发送回来的媒体数据集合
78.                     for (MediaBrowserCompat.MediaItem item:children){
79.                         Log.e(TAG,item.getDescription().getTitle().toString());
80.                         list.add(item);
81.                     }
82.                     //在onChildrenLoaded可以执行刷新列表UI的操作
83.                     demoAdapter.notifyDataSetChanged();
84.                 }
85.             };
86. }

复制代码

通过上面代码和解释可以知道：MediaBrowser从连接服务，到向MediaBrowserService订阅数据的流程是如许子

1. connect → onConnected → subscribe → onChildrenLoaded

复制代码

2、Service端MusicService

2.1、设置AndroidManifest.xml

1. <service
2.     android:name=".demo.MusicService">
3.     <intent-filter>
4.         <action android:name="android.media.browse.MediaBrowserService" />
5.     </intent-filter>
6. </service>

复制代码

2.2、MusicService实现

通过继承MediaBrowserService（这里利用了support-v4包的类）创建MusicService类。MediaBrowserService继承自Service

1. public class MusicService extends MediaBrowserServiceCompat {
2.     private MediaSessionCompat mSession;
3.     private PlaybackStateCompat mPlaybackState;
5.     @Override
6.     public void onCreate() {
7.         super.onCreate();
8.         mPlaybackState = new PlaybackStateCompat.Builder()
9.                 .setState(PlaybackStateCompat.STATE_NONE,0,1.0f)
10.                 .build();
12.         mSession = new MediaSessionCompat(this,"MusicService");
13.         mSession.setCallback(SessionCallback);//设置回调
14.         mSession.setFlags(MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
15.         mSession.setPlaybackState(mPlaybackState);
17.         //设置token后会触发MediaBrowserCompat.ConnectionCallback的回调方法
18.         //表示MediaBrowser与MediaBrowserService连接成功
19.         setSessionToken(mSession.getSessionToken());
20.     }
21. }

复制代码

调用MediaSession.setFlag为Session设置标记位，以便Session吸收控制器的指令。然后是播放状态的设置，需调用MediaSession.setPlaybackState，那么PlaybackState又是什么呢？之前我们简单介绍过它是封装了各种播放状态的类，我们可以通过判断当前播放状态来控制各个成员的举动，而PlaybackState类为我们定义了各种状态的规范。别的我们还须要设置SessionCallback回调，当客户端利用控制器发送指令时，就会触发这些回调方法，从而达到控制播放器的目的

1. public class MusicService extends MediaBrowserServiceCompat {
2.     ...
3.     private MediaPlayer mMediaPlayer;
5.     @Override
6.     public void onCreate() {
7.         ...
8.         mMediaPlayer = new MediaPlayer();
9.         mMediaPlayer.setOnPreparedListener(PreparedListener);
10.         mMediaPlayer.setOnCompletionListener(CompletionListener);
11.     }
13.     /**
14.      * 响应控制器指令的回调
15.      */
16.     private android.support.v4.media.session.MediaSessionCompat.Callback SessionCallback = new MediaSessionCompat.Callback(){
17.         /**
18.          * 响应MediaController.getTransportControls().play
19.          */
20.         @Override
21.         public void onPlay() {
22.             Log.e(TAG,"onPlay");
23.             if(mPlaybackState.getState() == PlaybackStateCompat.STATE_PAUSED){
24.                 mMediaPlayer.start();
25.                 mPlaybackState = new PlaybackStateCompat.Builder()
26.                         .setState(PlaybackStateCompat.STATE_PLAYING,0,1.0f)
27.                         .build();
28.                 mSession.setPlaybackState(mPlaybackState);
29.             }
30.         }
32.         /**
33.          * 响应MediaController.getTransportControls().onPause
34.          */
35.         @Override
36.         public void onPause() {
37.             Log.e(TAG,"onPause");
38.             if(mPlaybackState.getState() == PlaybackStateCompat.STATE_PLAYING){
39.                 mMediaPlayer.pause();
40.                 mPlaybackState = new PlaybackStateCompat.Builder()
41.                         .setState(PlaybackStateCompat.STATE_PAUSED,0,1.0f)
42.                         .build();
43.                 mSession.setPlaybackState(mPlaybackState);
44.             }
45.         }
47.         /**
48.          * 响应MediaController.getTransportControls().playFromUri
49.          * @param uri
50.          * @param extras
51.          */
52.         @Override
53.         public void onPlayFromUri(Uri uri, Bundle extras) {
54.             Log.e(TAG,"onPlayFromUri");
55.             try {
56.                 switch (mPlaybackState.getState()){
57.                     case PlaybackStateCompat.STATE_PLAYING:
58.                     case PlaybackStateCompat.STATE_PAUSED:
59.                     case PlaybackStateCompat.STATE_NONE:
60.                         mMediaPlayer.reset();
61.                         mMediaPlayer.setDataSource(MusicService.this,uri);
62.                         mMediaPlayer.prepare();//准备同步
63.                         mPlaybackState = new PlaybackStateCompat.Builder()
64.                                 .setState(PlaybackStateCompat.STATE_CONNECTING,0,1.0f)
65.                                 .build();
66.                         mSession.setPlaybackState(mPlaybackState);
67.                         //我们可以保存当前播放音乐的信息，以便客户端刷新UI
68.                         mSession.setMetadata(new MediaMetadataCompat.Builder()
69.                                 .putString(MediaMetadataCompat.METADATA_KEY_TITLE,extras.getString("title"))
70.                                 .build()
71.                         );
72.                         break;
73.                 }
74.             }catch (IOException e){
75.                 e.printStackTrace();
76.             }
77.         }
79.         @Override
80.         public void onPlayFromSearch(String query, Bundle extras) {
81.         }
82.     };
84.     /**
85.      * 监听MediaPlayer.prepare()
86.      */
87.     private MediaPlayer.OnPreparedListener PreparedListener = new MediaPlayer.OnPreparedListener() {
88.         @Override
89.         public void onPrepared(MediaPlayer mediaPlayer) {
90.             mMediaPlayer.start();
91.             mPlaybackState = new PlaybackStateCompat.Builder()
92.                     .setState(PlaybackStateCompat.STATE_PLAYING,0,1.0f)
93.                     .build();
94.             mSession.setPlaybackState(mPlaybackState);
95.         }
96.     } ;
98.     /**
99.      * 监听播放结束的事件
100.      */
101.     private MediaPlayer.OnCompletionListener CompletionListener = new MediaPlayer.OnCompletionListener() {
102.         @Override
103.         public void onCompletion(MediaPlayer mediaPlayer) {
104.             mPlaybackState = new PlaybackStateCompat.Builder()
105.                     .setState(PlaybackStateCompat.STATE_NONE,0,1.0f)
106.                     .build();
107.             mSession.setPlaybackState(mPlaybackState);
108.             mMediaPlayer.reset();
109.         }
110.     };
111. }

复制代码

在上面↑↑↑<二.1.3、MediaSession#⑵、MediaSession.Callback>已经知道MediaSession.Callback中还有许多回调方法，可以按需覆盖重写即可
⚠️ 注意再次提醒
   构建好  MediaSession跋文得调用setSessionToken保存Session的配对令牌，同时调用此方法也会  回调客户端MediaBrowser.ConnectionCallback的onConnected方法，告知客户端Browser与BrowserService连接成功了，我们也就完成了MediaSession的创建和初始化  2.3、MediaBrowser与MediaBrowserService的订阅关系

MediaBrowserService中我们须要重写onGetRoot和onLoadChildren方法，其作用之前已经讲过就不多赘述了

1. public class MusicService extends MediaBrowserServiceCompat {
2.     @Nullable
3.     @Override
4.     public BrowserRoot onGetRoot(@NonNull String clientPackageName, int clientUid, @Nullable Bundle rootHints) {
5.         Log.e(TAG,"onGetRoot-----------");
6.         return new BrowserRoot(MEDIA_ID_ROOT, null);
7.     }
9.     @Override
10.     public void onLoadChildren(@NonNull String parentId, @NonNull final Result<List<MediaBrowserCompat.MediaItem>> result) {
11.         Log.e(TAG,"onLoadChildren--------");
12.         //将信息从当前线程中移除，允许后续调用sendResult方法
13.         result.detach();
15.         //我们模拟获取数据的过程，真实情况应该是异步从网络或本地读取数据
16.         MediaMetadataCompat metadata = new MediaMetadataCompat.Builder()
17.                 .putString(MediaMetadataCompat.METADATA_KEY_MEDIA_ID, ""+R.raw.jinglebells)
18.                 .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "圣诞歌")
19.                 .build();
20.         ArrayList<MediaBrowserCompat.MediaItem> mediaItems = new ArrayList<>();
21.         mediaItems.add(createMediaItem(metadata));
23.         //向Browser发送数据
24.         result.sendResult(mediaItems);
25.     }
27.     private MediaBrowserCompat.MediaItem createMediaItem(MediaMetadataCompat metadata){
28.         return new MediaBrowserCompat.MediaItem(
29.                 metadata.getDescription(),
30.                 MediaBrowserCompat.MediaItem.FLAG_PLAYABLE
31.         );
32.     }
33. }

复制代码

3、客户端控制器MediaController

回到客户端这边，四大核心类中还剩下控制器MediaController没讲。MediaController的创建依靠于Session的配对令牌，当Browser和BrowserService连接成功就可以通过Browser拿到这个令牌。控制器创建后，我们就可以通过MediaController.getTransportControls发送播放指令，同时也可以注册MediaControllerCompat.Callback回调吸收播放状态，用以刷新界面UI

1. public class DemoActivity extends AppCompatActivity {
2.     ...
3.     private Button btnPlay;
4.     private TextView textTitle;
6.     @Override
7.     protected void onCreate(Bundle savedInstanceState) {
8.         ...
9.         btnPlay = (Button) findViewById(R.id.btn_play);
10.         textTitle = (TextView) findViewById(R.id.text_title);
11.     }
13.     public void clickEvent(View view) {
14.         switch (view.getId()) {
15.             case R.id.btn_play:
16.                 if(mController!=null){
17.                     handlerPlayEvent();
18.                 }
19.                 break;
20.         }
21.     }
23.     /**
24.      * 处理播放按钮事件
25.      */
26.     private void handlerPlayEvent(){
27.         switch (mController.getPlaybackState().getState()){
28.             case PlaybackStateCompat.STATE_PLAYING:
29.                 mController.getTransportControls().pause();
30.                 break;
31.             case PlaybackStateCompat.STATE_PAUSED:
32.                 mController.getTransportControls().play();
33.                 break;
34.             default:
35.                 mController.getTransportControls().playFromSearch("", null);
36.                 break;
37.         }
38.     }
40.     /**
41.      * 连接状态的回调接口，连接成功时会调用onConnected()方法
42.      */
43.     private MediaBrowserCompat.ConnectionCallback BrowserConnectionCallback =
44.             new MediaBrowserCompat.ConnectionCallback(){
45.                 @Override
46.                 public void onConnected() {
47.                     Log.e(TAG,"onConnected------");
48.                     if (mBrowser.isConnected()) {
49.                         ...
50.                         try{
51.                             mController = new MediaControllerCompat(DemoActivity.this,mBrowser.getSessionToken());
52.                             //注册回调
53.                             mController.registerCallback(ControllerCallback);
54.                         }catch (RemoteException e){
55.                             e.printStackTrace();
56.                         }
57.                     }
58.                 }
60.                 @Override
61.                 public void onConnectionFailed() {
62.                     Log.e(TAG,"连接失败！");
63.                 }
64.             };
66.     /**
67.      * 媒体控制器控制播放过程中的回调接口，可以用来根据播放状态更新UI
68.      */
69.     private final MediaControllerCompat.Callback ControllerCallback =
70.             new MediaControllerCompat.Callback() {
71.                 /***
72.                  * 音乐播放状态改变的回调
73.                  * @param state
74.                  */
75.                 @Override
76.                 public void onPlaybackStateChanged(PlaybackStateCompat state) {
77.                     switch (state.getState()){
78.                         case PlaybackStateCompat.STATE_NONE://无任何状态
79.                             textTitle.setText("");
80.                             btnPlay.setText("开始");
81.                             break;
82.                         case PlaybackStateCompat.STATE_PAUSED:
83.                             btnPlay.setText("开始");
84.                             break;
85.                         case PlaybackStateCompat.STATE_PLAYING:
86.                             btnPlay.setText("暂停");
87.                             break;
88.                     }
89.                 }
91.                 /**
92.                  * 播放音乐改变的回调
93.                  * @param metadata
94.                  */
95.                 @Override
96.                 public void onMetadataChanged(MediaMetadataCompat metadata) {
97.                     textTitle.setText(metadata.getDescription().getTitle());
98.                 }
99.             };
101.     private Uri rawToUri(int id){
102.         String uriStr = "android.resource://" + getPackageName() + "/" + id;
103.         return Uri.parse(uriStr);
104.     }
105. }

复制代码

四、附录（可选）

这里是官方Demo和一些MediaSession的控制下令
1、官方Demo

• UAMP — 通用音乐播放器利用 ExoPlayer 来播放本地音频。
  
• ExoPlayer 演示应用 — 官方代码库中包含一个演示应用，该应用展示了该库的许多高级功能。
  
• 通过 MediaSession 控制媒体
  
• Google官方UniversalMusicPlayer源码 可以通过Google官方demo，看看播放进度条、播放队列控制、通知栏上的快捷操作等功能是怎样结合MediaSession框架实现的
  

2、其他媒体APP

通过MediaBrowser和MediaControl连接MusicDemo的Service，就可以远程控制MusicDemo中的音乐播放。 比如：可以只实现UI上的MediaBrowser和MediaControl连接到官方的UAMP上可以支持操作。
3、adb shell 提供的media控制

1. adb shell media dispatch pause
2. adb shell media dispatch play
3. adb shell media dispatch play-pause
4. adb shell media dispatch fast-forward
5. adb shell media dispatch rewind

复制代码

4、支持物理按键的控制-MediaSession的回调方法onMediaButtonEvent中

1. adb shell input keyevent 87 // next
2. adb shell input keyevent 88 // previous
3. adb shell input keyevent 126 // play
4. adb shell input keyevent 127 // pause

复制代码

5、语音助手

我们的语音助手，可以控制播放的音乐： 如VPA，Google Assistant，HiCar，你好小安，你好小度，你好小德可以发送，指令"播放周杰伦的歌"，"暂停"，"继承"，"下一首"
有了MediaSession框架，类似如许语音的功能，就不须要每个音频都去实现了它的功能了
致谢（引用和推荐）

本文参考鉴戒了以下文章部分内容，非常感谢各位前辈的开源精神，当代互联网的发展离不开你们的分享，再次感谢 .同时以下↓↓↓，也是本神推荐阅读系列

• -[x] #*媒体应用架构概览 | Android 开发者 | Android Developers
  
• -[x] #*MediaSession | Android Developers
  
• -[x] **MediaSession框架全解析_qzns木雨的博客-CSDN博客_mediasession
  
• -[x] **车载多媒体（二）- 多媒体应用架构与MediaSession框架
  
• -[x] **Android车载多媒体开发——MediaSession框架
  
• -[x] **Android车载多媒体开发MediaSession框架示例详解
  
• -[x] **Android 媒体播放框架MediaSession分析与实践
  
• -[x] **Android MediaSession框架简析
  
• -[x] #*Audio and video overview
  
• -[x] **MediaSession框架的介绍和利用
  
• -[x] **MediaSession框架的源码分析
  
• -[x] **Android车载开发之Android Automotive
  

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。