public class MediaRouteActionProvider extends ActionProvider
media route button
in the application's ActionBar
to allow the user to select routes and
to control the currently selected route.
The application must specify the kinds of routes that the user should be allowed
to select by specifying a selector
with the
setRouteSelector(android.support.v7.media.MediaRouteSelector)
method.
Refer to MediaRouteButton
for a description of the button that will
appear in the action bar menu. Note that instead of disabling the button
when no routes are available, the action provider will instead make the
menu item invisible. In this way, the button will only be visible when it
is possible for the user to discover and select a matching route.
To use the media route action provider, the activity must be a subclass of
AppCompatActivity
from the android.support.v7.appcompat
support library. Refer to support library documentation for details.
The application should define a menu resource to include the provider in the action bar options menu. Note that the support library action bar uses attributes that are defined in the application's resource namespace rather than the framework's resource namespace to configure each item.
<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>
Then configure the menu and set the route selector for the chooser.
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. } }
ActionProvider.SubUiVisibilityListener, ActionProvider.VisibilityListener
Constructor and Description |
---|
MediaRouteActionProvider(Context context)
Creates the action provider.
|
Modifier and Type | Method and Description |
---|---|
MediaRouteDialogFactory |
getDialogFactory()
Gets the media route dialog factory to use when showing the route chooser
or controller dialog.
|
MediaRouteButton |
getMediaRouteButton()
Gets the associated media route button, or null if it has not yet been created.
|
MediaRouteSelector |
getRouteSelector()
Gets the media route selector for filtering the routes that the user can
select using the media route chooser dialog.
|
boolean |
isVisible()
If
ActionProvider.overridesItemVisibility() returns true, the return value of this method
will help determine the visibility of the MenuItem this ActionProvider is bound to. |
View |
onCreateActionView()
Factory method for creating new action views.
|
MediaRouteButton |
onCreateMediaRouteButton()
Called when the media route button is being created.
|
boolean |
onPerformDefaultAction()
Performs an optional default action.
|
boolean |
overridesItemVisibility()
The result of this method determines whether or not
ActionProvider.isVisible() will be used
by the MenuItem this ActionProvider is bound to help determine its visibility. |
void |
setDialogFactory(MediaRouteDialogFactory factory)
Sets the media route dialog factory to use when showing the route chooser
or controller dialog.
|
void |
setRouteSelector(MediaRouteSelector selector)
Sets the media route selector for filtering the routes that the user can
select using the media route chooser dialog.
|
getContext, hasSubMenu, onCreateActionView, onPrepareSubMenu, refreshVisibility, reset, setSubUiVisibilityListener, setVisibilityListener, subUiVisibilityChanged
public MediaRouteActionProvider(Context context)
context
- The context.@NonNull public MediaRouteSelector getRouteSelector()
public void setRouteSelector(@NonNull MediaRouteSelector selector)
selector
- The selector, must not be null.@NonNull public MediaRouteDialogFactory getDialogFactory()
public void setDialogFactory(@NonNull MediaRouteDialogFactory factory)
factory
- The dialog factory, must not be null.@Nullable public MediaRouteButton getMediaRouteButton()
public MediaRouteButton onCreateMediaRouteButton()
Subclasses may override this method to customize the button.
public View onCreateActionView()
ActionProvider
onCreateActionView
in class ActionProvider
public boolean onPerformDefaultAction()
ActionProvider
For the case of an action provider placed in a menu item not shown as an action this method is invoked if previous callbacks for processing menu selection has handled the event.
A menu item selection is processed in the following order:
MenuItem.OnMenuItemClickListener.onMenuItemClick
.Activity.onOptionsItemSelected(android.view.MenuItem)
FragmentActivity.onOptionsItemSelected(MenuItem)}
Fragment.onOptionsItemSelected(android.view.MenuItem)
Fragment.onOptionsItemSelected(MenuItem)}Intent
set via
MenuItem.setIntent(android.content.Intent)
The default implementation does not perform any action and returns false.
onPerformDefaultAction
in class ActionProvider
public boolean overridesItemVisibility()
ActionProvider
ActionProvider.isVisible()
will be used
by the MenuItem
this ActionProvider is bound to help determine its visibility.overridesItemVisibility
in class ActionProvider
ActionProvider.isVisible()
public boolean isVisible()
ActionProvider
ActionProvider.overridesItemVisibility()
returns true, the return value of this method
will help determine the visibility of the MenuItem
this ActionProvider is bound to.
If the MenuItem's visibility is explicitly set to false by the application, the MenuItem will not be shown, even if this method returns true.
isVisible
in class ActionProvider