MediaRouteActionProvider

public class MediaRouteActionProvider
extends ActionProvider

媒体路由操作提供显示 media route button在应用程序的 ActionBar ，允许用户选择路线和控制当前选择的路线。

应用程序必须指定用户应该被允许通过使用 setRouteSelector(MediaRouteSelector)方法指定 selector来选择的路线种类。

有关将出现在操作栏菜单中的按钮的说明，请参阅MediaRouteButton 。 请注意，如果没有路线可用，则禁用该按钮，而不是使操作提供程序使菜单项不可见。 这样，只有当用户可以发现并选择匹配的路线时，该按钮才可见。

Prerequisites

使用媒体路由操作提供者，必须将活动的一个子类AppCompatActivity从android.support.v7.appcompat支持库。 有关详细信息，请参阅支持库文档。

Example

应用程序应定义一个菜单资源，以将提供程序包含在操作栏选项菜单中。 请注意，支持库操作栏使用应用程序的资源命名空间中定义的属性，而不是框架的资源命名空间来配置每个项目。

 <menu xmlns:android="http://schemas.android.com/apk/res/android"
         xmlns:app="http://schemas.android.com/apk/res-auto">
     <item android:id="@+id/media_route_menu_item"
         android:title="@string/media_route_menu_title"
         app:showAsAction="always"
         app:actionProviderClass="android.support.v7.app.MediaRouteActionProvider"/>
 </menu>
 

然后配置菜单并为选择器设置路由选择器。

 public class MyActivity extends ActionBarActivity {
     private MediaRouter mRouter;
     private MediaRouter.Callback mCallback;
     private MediaRouteSelector mSelector;

     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);

         mRouter = Mediarouter.getInstance(this);
         mSelector = new MediaRouteSelector.Builder()
                 .addControlCategory(MediaControlIntent.CATEGORY_LIVE_AUDIO)
                 .addControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)
                 .build();
         mCallback = new MyCallback();
     }

     // Add the callback on start to tell the media router what kinds of routes
     // the application is interested in so that it can try to discover suitable ones.
     public void onStart() {
         super.onStart();

         mediaRouter.addCallback(mSelector, mCallback,
                 MediaRouter.CALLBACK_FLAG_REQUEST_DISCOVERY);

         MediaRouter.RouteInfo route = mediaRouter.updateSelectedRoute(mSelector);
         // do something with the route...
     }

     // Remove the selector on stop to tell the media router that it no longer
     // needs to invest effort trying to discover routes of these kinds for now.
     public void onStop() {
         super.onStop();

         mediaRouter.removeCallback(mCallback);
     }

     public boolean onCreateOptionsMenu(Menu menu) {
         super.onCreateOptionsMenu(menu);

         getMenuInflater().inflate(R.menu.sample_media_router_menu, menu);

         MenuItem mediaRouteMenuItem = menu.findItem(R.id.media_route_menu_item);
         MediaRouteActionProvider mediaRouteActionProvider =
                 (MediaRouteActionProvider)MenuItemCompat.getActionProvider(mediaRouteMenuItem);
         mediaRouteActionProvider.setRouteSelector(mSelector);
         return true;
     }

     private final class MyCallback extends MediaRouter.Callback {
         // Implement callback methods as needed.
     }
 }
 

Summary

Inherited methods
From class android.support.v4.view.ActionProvider Context getContext() 获取与此操作提供者关联的上下文。 boolean hasSubMenu() 确定此ActionProvider是否具有与其关联的子菜单。 boolean isVisible() 如果 overridesItemVisibility()返回true，则此方法的返回值将有助于确定此ActionProvider绑定的 MenuItem的可见性。 abstract View onCreateActionView() 用于创建新操作视图的工厂方法。 View onCreateActionView(MenuItem forItem) 由Android框架调用的工厂方法来创建新的操作视图。 boolean onPerformDefaultAction() 执行可选的默认操作。 void onPrepareSubMenu(SubMenu subMenu) 调用以为由此ActionProvider支持的菜单项准备相关的子菜单。 boolean overridesItemVisibility() 这种方法的结果，判断是否 isVisible()将由使用 MenuItem此ActionProvider必然会有助于确定其可见性。 void refreshVisibility() 如果此ActionProvider与菜单中的项目关联，请根据 overridesItemVisibility()和 isVisible()刷新该项目的可见性。 void setVisibilityListener(ActionProvider.VisibilityListener listener) 设置一个侦听器，当这个ActionProvider被覆盖的可见性发生变化时通知它。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程为此对象调用 notify()方法或 notifyAll()方法，或者经过指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

MediaRouteActionProvider (Context context)

Public methods

MediaRouteDialogFactory getDialogFactory ()

MediaRouteButton getMediaRouteButton ()

MediaRouteSelector getRouteSelector ()

boolean isVisible ()

View onCreateActionView ()

MediaRouteButton onCreateMediaRouteButton ()

boolean onPerformDefaultAction ()

boolean overridesItemVisibility ()

void setDialogFactory (MediaRouteDialogFactory factory)

void setRouteSelector (MediaRouteSelector selector)