基于MediaBroswerService的音乐客户端实现概述

前言

如何实现一个音乐播放App,然后让其可以被第三方的Android app打开,并获取其中的歌单,曲目列表,同时控制其播放呢?现有应用市场上,已经有相应的实现。比如百度CarLife对QQ音乐,喜马拉雅等的调用。

百度Carlife
百度Carlife

在百度的Carlife App中,我们可以看到,只要我们本地的装了QQ音乐App,其就可以唤起,然后获取其中的歌曲数据,然后进行播放,这个是如何实现的呢?

需求

  • 可以获取音乐播放器的歌曲列表
  • 可以控制音乐播放器的播放
  • 可以将音乐播放器的状态同步到第三方App
  • 能够和第三方App间进行相互通信

类似于CarLife 对音乐App的唤起,首先第三方App开启后,即可拉起音乐App,然后获取其中的歌单,打开歌单之后,获取歌单内的歌曲列表,点击进行播放,可以进行播放,暂停,下一首,上一首的控制。

技术实现

谷歌官方提供了MediaBroswerService,通过其可以帮助我们实现上述的需求。

MediaBroswerService

  • Android多媒体架构

Android多媒体播放采用client,server架构,一个server可以对应多个client,client在使用的时候需要先连接到server,双方通过设置的一些callback来进行状态的同步。

Android多媒体架构

使用MediaBrowserService播放

Android多媒体架构

客户端需要创建MediaBrowser,服务端需要实现MediaBrowserService,在建立连接后,两端之间的交互主要通过MediaController和MediaSession。两个类之间通过预先定义的callback进行交互,MediaSession控制着播放器的播放,MediaController来控制着UI的变化。

MediaController和MediaSession
  • 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);
image.png

客户端通过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做了一个简单的介绍,但对于播放器的具体实现,特别是在服务端还是比较复杂的,需要维护歌曲队列,进行播放,同时负责状态的更新。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,633评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,800评论 25 707
  • 赶 路 我从来不肯停下我匆忙的脚步, 并不是因为我真的有多么忙碌! 只是因为, 我一停下来, 便开始疯狂的思念你...
    远方的蒲苇阅读 177评论 0 2
  • 2017年5月23日-5月29日 生而为人,压力总是大的。今天开始记录日记,我在娘亲肚子里第26周。没错,我还未出...
    colorfulmood阅读 241评论 0 0
  • 少林寺位于河南省登封市嵩山五乳峰下,因坐落于嵩山腹地少室山茂密丛林之中,故名“少林寺”。始建于北魏太和十九年(49...
    剑桥有约阅读 334评论 0 0