Android P Media源码笔记

对MediaMession框架的刷新与补充

总结
Mession底层仍是使用AIDL，它的优点和缺点同样突出
优点：完全统一了调用接口和回调接口，界面与不同类型音乐服务可以完全解耦、切换。
缺点：回调接口固定，限制较多，外部应用调用麻烦（需要完全理解框架并编写客户端）；

(1)建立连接

客户端：
第一步，创建mediaBrowser，绑定服务，并关联绑定回调

MediaBrowserCompat mediaBrowser = new MediaBrowserCompat(this,
            new ComponentName(this, MusicService.class), //绑定浏览器服务
            mConnectionCallback,//关联连接回调
            null);

第二步，获取mediaController，一般是在连接成功的回调中。当然源码在MediaSource中选择暴露获取controller的方法

//一般在连接回调获得
MediaBrowserCompat.ConnectionCallback mConnectionCallback =
new MediaBrowserCompat.ConnectionCallback() {
    @Override
    public void onConnected() {
        MediaSessionCompat.Token token = mMediaBrowser.getSessionToken();
        MediaControllerCompat mediaController = new MediaControllerCompat(this, token);
        //注册服务的回调
        mediaController.registerCallback(mMediaControllerCallback);
    }
};  
//MediaSource中
public MediaController getMediaController() {
    if (mBrowser == null || !mBrowser.isConnected()) {
        return null;
    }
    MediaSession.Token token = mBrowser.getSessionToken();
    return new MediaController(mContext, token);
}

本质是一样的，其中token相当于钥匙。然后就可以用mediaController来进行对服务的控制了，而

MediaController.CallBack

服务端：
第一步，继承MediaBrowserService，重写

onGetRoot(..)

onLoadChildren(..)

@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> result) {
    ....
}

第二步，初始化服务端对象Session

//初始化
MediaSessionCompat mSession = new MediaSessionCompat(this, "MusicService");
//表示MediaBrowser与MediaBrowserService连接成功
setSessionToken(mSession.getSessionToken());
//设置控制监听
mSession.setCallback(SessionCallback);
mSession.setFlags(MediaSessionCompat.FLAG_HANDLES_MEDIA_BUTTONS | MediaSessionCompat.FLAG_HANDLES_TRANSPORT_CONTROLS);

这里seesionCallBack就是

MediaSessionCompat.Callback

(2)控制与回调
客户端控制：可以使用

mediaController.getTransportControls().skipToNext()

private android.support.v4.media.session.MediaSessionCompat.Callback SessionCallback = new MediaSessionCompat.Callback(){
    
    @Override
    public void onPlay() {
            ....
        }
    
    @Override
    public void onPause() {
            ....
        }
        .....
    }

此外，源码中显示mediaController可以获取当前播放媒体信息，播放状态等等，大致方法：

public MediaMetadata getMetadata() {...}
public PlaybackState getPlaybackState() {...}
public List getQueue(){...}
public CharSequence getQueueTitle(){....}

服务端回调：可以调用

session.setMetadata(MediaMetadata)

MediaController.CallBack

//媒体控制器控制播放过程中的回调接口
MediaControllerCompat.Callback mMediaControllerCallback =
   new MediaControllerCompat.Callback() {
        @Override
        public void onPlaybackStateChanged(@NonNull PlaybackStateCompat state) {
            //响应session.setPlaybackState(PlaybackState)
            //播放状态发生改变时的回调
            onMediaPlayStateChanged(state);
        }
        @Override
        public void onMetadataChanged(MediaMetadataCompat metadata) {
            //响应session.setMetadata(MediaMetadata)
            //播放的媒体数据发生变化时的回调
            if(metadata == null) {
                return;
            }
            onPlayMetadataChanged(metadata);
        }
    };

(3)异步主动获取信息
客户端：mediaBrowser发起信息请求，注意发起前需要先unsubscribe，好像是官方bug。这里传入的ID，在服务端进行对请求的区分。

//----------异步获取数据------
//订阅/发起信息请求
mediaBrowser.unsubscribe(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH);
mediaBrowser.subscribe(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH, mSubscriptionCallback);
//异步回调接口
MediaBrowserCompat.SubscriptionCallback mSubscriptionCallback =
    new MediaBrowserCompat.SubscriptionCallback() {
        @Override
        public void onChildrenLoaded(@NonNull String parentId,
                                     @NonNull List children) {
            //数据获取成功后的回调
        }
        @Override
        public void onError(@NonNull String id) {
            //数据获取失败的回调
        }
    };

这部分源码很复杂，主要是在MediaSource.java中，简单说明对外调用的方法是

subscribeChildren(...)

MediaBrowser.SubscriptionCallback

public void subscribeChildren(@Nullable String parentId, ItemsSubscription callback) {
    if (mBrowser == null) {
        throw new IllegalStateException("Browsing is not available for this source: "
                + getName());
    }
    if (mRootNode == null && !mBrowser.isConnected()) {
        throw new IllegalStateException("Subscribing to the root node can only be done while "
                + "connected: " + getName());
    }
    mRootNode = mBrowser.getRoot();
    String itemId = parentId != null ? parentId : mRootNode;
    ChildrenSubscription subscription = mChildrenSubscriptions.get(itemId);
    if (subscription != null) {
        subscription.add(callback);
    } else {
        subscription = new ChildrenSubscription(mBrowser, itemId);
        subscription.add(callback);
        mChildrenSubscriptions.put(itemId, subscription);
        subscription.start(CHILDREN_SUBSCRIPTION_RETRIES,
                CHILDREN_SUBSCRIPTION_RETRY_TIME_MS);
    }
}

服务端：继承MediaBrowserService时就必须重写

onLoadChildren(..)

parentId

result.sendResult(mediaItems)

list

result.detach();

@Override
public void onLoadChildren(@NonNull String parentId, @NonNull Result<List> result) {
    if(BrowserRootId.MEDIA_ID_MUSIC_LIST_REFRESH.equals(parentId)) {
        //一定要先detach()
        result.detach();
        //模拟获取数据的过程
        MediaMetadataCompat metadata = new MediaMetadataCompat.Builder()
                .putString(MediaMetadataCompat.METADATA_KEY_MEDIA_ID, ""+R.raw.jinglebells)
                .putString(MediaMetadataCompat.METADATA_KEY_TITLE, "圣诞歌")
                .build();
        ArrayList mediaItems = new ArrayList();
        mediaItems.add(createMediaItem(metadata));
        //向Browser发送数据,返回的是一个List
        result.sendResult(mediaItems);
    } else {
        result.detach();
    }
}

这部分服务代码就很多了，根据parentId进行区分再读取数据返回

(4)QueueItem和MediaMetadata

session.setQueue(List)

List

在DataModel.java中找到栗子：

MediaDescription.Builder builder = new MediaDescription.Builder()
    .setMediaId(cursor.getString(keyColumn))
    .setTitle(cursor.getString(titleColumn))
    .setExtras(path);
if (subtitleColumn != -1) {
    builder.setSubtitle(cursor.getString(subtitleColumn));
}
MediaDescription description = builder.build();
results.add(new MediaItem(description, mFlags));
// We rebuild the queue here so if the user selects the item then we
// can immediately use this queue.
if (mQueue != null) {
    mQueue.add(new QueueItem(description, idx));
}
idx++;

以上是读取数据时，创建QueueItem和MediaItem区别，首先都是有description作为参数，区别在于MediaItem有一个mFlags标志位，而mQueue的参数idx是唯一不重复的id。