MediaSession 框架

2021-06-21/2021-06-21

参考文献:MediaSession 框架全解析

MediaSession 这种媒体框架由 MediaBrowser(媒体浏览器) 和 MediaBrowserService(媒体浏览器服务) 两部分组成。主要作用是规范了媒体服务和界面的通信接口,达到了完全解耦,可以自由、高效进行不同的媒体的切换。

1. 基础用法

首先,我们先来看一下 MediaSession 主要类和对象的构成,如下图:

20190416092246913.png

这个图只是用来对整个框架进行梳理和回顾,相信在看完后面的使用方法后就会觉得很简单了。

简单描述一下:

  • MediaBrowser:媒体浏览器,用来连接服务,在连接成功的结果回调后,获取 token(配对令牌),并以此获得 MediaController 媒体控制器。同时,有订阅并设置订阅信息回调的功能。
  • MediaController:媒体控制器,可以用 MediaController.getMetadata() 等方法来主动获取媒体信息,也可以使用形如 MediaController.getTransportControls().skipToNext() 来发送控制指令。其次一般需要注册 MediaController.Callback 回调进行客户端更新。
  • MediaBrowserService:浏览器服务,实现具体的媒体逻辑。一般在 onCrete() 中用 setSessionToken(...) 来设置 token。在重写的 onGetRoot(…) 中判断是否允许连接,在 onLoadChildren(…) 中处理订阅信息。
  • MediaSeesion:设置 MediaSeesion.Callback,这里就是客户端指令送达的地方。在媒体信息或状态改变后,使用形如 mediaSession.setMetadata(mediaMetadata) 来通知客户端。

下面是具体的使用:

1.1 连接,并建立联系

先来看客户端,我们需要做的是建立连接,并且在连接成功后设置回调。

  1public class MainActivity extends AppCompatActivity implements View.OnClickListener {
  2	...
  3	//媒体浏览器
  4    private MediaBrowser mMediaBrowser;
  5    //媒体控制器
  6    private MediaController mMediaController;
  7
  8    @Override
  9    protected void onCreate(Bundle savedInstanceState) {
 10        super.onCreate(savedInstanceState);
 11        setContentView(R.layout.activity_main);
 12        //新建MediaBrowser,第一个参数是context
 13        //第二个参数是CompoentName,有多种构造方法,指向要连接的服务
 14        //第三个参数是连接结果的回调connectionCallback,第四个参数为Bundle
 15        mMediaBrowser = new MediaBrowser(this,
 16                new ComponentName(this, MediaService.class), connectionCallback, null);
 17        mMediaBrowser.connect();
 18        ...
 19    }
 20
 21	//连接结果的回调
 22	 private MediaBrowser.ConnectionCallback connectionCallback 
 23	 							= new MediaBrowser.ConnectionCallback() {
 24	 
 25		 public void onConnected() {
 26		     	//如果服务端接受连接,就会调此方法表示连接成功,否则回调onConnectionFailed();
 27	           Log.d(TAG, "onConnected: ");
 28	           //获取配对令牌
 29	           MediaSession.Token token = mMediaBrowser.getSessionToken();
 30	           //通过token,获取MediaController,第一个参数是context,第二个参数为token
 31	           mMediaController = new MediaController(getBaseContext(), token);
 32			
 33			   //mediaController注册回调,callback就是媒体信息改变后,服务给客户端的回调
 34	           mMediaController.registerCallback(mMediaCallBack);
 35		     }
 36		       
 37		    public void onConnectionSuspended() {
 38		         //与服务断开回调(可选)
 39		     }
 40		     
 41		    public void onConnectionFailed() {
 42		         //连接失败回调(可选)
 43		     }
 44	 }
 45
 46	//服务对客户端的信息回调。
 47 	private MediaController.Callback mMediaCallBack = new MediaController.Callback() {
 48		//回调函数的方法都是选择性重写的,这里不列举全,具体可查询文章末尾的表格
 49		@Override
 50        public void onMetadataChanged(MediaMetadata metadata) {
 51            super.onMetadataChanged(metadata);
 52			//服务端运行mediaSession.setMetadata(mediaMetadata)就会到达此处,以下类推.
 53
 54         	//歌曲信息回调,更新。MediaMetadata在文章后面会提及
 55			MediaDescription description = metadata.getDescription();
 56			//获取标题
 57			String title = description.getTitle().toString();
 58			//获取作者
 59			String author = description.getSubtitle().toString();
 60			//获取专辑名
 61            String album = description.getDescription().toString();
 62			//获取总时长
 63			long duratime = mediaMetadata.getLong(MediaMetadata.METADATA_KEY_DURATION);
 64			...
 65        }
 66        
 67		 @Override
 68        public void onPlaybackStateChanged(PlaybackState state) {
 69            super.onPlaybackStateChanged(state);
 70			//播放状态信息回调,更新。PlaybackState在文章后面会提及
 71			 if (state.getState() == PlaybackState.STATE_PLAYING) {
 72          		//正在播放
 73          	 } 
 74          	 ...	
 75			//获取当前播放进度
 76			 long position = state.getPosition()
 77		     ....
 78        }
 79
 80		@Override
 81        public void onQueueChanged(List<MediaSession.QueueItem> queue) {
 82            super.onQueueChanged(queue);
 83			//播放列表信息回调,QueueItem在文章后面会提及
 84			....
 85        }	
 86
 87		@Override
 88        public void onSessionEvent(String event, Bundle extras) {
 89            super.onSessionEvent(event, extras);
 90            //自定义的事件回调,满足你各种自定义需求
 91            ...
 92        }
 93
 94        @Override
 95        public void onExtrasChanged(Bundle extras) {
 96            super.onExtrasChanged(extras);
 97            //额外信息回调,可以承载播放模式等信息
 98        }
 99        .....
100	}
101}

以上代码,做了一个什么事情呢?我们在 onCreate() 中去连接了一个继承 MediaBrowserService 的服务。并在连接成功的信息后,我们取得了 mMediaController,并且注册了一个回调,用于知晓服务端通知的媒体信息变更。很简单的的开始,在后面的代码中,就可以用 mMediaController 为所欲为了。

 1//在需要的地方使用以下代码
 2//控制媒体服务的一些方法,播放、暂停、上下首、跳转某个时间点...可查看文章末尾表格
 3mMediaController.getTransportControls().play();
 4mMediaController.getTransportControls().pause();
 5mMediaController.getTransportControls().skipToPrevious();
 6mMediaController.getTransportControls().skipToNext();
 7mMediaController.getTransportControls().seekTo(...);
 8....
 9//主动获取媒体信息的一些操作,获取媒体信息,播放状态...可查看文章末尾表格
10MediaMetadata metadata = mMediaController.getMetadata();
11PlaybackState playbackState = mMediaController.getPlaybackState();
12....

需要留意的坑非主线程创建 MediaBrowser 并 connect 的时候会报错。这是因为连接时底层代码会使用 Handler,并且采用 Handler handler = new Handler() 的创建方式,如此使用必然会报错。解决办法:

 1Looper.prepare();
 2
 3mBtMusicBrowser = new MediaBrowser(BaseApplication.getInstance(),
 4        //绑定服务,这里绑定的是系统蓝牙音乐的服务
 5        new ComponentName("com.android.bluetooth", 
 6            "com.android.bluetooth.a2dpsink.mbs.A2dpMediaBrowserService"), 
 7            mConnectionCallback,//关联连接回调
 8            null);
 9mBtMusicBrowser.connect();
10     
11Looper.loop();

在之前和之后加上 Looper.prepare() 和 Looper.loop() 就搞定了,这个可以参考 Handler 的机制进行理解。


接着看服务端,我们要做的是同意客户端连接,响应客户端的控制命令,并且在信息改变时通知回调给客户端。

 1public class MediaService extends MediaBrowserService{
 2
 3	...
 4	//媒体会话,受控端
 5	private MediaSession mediaSession;
 6
 7	@Override
 8    public void onCreate() {
 9        super.onCreate();
10        Log.d(TAG, "onCreate: ");
11        //初始化,第一个参数为context,第二个参数为String类型tag,这里就设置为类名了
12        mediaSession = new MediaSession(this, "MediaService");
13        //设置token
14        setSessionToken(mediaSession.getSessionToken());
15        //设置callback,这里的callback就是客户端对服务指令到达处
16        mediaSession.setCallback(mCallback);
17    }
18
19	//mediaSession设置的callback,也是客户端控制指令所到达处
20	private MediaSession.Callback mCallback = new MediaSession.Callback() {
21	//重写的方法都是选择性重写的,不完全列列举,具体可以查询文章末尾表格
22		@Override
23        public void onPlay() {
24            super.onPlay();
25			//客户端mMediaController.getTransportControls().play()就会调用到这里,以下类推
26			//处理播放逻辑
27			...
28			//处理完成后通知客户端更新,这里就会回调给客户端的MediaController.Callback
29			
30			mediaSession.setPlaybackState(playbackState);
31        }
32		
33        @Override
34        public void onPause() {
35            super.onPause();
36            //暂停
37            ....
38        }
39
40        @Override
41        public void onSkipToNext() {
42            super.onSkipToNext();
43            //下一首
44            .....
45            //通知媒体信息改变
46            mediaSession.setMetadata(mediaMetadata);
47        }
48
49        @Override
50        public void onCustomAction(String action, Bundle extras) {
51            super.onCustomAction(action, extras);
52			//自定义指令发送到的地方
53			//对应客户端 mMediaController.getTransportControls().sendCustomAction(...)
54
55        }
56		....
57	}
58	
59	//自己写的方法,用于改变播放列表
60	private void changePlayList(){
61		....
62		
63		//通知播放队列改变
64		mediaSession.setQueue(queueItems);
65	}
66
67	 @Override
68    public BrowserRoot onGetRoot(String clientPackageName, int clientUid, Bundle rootHints) {
69		//MediaBrowserService必须重写的方法,第一个参数为客户端的packageName,第二个参数为Uid
70		//第三个参数是从客户端传递过来的Bundle。
71		//通过以上参数来进行判断,若同意连接,则返回BrowserRoot对象,否则返回null;
72
73		//构造BrowserRoot的第一个参数为rootId(自定义),第二个参数为Bundle;
74        return new BrowserRoot("MyMedia", null);
75    }
76
77	 @Override
78    public void onLoadChildren(String parentId, 
79    				MediaBrowserService.Result<List<MediaBrowser.MediaItem>> result) {
80	//MediaBrowserService必须重写的方法,用于处理订阅信息,文章后面会提及
81	....
82	}
83
84	....
85}

在服务端里,我们会发现跟客户端的所有操作是一一对应的。

在 onCreate() 中,我们创建了 MediaSession,设置好了 token,并设置了 MediaSession.CallBack 用于接收客户端的各项指令。完成媒体的逻辑后,在合适的地方,我们可以使用形如 mediaSession.setMetadata(mediaMetadata) 回调给客户端进行媒体信息的更新。

而在 BrowserRoot onGetRoot(…) 方法中,我们可以通过其中的参数来判断是否准许客户端连接,不允许就直接返回 null。

2. 自定义通信接口与订阅

好了,用以上的知识我们可以做一个具有基础功能的多媒体了。不过,新的问题出现了:MediaSession 框架中的通信接口是有限的,如果我们的需求不止步于简单的控制怎么办,比如要满足收藏功能,改变歌曲播放的循环模式,或者获取某一个音乐列表,甚至某些独特的需求…

MediaSession 框架提供了一些接口,对应关系如下表

MediaController(客户端) MediaSession.Callback(服务端) 作用
sendCustomAction(String action, Bundle args) onCustomAction(String action, Bundle extras) 发送/接收自定义指令
MediaSession(服务端) MediaController.Callback(客户端) 作用
sendSessionEvent(String event, Bundle extras) onSessionEvent(String event, Bundle extras) 发送/接收自定义指令
setExtras(Bundle extras) onExtrasChanged(Bundle extras) 通知客户端更新额外信息,播放模式等…
setQueue(List< QueueItem> queue) onQueueChanged(List queue) 通知客户端播放列表改变

客户端和服务端可以通过 Bundle 来进行信息传递,String 类型作为自定义命令的标识,达到自定义接口的目的。

此外,我们向服务端主动异步获取回调特定的媒体列表,可以用订阅的方式来进行。

客户端

 1//重复订阅会报错,所以先解除订阅
 2mMediaBrowser.unsubscribe("PARENT_ID_1");
 3//第一个参数是String类型的parentId(标识)
 4//第二个参数为订阅的回调MediaBrowser.SubscriptionCallback
 5mMediaBrowser.subscribe("PARENT_ID_1", mCallback);
 6...
 7
 8//订阅信息的回调
 9private MediaBrowser.SubscriptionCallback mCallback = new MediaBrowser.SubscriptionCallback() {
10                        
11    @Override
12    public void onChildrenLoaded(String parentId,
13                                    List<MediaBrowser.MediaItem> children) {
14        super.onChildrenLoaded(parentId, children);
15        //订阅信息回调,parentID为标识,children为传回的媒体列表
16        ....
17    }
18    
19    @Override
20    public void onChildrenLoaded(String parentId, 
21                    List<MediaBrowser.MediaItem> children, Bundle options) {
22        super.onChildrenLoaded(parentId, children, options);
23        //订阅消息时添加了Bundle参数,会回调到此方法
24        //即mMediaBrowser.subscribe("PARENT_ID_1", mCallback,bundle)的回调
25        ...
26    }
27
28    @Override
29    public void onError(String parentId) {
30        super.onError(parentId);
31        //出错..
32    }
33}

这里需要注意:

  • 因为订阅后,也会到达服务端的 onLoadChildren(...),并回调数据到 MediaBrowser.SubscriptionCallback,所以可以采用解除订阅,再进行订阅的方式进行主动异步获取操作(订阅后,获得回调信息)。

    1//这样可以进行异步数据回调
    2mMediaBrowser.unsubscribe("PARENT_ID_1");
    3mMediaBrowser.subscribe("PARENT_ID_1", mCallback);
    
  • 不能重复订阅相同 parentId 的,会报错,所以建议订阅时都先做解除订阅的操作。

  • 在 mMediaBrowser.subscribe(…) 方法中,可以添加第三个 Bundle 参数,此时回调到同存在 Bundle 参数的 onChildrenLoaded(…) 方法中,注意别弄错了回调方法。


服务端

 1@Override
 2public void onLoadChildren(String parentId, 
 3                MediaBrowserService.Result<List<MediaBrowser.MediaItem>> result) {
 4    //使用result之前,一定需要detach();
 5    result.detach();
 6    //新建MediaItem数组
 7    ArrayList<MediaBrowser.MediaItem> mediaItems = new ArrayList<>();
 8    
 9    //根据parentId,获取不同的媒体列表
10    switch(parentId){
11        case MEDIA_ID_ROOT:
12            ....
13            break;
14        case PARENT_ID_1:
15            //模拟数据
16            MediaMetadata metadata = new MediaMetadata.Builder()
17                    .putString(MediaMetadata.METADATA_KEY_MEDIA_ID, "101")
18                    .putString(MediaMetadata.METADATA_KEY_TITLE, "一首歌")
19                    .build();
20            mediaItems.add(new MediaBrowser.MediaItem(metadata.getDescription(), 
21                                        MediaBrowser.MediaItem.FLAG_PLAYABLE));
22            break;
23            ...
24    }
25    //发送数据
26    result.sendResult(mediaItems);
27}

服务端重写的 onLoadChildren(…) 用作订阅不同 parentId 返回不同的媒体数据。此外进行订阅后,服务端可以通过 notifyChildrenChanged(String parentId) 发送消息来进行**回调。

3. 涉及的媒体对象解析

3.1 状态对象 PlaybackState

 1//PlaybackState的构建
 2PlaybackState mState = new PlaybackState.Builder()
 3							//三个参数分别是,状态,位置,播放速度
 4							.setState(state, position, playbackSpeed)
 5							.build();
 6
 7//PlaybackState的解析
 8private MediaController.Callback mCallBack = new MediaController.Callback() {
 9	 ....
10	 @Override
11     public void onPlaybackStateChanged(PlaybackState playbackState) {
12        super.onPlaybackStateChanged(state);
13		//获得进度时长
14		long position = playbackState.getPosition();
15		
16		//获得当前状态
17		switch(playbackState.getState()){
18			case PlaybackState.STATE_PLAYING:
19				//正在播放
20				...
21				break;
22			case PlaybackState.STATE_PAUSED:
23				//暂停
24				...
25				break;
26			case PlaybackState.ACTION_SKIP_TO_NEXT:
27				//跳到下一首
28				...
29				break;
30			...//还有很多状态标志,按需求添加
31		}
32	}
33}

构建时,setState(…)有两个方法:

  • setState(int state, long position, float playbackSpeed)
  • setState(int state, long position, float playbackSpeed, long updateTime)
  • 上面一个方法其实是调用的下面一个方法,updateTime 自动设置为开机时间。

注意:播放进度的获取需要具体逻辑进行计算,客户端和服务端逻辑统一就可以了。 笔者是直接通过 position 表示播放进度的。

3.2 媒体对象

媒体信息对象 MediaMetadata、MediaSession.QueueItem、MediaBrowser.MediaItem

MediaMetadata

 1//构建,把代码中的字符串替换成歌曲的对应字符串
 2MediaMetadata metadata = new MediaMetadata.Builder()
 3        .putString(MediaMetadata.METADATA_KEY_MEDIA_ID, "id") //id
 4        .putString(MediaMetadata.METADATA_KEY_TITLE, "title")//标题
 5        .putString(MediaMetadata.METADATA_KEY_ARTIST,"artist")//作者
 6        .putString(MediaMetadata.METADATA_KEY_ALBUM,"album")//唱片
 7        .putLong(MediaMetadata.METADATA_KEY_DURATION,"duration")//媒体时长
 8        .build();
 9
10//解析,通过MediaDescription获取信息
11private MediaController.Callback mCallBack = new MediaController.Callback() {
12 	@Override
13    public void onMetadataChanged(MediaMetadata metadata) {
14        super.onMetadataChanged(metadata);
15		MediaDescription description = mediaMetadata.getDescription();
16		//获取标题
17		String title = description.getTitle().toString();
18		//获取作者
19		String author = description.getSubtitle().toString();
20		//获取专辑名
21        String album = description.getDescription().toString();
22		//获取总时长
23		long duratime = mediaMetadata.getLong(MediaMetadata.METADATA_KEY_DURATION);
24	}
25	....
26}

MediaSession.QueueItem 比 MediaMetadata 多了一个唯一的 id

 1//构建,传入MediaDescription 和id
 2MediaDescription description = new MediaDescription.Builder()
 3                .setMediaId(song.mediaId)
 4                .setTitle(song.title)
 5                .setSubtitle(song.subtitle)
 6                .setExtras(bundle)
 7                .build();
 8QueueItem queueItem = new QueueItem(description, song.queueId);
 9
10//MediaMetadata转化为QueueItem
11QueueItem queueItem = new QueueItem(mediaMetadata.getDescription(), id);
12
13//解析跟MediaMetadata一样,获取MediaDescription 
14MediaDescription description = queueItem.getDescription();
15//获取标题
16String title = description.getTitle().toString();
17.....

MediaBrowser.MediaItem 跟 MediaSession.QueueItem 很相似,不同的是唯一的 id,变成了 flags

1//MediaMetadata转化为MediaItem,构造方法第一个都是MediaDescription,第二个是flags
2MediaBrowser.MediaItem mediaItem = new MediaBrowser.MediaItem(metadata.getDescription(), 
3                                                    MediaBrowser.MediaItem.FLAG_PLAYABLE);
4
5//解析一样用MediaDescription 
6MediaDescription description = queueItem.getDescription();
7//获取标题
8String title = description.getTitle().toString();
9...

4. 附录:类与方法一览

主要的类与概念

类别 概念
服务端 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 订阅信息回调
客户端调用服务端
意义 TransportControls MediaSession.Callback 说明
播放 play() onPlay()
停止 stop() onStop()
暂停 pause() onPause()
指定播放位置 seekTo(long pos) onSeekTo(long)
快进 fastForward() onFastForward()
回倒 rewind() onRewind()
下一首 skipToNext() onSkipToNext()
上一首 skipToPrevious() onSkipToPrevious()
指定 id 播放 skipToQueueItem(long) onSkipToQueueItem(long) 指定的是 Queue 的 id
指定 id 播放 playFromMediaId(String,Bundle) onPlayFromMediaId(String,Bundle) 指定的是 MediaMetadata 的 id
搜索播放 playFromSearch(String,Bundle) onPlayFromSearch(String,Bundle) 需求不常见
指定uri播放 playFromUri(Uri,Bundle) onPlayFromUri(Uri,Bundle) 需求不常见
发送自定义动作 sendCustomAction(String,Bundle) onCustomAction(String,Bundle) 可用来更换播放模式、重新加载音乐列表等
打分 setRating(Rating rating) onSetRating(Rating) 内置的评分系统有星级、红心、赞/踩、百分比

服务端回调给客户端

意义 MediaSession MediaController.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)

标题:MediaSession 框架
作者:Rainsheep
地址:HTTPS://www.rainsheep.cn/articles/2021/06/21/1624287048503.html

评论
发表评论
       
       
取消