Android API Guide for Media Apps（五）——构建媒体浏览客户端（Building a Media Browser Client）

构建媒体浏览客户端（Building a Media Browser Client）

为了完成client/server的设计，你必须构建一个包含UI代码，关联MediaController和MediaBrowser的activity组件。

MediaBrowser实现两个重要的功能：连接MediaBrowserService，并连接上后创建UI的MediaController。

连接MediaBrowserService（Connect to the MediaBrowserService）

当你的客户端activity被创建，它连接一个MediaBrowserService。这里有很少的交互涉及。如下修改activity的生命周期回调：

• onCreate() 构造一个MediaBrowserCompat。传入你MediaBrowserService和已定义的MediaBrowserCompat.ConnectionCallback 的名字。

• onStart() 连接MediaBrowserService。这就是MediaBrowserCompat.ConnectionCallback的神奇之处。如果连接成功，onConnect()的回调会创建媒体控制器，并连接它的媒体会话，连接你的UI控件到MediaController上并从媒体会话中注册这个控制器到接收的回调上。

• onStop() 在activity停止时断开MediaBrowser的连接并注销 MediaController.Callback。

public class MediaPlayerActivity extends AppCompatActivity {
  private MediaBrowserCompat mMediaBrowser;

   @Override
   public void onCreate() {
   // Create MediaBrowserServiceCompat
   mMediaBrowser = new MediaBrowserCompat(context,
   new ComponentName(this, MediaPlaybackService.class),
   mConnectionCallbacks,
   null); // optional Bundle

    @Override
    public void onStart() {
        super.onStart();
        mMediaBrowser.connect();
    }

    @Override
    public void onStop() {
        super.onStop();
        // (see "stay in sync with the MediaSession")
        if (MediaControllerCompat.getMediaController(MediaPlayerActivity.this) != null) {
            MediaControllerCompat.getMediaController(MediaPlayerActivity.this).unregisterCallback(controllerCallback);
        }
        mMediaBrowser.disconnect();

    }

}

自定义MediaBrowserCompat.ConnectionCallback（Customize MediaBrowserCompat.ConnectionCallback）

当你的activity构造MediaBrowserCompat，你必须创建一个ConnectionCallback实例。修改它的onConnected()方法来获取MediaBrowserService 中的媒体会话token以便创建MediaControllerCompat。

使用方法 MediaControllerCompat.setMediaController() 来保存与控制器的连接。这可以处理媒体按钮，它也可以让你在构建传送控件时调用 MediaControllerCompat.getMediaController() 来获取控制器。

下面的示例代码展示如何修改onConnected()方法。

private final MediaBrowserCompat.ConnectionCallback mConnectionCallbacks =
  new MediaBrowserCompat.ConnectionCallback() {
    @Override
    public void onConnected() {

      // Get the token for the MediaSession
      MediaSessionCompat.Token token = mediaBrowser.getSessionToken();

      // Create a MediaControllerCompat
MediaControllerCompat mediaController =
  new MediaControllerCompat(MediaPlayerActivity.this, // Context
    token);

    // Save the controller
    MediaControllerCompat.setMediaController(MediaPlayerActivity.this, mediaController);

    // Finish building the UI
    buildTransportControls();

    }

    @Override
    public void onConnectionSuspended() {
      // The Service has crashed. Disable transport controls until it automatically reconnects
    }

    @Override
    public void onConnectionFailed() {
      // The Service has refused our connection
    }
  };

连接UI到媒体控制器上（Connect your UI to the media controller）

在上面的ConnectionCallback 示例中，包含了调用buildTransportControls()填充你的UI。你还需要为控制播放器的UI节点设置onClickListeners 。为每个按钮选择适当的MediaControllerCompat.TransportControls 方法。

使用onClickListener 给每个按钮设置监听的代码一般如下：

void buildTransportControls()
{
  // Grab the view for the play/pause button
  mPlayPause = (ImageView) findViewById(R.id.play_pause);

  // Attach a listener to the button
  mPlayPause.setOnClickListener(new View.OnClickListener() {
      @Override
      public void onClick(View v) {
                    // Since this is a play/pause button, you'll need to test the current state
                    // and choose the action accordingly

                    int pbState = MediaControllerCompat.getMediaController(MediaPlayerActivity.this).getPlabackState().getState();
                    If (pbState == PlaybackState.STATE_PLAYING)
              MediaControllerCompat.getMediaController(MediaPlayerActivity.this).getTransportControls().pause();
                    else
              MediaControllerCompat.getMediaController(MediaPlayerActivity.this).getTransportControls().play();

      }
  });

  MediaControllerCompat mediaController = MediaControllerCompat.getMediaController(MediaPlayerActivity.this);

  // Display the initial state
  MetadataCompat metadata = mediaController.getMetadata();
  PlaybackStateCompat pbState = mediaController.getPlabackState();

  // Register a Callback to stay in sync
  mediaController.registerCallback(controllerCallback)
}

TransportControls 方法发送回调方法到你服务的媒体会话中。确保你已为每个控件定义一个对应的MediaSessionCompat.Callback方法。

使用媒体会话保持同步（Stay in sync with the media session）

UI应该显示当前媒体会话的状态，正如PlaybackState 和Metadata描述。当你创建一个传送控件时，你可以获取当前会话的状态，并在你的UI中显示它，以及基于该状态和可用的事件来启用和禁用传送控件。

为了每次从媒体会话中获取回调的状态和元数据的变更，使用下面两个方法定义一个MediaControllerCompat.Callback。

MediaControllerCompat.Callback controllerCallback =
  new MediaControllerCompat.Callback() {
    @Override
    public void onMetadataChanged(MediaMetadataCompat metadata) {}

    @Override
    public void onPlaybackStateChanged(PlaybackStateCompat state) {}
  });

在构建传送控件时注册回调（参看buildTransportControls()方法）和杂activity停止（在activity生命周期中的onStop()）注销它。