关于媒体浏览器服务(MediaBrowserService)

今天说的这个主题与媒体播放有关,尤其是音乐播放,说到音乐播放大家应该都用过音乐App。
通常一个音乐App的实现主要涉及如下几点:

  1. 从服务器获取音乐数据
  2. 播放音乐时播放器的各种播放状态以及不同状态下的UI展示
  3. 播放过程中通过UI界面控制播放器的各种状态
  4. UI控制如何与播放服务进行关联并进行状态同步
  5. 如何保证后台播放过程中播放服务不被杀死

对于上面的这几点,其实Android已经为我们提供了一套完整的解决方案,它已经很好的将这些操作进行了封装,我们只需要关注数据的获取和歌曲的播放即可。Android提供的这套API在support-v4中提供了兼容版本,因此在使用的过程中最好使用该版本以兼容低版本系统。

关键类主要有如下几个:

  1. MediaBrowserServiceCompat 媒体浏览器服务
  2. MediaBrowserCompat 媒体浏览器
  3. MediaControllerCompat 媒体控制器
  4. MediaSessionCompat 媒体会话
    我们一个个来说。

MediaBrowserServiceCompat

该类有两个作用:

  1. 音乐播放后台服务
  2. 客户端中获取音乐数据的服务,所有的音乐数据都通过该服务与服务端进行交互获取(或者直接获取手机中的本地音乐数据)

既然知道该类是Service的子类实现,所以说它是音乐播放的后台服务也好理解,但是该类作为一个后台播放服务却不是通过其自身直接实现的,而是通过MediaSessionCompat媒体会话这个类来实现的。在使用过程中媒体会话会与该服务关联起来,所有的播放操作都交由MediaSessionCompat实现。

而对于获取数据,则是通过MediaBrowserServiceCompat的如下两个方法来进行控制:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
@Override
public BrowserRoot onGetRoot(@NonNull String clientPackageName, int clientUid,
Bundle rootHints) {
/**
* 在返回数据之前,可以进行黑白名单控制,以控制不同客户端浏览不同的媒体资源
* */
if(!PackageUtil.isCallerAllowed(this, clientPackageName, clientUid)) {
return new BrowserRoot(null, null);
}
//此方法只在服务连接的时候调用
//返回一个rootId不为空的BrowserRoot则表示客户端可以连接服务,也可以浏览其媒体资源
//如果返回null则表示客户端不能流量媒体资源
return new BrowserRoot(BrowserRootId.MEDIA_ID_ROOT, null);
}
@Override
public void onLoadChildren(@NonNull String parentId, @NonNull Result<List<MediaItem>> result) {
/***
* 此方法中的parentId与上面的方法onGetRoot中返回的RootId没有关系
* 客户端连接后,它可以通过重复调用MediaBrowserCompat.subscribe() 方法来发起数据获取请求。
* 而每次调用subscribe() 方法都会发送一个onLoadChildren()回调到该service中,然后返回一个MediaBrowser.MediaItem(音乐数据) 对象列表
*
* 每个MediaItem 都有唯一的ID字符串,它其实是一个隐式的token。
* 当客户想打开子菜单或播放一个item时,它就将ID传入。
*/
if(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH.equals(parentId)) {
//在当前方法执行结束返回之前必须要调用result.detach(),否则无法发起请求
result.detach();
MusicProvider.getInstance().requestMusic(result);
//如果想要通过http请求来获取数据,则必须按照上面说的必须要先调用result.detach();方法,否则会出现异常。http请求结束之后则通过调用result.sendResult(mMetadataCompatList);将数据返回,返回的数据在注册的接口MediaBrowserCompat.SubscriptionCallback中通过回调拿到在界面上进行展示
//而且此处返回的数据类型必须是MediaBrowser.MediaItem
} else {
result.detach();
}
}

MediaBrowserCompat

前面说过MediaBrowserServiceCompat(媒体浏览服务)是作为数据请求服务来获取数据的,因此相应的会有一个媒体浏览客户端来发起媒体数据的获取请求,该类就是这个客户端。
前面已经介绍过通过调用MediaBrowserCompat.subscribe()方法来发起数据请求,而在调用此方法之前,必须保证MediaBrowserCompat连接上媒体浏览服务,连接方式如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
//通过如下代码连接MediaBrowserServiceCompat,连接成功后获取媒体会话token
//通过媒体会话token创建MediaControllerCompat
//这时就将MediaControllerCompat与媒体会话MediaSessionCompat关联起来了
MediaBrowserCompat mediaBrowser = new MediaBrowserCompat(this,
new ComponentName(this, MusicService.class), mConnectionCallback, null);
//连接媒体浏览服务成功后的回调接口
final MediaBrowserCompat.ConnectionCallback mConnectionCallback =
new MediaBrowserCompat.ConnectionCallback() {
@Override
public void onConnected() {
try {
//获取与MediaBrowserServiceCompat关联的媒体会话token
MediaSessionCompat.Token token = mMediaBrowser.getSessionToken();
//通过媒体会话token创建媒体控制器并与之关联
//关联之后媒体控制器就可以控制播放器的各种播放状态了
MediaControllerCompat mediaController = new MediaControllerCompat(this, token);
//将媒体控制器与当前上下文Context进行关联
//此处关联之后,我们在界面上操作某些UI的时候就可以通过当前上下文Context来获取当前的MediaControllerCompat
//MediaControllerCompat controller = MediaControllerCompat.getMediaController((Activity) context);
MediaControllerCompat.setMediaController(this, mediaController);
//为媒体控制器注册回调接口 mediaController.registerCallback(mMediaControllerCallback);
} catch (RemoteException e) {
onMediaControllerConnectedFailed();
}
}
};
//媒体控制器控制播放过程中的回调接口
final MediaControllerCompat.Callback mMediaControllerCallback =
new MediaControllerCompat.Callback() {
@Override
public void onPlaybackStateChanged(@NonNull PlaybackStateCompat state) {
//播放状态发生改变时的回调
onMediaPlayStateChanged(state);
}
@Override
public void onMetadataChanged(MediaMetadataCompat metadata) {
if(metadata == null) {
return;
}
//播放的媒体数据发生变化时的回调
onPlayMetadataChanged(metadata);
}
};
//发起数据请求
//先解除订阅
mediaBrowser.unsubscribe(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH);
//重新对BrowserRootId进行订阅
//调用此方法后,会接着执行MusicService中的onGetRoot方法和onLoadChildren方法
//onGetRoot方法(只会调用一次)决定是否允许当前客户端连接服务和获取媒体数据
//如果允许连接服务同时也允许获取媒体数据,则会接着调用onLoadChildren方法开始获取数据
//数据获取成功后会调用订阅的回调接口将数据返回回来
mediaBrowser.subscribe(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH, mSubscriptionCallback);
//向媒体流量服务发起媒体浏览请求的回调接口
final MediaBrowserCompat.SubscriptionCallback mSubscriptionCallback =
new MediaBrowserCompat.SubscriptionCallback() {
@Override
public void onChildrenLoaded(@NonNull String parentId,
@NonNull List<MediaBrowserCompat.MediaItem> children) {
//数据获取成功后的回调
}
@Override
public void onError(@NonNull String id) {
//数据获取失败的回调
}
};

MediaSessionCompat

前面说过MediaBrowserServiceCompat的媒体播放其实是通过关联的MediaSessionCompat来实现的,而其关联方式也很简单:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
MediaSessionCompat mSession = new MediaSessionCompat(this, "MusicService");
setSessionToken(mSession.getSessionToken());
mSession.setCallback(new MediaSessionCompat.Callback());
mSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
//MediaSessionCompat的播放控制则又全部是通过接口MediaSessionCompat.Callback来实现的
@Override
public void onPlay() {
//点击播放按钮时触发
//通过MediaControllerCompat .getTransportControls().play();触发
}
@Override
public void onSkipToQueueItem(long queueId) {
//播放指定对列媒体时触发
//通过MediaControllerCompat .getTransportControls().onSkipToQueueItem(queueId);触发
}
@Override
public void onSeekTo(long position) {
//设置到指定进度时触发
//MediaControllerCompat.getTransportControls().seekTo(position);
}
@Override
public void onPlayFromMediaId(String mediaId, Bundle extras) {
//播放指定媒体数据时触发
//MediaControllerCompat.getTransportControls().playFromMediaId(mediaItem.getMediaId(), null);
}
@Override
public void onPause() {
//暂停时触发
//MediaControllerCompat.getTransportControls().pause();
}
@Override
public void onStop() {
//停止播放时触发
//MediaControllerCompat.getTransportControls().stop();
}
@Override
public void onSkipToNext() {
//跳到下一首时触发
//MediaControllerCompat.getTransportControls().skipToNext();
}
@Override
public void onSkipToPrevious() {
//跳到上一首时触发
//MediaControllerCompat.getTransportControls().skipToPrevious();
}
//当然还有很多回调函数,大家可以自行查看
}

MediaControllerCompat

媒体控制器在上面已经介绍了其创建和关联方式,而它控制播放器状态的方式在上面的代码注释中已经说明了,基本上都是通过MediaControllerCompat.getTransportControls()来进行控制的。

到这里媒体服务的相关使用和注意点已经介绍完了,使用这套api来实现音乐APP还是很方便很快捷的,而且我们可以很方便的切换播放器,如MediaPlayer,ExoPlayer等,如有建议和问题欢迎在博客关于页中扫码加QQ群交流。


原创文章,本文采用知识共享署名 2.5(中国大陆许可协议)进行许可,欢迎转载,但转载请注明来自ittiger.cn,并保证转载后文章内容的完整性。本人(laohu)保留所有版权相关权利。



评论