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

@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();
    }
}

//通过如下代码连接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 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();
 }
//当然还有很多回调函数，大家可以自行查看
}