前言
如何实现一个音乐播放App,然后让其可以被第三方的Android app打开,并获取其中的歌单,曲目列表,同时控制其播放呢?现有应用市场上,已经有相应的实现。比如百度CarLife对QQ音乐,喜马拉雅等的调用。
在百度的Carlife App中,我们可以看到,只要我们本地的装了QQ音乐App,其就可以唤起,然后获取其中的歌曲数据,然后进行播放,这个是如何实现的呢?
需求
- 可以获取音乐播放器的歌曲列表
- 可以控制音乐播放器的播放
- 可以将音乐播放器的状态同步到第三方App
- 能够和第三方App间进行相互通信
类似于CarLife 对音乐App的唤起,首先第三方App开启后,即可拉起音乐App,然后获取其中的歌单,打开歌单之后,获取歌单内的歌曲列表,点击进行播放,可以进行播放,暂停,下一首,上一首的控制。
技术实现
谷歌官方提供了MediaBroswerService,通过其可以帮助我们实现上述的需求。
MediaBroswerService
- Android多媒体架构
Android多媒体播放采用client,server架构,一个server可以对应多个client,client在使用的时候需要先连接到server,双方通过设置的一些callback来进行状态的同步。
使用MediaBrowserService播放
客户端需要创建MediaBrowser,服务端需要实现MediaBrowserService,在建立连接后,两端之间的交互主要通过MediaController和MediaSession。两个类之间通过预先定义的callback进行交互,MediaSession控制着播放器的播放,MediaController来控制着UI的变化。
- Media session
一个session持有了播放器的状态和关于正在播放的一些信息,一个seesion可以接收来自一个或多个媒体播放器的callback。这使得通过其它设备来控制成为可能。
- Media controller
我们的UI只是和Media controller交互,而不是Player 本身,Media controller会将一些控制信息传递给Media Session,它也会在seesion发生变化的时候,得到来自session的回调,一个media controller一次只可以连接一个session。当使用一个media contoller和Session的时候,我们可以在运行期部署多个播放器,在其执行的时候根据设备去修改app的外观。
使用MediaBrowserService可以让Android Wear, Auto非常容易找我们的App,连接它,浏览它的内容,控制其播放,而完全不需要接触我们的UI Activity。
服务端实现
- 服务端基础配置
mainfeat 配置
<service android:name=".MediaPlaybackService">
<intent-filter>
<action android:name="android.media.browse.MediaBrowserService" />
</intent-filter>
</service>
MediaPlaybackService的初始化
public class MediaPlaybackService extends MediaBrowserServiceCompat {
@Override
public void onCreate() {
super.onCreate();
// 1. 初始化 MediaSession
mSession = new MediaSessionCompat(this, "MusicService");
// 2. 设置 MedisSessionCallback
mSession.setCallback(mSessionCallback);
// 3. 开启 MediaButton 和 TransportControls 的支持
mSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS |
MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);
// 4. 初始化 PlaybackState
mStateBuilder = new PlaybackStateCompat.Builder()
.setActions(
PlaybackStateCompat.ACTION_PLAY | PlaybackStateCompat.ACTION_PLAY_PAUSE);
mSession.setPlaybackState(mStateBuilder.build());
// 5. 关联 SessionToken
setSessionToken(mSession.getSessionToken());
}
}
根据包名做权限判断之后,返回根路径
@Override
public BrowserRoot onGetRoot(String clientPackageName, int clientUid, Bundle rootHints) {
// 根据包名对每个访问端做一些访问权限判断等
}
用来根据mediaID来返回第三放App所需要获得媒体数据
@Override
public void onLoadChildren(final String parentMediaId,
final Result<List<MediaItem>> result) {
// 根据parentMediaId返回播放列表相关信息
}
客户端连接
private void initMediaBrowser() {
//1.待连接的服务
ComponentName componentName = new ComponentName("com.example.android.uamp","com.example.android.uamp.MusicService");
//2.创建MediaBrowser
mMediaBrowser = new MediaBrowserCompat(this, componentName, mConnectionCallbacks, null);
//3.建立连接
mMediaBrowser.connect();
}
设置相应的callback,连接Callback,数据变化Callback
连接状态同步
数据变化Callback设置
private final MediaBrowserCompat.ConnectionCallback mConnectionCallbacks =
new MediaBrowserCompat.ConnectionCallback() {
@Override
public void onConnected() {
//连接成功回调
}
@Override
public void onConnectionSuspended() {
//连接中断回调
}
@Override
public void onConnectionFailed() {
//连接失败回调
}
};
MediaControllerCompat.Callback controllerCallback =
new MediaControllerCompat.Callback() {
public void onSessionDestroyed() {
//Session销毁
}
@Override
public void onRepeatModeChanged(int repeatMode) {
//循环模式发生变化
}
@Override
public void onShuffleModeChanged(int shuffleMode) {
//随机模式发生变化
}
@Override
public void onMetadataChanged(MediaMetadataCompat metadata) {
//数据变化
}
@Override
public void onPlaybackStateChanged(PlaybackStateCompat state) {
//播放状态变化
}
};
客户端与服务端数据交互
MediaBrowser通过调用subscribe,会回调到MediaService的onLoadChildren,在这里做一个判断然后构造相应的列表将列表数据返回。返回数据之后。
- 根据MediaID获取数据
客户端通过调用subscribe方法,传递MediaID,在SubscriptionCallback的方法中进行处理。
mMediaBrowser.subscribe("ID", new MediaBrowserCompat.SubscriptionCallback() {
@Override
public void onChildrenLoaded(@NonNull String parentId, @NonNull List<MediaBrowserCompat.MediaItem> children) {
//children 为来自Service的列表数据
}
});
服务端和客户端之间传递的数据为MediaItem列表。MediaItem中具备的字段:MediaId,Title,SubTitle,Description,Icon,IconUri,MediaUri等字段。通过其可以帮助我们携带一些数据来进行歌曲的展示和播放。
@Override
public void onLoadChildren(@NonNull final String parentMediaId,
@NonNull final Result<List<MediaItem>> result) {
List<MediaItem> items = new ArrayList<>();
//根据MediaID做数据填充
switch (parentMediaId) {
case:
default: break;
}
result.sendResult(items);
}
- 发送自定义数据获取内容
客户端通过调用sendCustomAction,根据与服务端的协商,制定相应的action类型,进行数据的传递交互。
mMediaBrowser.sendCustomAction(action, extras, new MediaBrowserCompat.CustomActionCallback() {
@Override
public void onProgressUpdate(String action, Bundle extras, Bundle data) {
super.onProgressUpdate(action, extras, data);
}
@Override
public void onResult(String action, Bundle extras, Bundle resultData) {
super.onResult(action, extras, resultData);
}
@Override
public void onError(String action, Bundle extras, Bundle data) {
super.onError(action, extras, data);
}
});
服务端实现onCustomAction,根据action类型返回相应的数据
@Override
public void onCustomAction(@NonNull String action, Bundle extras, @NonNull Result<Bundle> result) {
//分支判断
if (GET_LIST.equals(action)) {
Bundle bundle = new Bundle();
ArrayList<String> list = new ArrayList<>();
//填充数据
bundle.putStringArrayList(LIST_NAMES, list);
result.sendResult(bundle);
}
}
播放控制
- 客户端
客户端通过getMediaController getTransportControls()来进行播放,暂停,上一首,下一首的控制。
//获取播放状态
int pbState = MediaControllerCompat.getMediaController(MainActivity.this).getPlaybackState().getState();
//根据播放状态进行播放控制
if (pbState == PlaybackStateCompat.STATE_PLAYING) {
MediaControllerCompat.getMediaController(MainActivity.this).getTransportControls().pause();
} else {
MediaControllerCompat.getMediaController(MainActivity.this).getTransportControls().play();
}
- 服务端
在服务端为MediaSession设置SessionCallback,来实现相应的播放功能。
mSession.setCallback(mSessionCallback);
客户端通过MediaController可以进行播放,暂停,根据MediaID播放下一个音乐,音乐播放快进等。所有的操作会回调到服务端的MediaSessionCallback的play,seekTo等方法,需要我们自己实现,在其中控制播放队列,然后根据列表播放的情况来动态的变更队列。
播放状态同步
对于播放状态的同步,比如当前播放到哪一个歌曲,当前是暂停还是播放中。客户端通过Controller回调就可以得到相应的变化,但是,变化状态,服务端如何发送呢?
setMetadata(android.media.MediaMetadata));
setPlaybackState(android.media.session.PlaybackState));
设置当前的歌曲信息,设置当前的播放状态。设置之后,客户端将会得到更新。
获取手机内的媒体服务
private void discoverBrowseableMediaApps(Context context) {
PackageManager packageManager = context.getPackageManager();
Intent intent = new Intent(MediaBrowserService.SERVICE_INTERFACE);
List<ResolveInfo> services = packageManager.queryIntentServices(intent, 0);
for (ResolveInfo resolveInfo : services) {
if (resolveInfo.serviceInfo != null && resolveInfo.serviceInfo.applicationInfo != null) {
ApplicationInfo applicationInfo = resolveInfo.serviceInfo.applicationInfo;
String label = (String) packageManager.getApplicationLabel(applicationInfo);
Drawable icon = packageManager.getApplicationIcon(applicationInfo);
String className = resolveInfo.serviceInfo.name;
String packageName = resolveInfo.serviceInfo.packageName;
MusicService service = new MusicService();
service.icon = icon;
service.lable = label;
service.className = className;
service.packageName = packageName;
musicServiceList.add(service);
}
}
}
结语
通过本篇文章,对MediaBroswerService做了一个简单的介绍,但对于播放器的具体实现,特别是在服务端还是比较复杂的,需要维护歌曲队列,进行播放,同时负责状态的更新。