# MediaRouteActionProvider

Artifact: [androidx.mediarouter:mediarouter](https://developer.android.com/jetpack/androidx/releases/mediarouter) [View Source](https://cs.android.com/search?q=file:androidx/mediarouter/app/MediaRouteActionProvider.java+class:androidx.mediarouter.app.MediaRouteActionProvider) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

*** ** * ** ***


```
public class MediaRouteActionProvider extends ActionProvider
```

<br />

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) |||
| ↳ | [androidx.core.view.ActionProvider](https://developer.android.com/reference/androidx/core/view/ActionProvider) ||
|   | ↳ | [androidx.mediarouter.app.MediaRouteActionProvider](https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider) |

*** ** * ** ***

The media route action provider displays a `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteButton` in the application's `https://developer.android.com/reference/androidx/appcompat/app/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 `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteSelector` with the `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setRouteSelector(androidx.mediarouter.media.MediaRouteSelector)` method.

Refer to `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteButton` for a description of the button that will appear in the action bar menu.

### Prerequisites

To use the media route action provider, the activity must be a subclass of `https://developer.android.com/reference/androidx/appcompat/app/AppCompatActivity` from the `android.support.v7.appcompat` support library. Refer to support library documentation for details.

### Example

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="androidx.mediarouter.app.MediaRouteActionProvider"/>
</menu>
```

Then configure the menu and set the route selector for the chooser.

```
public class MyActivity extends AppCompatActivity {
    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 callback flag CALLBACK_FLAG_REQUEST_DISCOVERY on stop by calling
    // addCallback() again in order 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() {
        mRouter.addCallback(mSelector, mCallback, /* flags= */ 0);

        super.onStop();
    }

    // Remove the callback when the activity is destroyed.
    public void onDestroy() {
        mRouter.removeCallback(mCallback);

        super.onDestroy();
    }

    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.
    }
}
```

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setRouteSelector(androidx.mediarouter.media.MediaRouteSelector)` |   |

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#MediaRouteActionProvider(android.content.Context)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context)` Creates the action provider. |

| ### Public methods |
|---|---|
| `void` | `[enableDynamicGroup](https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#enableDynamicGroup())()` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouterParams.Builder#setDialogType(int)` with `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouterParams#DIALOG_TYPE_DYNAMIC_GROUP()` instead. <br /> |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteDialogFactory` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#getDialogFactory()()` Gets the media route dialog factory to use when showing the route chooser or controller dialog. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteButton` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#getMediaRouteButton()()` Gets the associated media route button, or null if it has not yet been created. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteSelector` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#getRouteSelector()()` Gets the media route selector for filtering the routes that the user can select using the media route chooser dialog. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/View.html` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#onCreateActionView()()` Factory method for creating new action views. |
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteButton` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#onCreateMediaRouteButton()()` Called when the media route button is being created. |
| `boolean` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#onPerformDefaultAction()()` Performs an optional default action. |
| `void` | `[setAlwaysVisible](https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setAlwaysVisible(boolean))(boolean alwaysVisible)` **This method is deprecated.** The visibility of the button is no longer controlled from `https://developer.android.com/reference/androidx/core/view/ActionProvider`. <br /> |
| `void` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setDialogFactory(androidx.mediarouter.app.MediaRouteDialogFactory)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteDialogFactory factory)` Sets the media route dialog factory to use when showing the route chooser or controller dialog. |
| `void` | `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setRouteSelector(androidx.mediarouter.media.MediaRouteSelector)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteSelector selector)` Sets the media route selector for filtering the routes that the user can select using the media route chooser dialog. |

### Inherited methods

From [androidx.core.view.ActionProvider](https://developer.android.com/reference/androidx/core/view/ActionProvider) `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html` `https://developer.android.com/reference/androidx/core/view/ActionProvider#getContext()()`

Gets the context associated with this action provider.
`boolean` `https://developer.android.com/reference/androidx/core/view/ActionProvider#hasSubMenu()()`

Determines if this ActionProvider has a submenu associated with it.
`boolean` `https://developer.android.com/reference/androidx/core/view/ActionProvider#isVisible()()`

If `https://developer.android.com/reference/androidx/core/view/ActionProvider#overridesItemVisibility()` returns true, the return value of this method will help determine the visibility of the `https://developer.android.com/reference/android/view/MenuItem.html` this ActionProvider is bound to.
`@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/View.html` `https://developer.android.com/reference/androidx/core/view/ActionProvider#onCreateActionView(android.view.MenuItem)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/MenuItem.html forItem)`

Factory method called by the Android framework to create new action views.
`void` `https://developer.android.com/reference/androidx/core/view/ActionProvider#onPrepareSubMenu(android.view.SubMenu)(@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/SubMenu.html subMenu)`

Called to prepare an associated submenu for the menu item backed by this ActionProvider.
`boolean` `https://developer.android.com/reference/androidx/core/view/ActionProvider#overridesItemVisibility()()`

The result of this method determines whether or not `https://developer.android.com/reference/androidx/core/view/ActionProvider#isVisible()` will be used by the `https://developer.android.com/reference/android/view/MenuItem.html` this ActionProvider is bound to help determine its visibility.
`void` `https://developer.android.com/reference/androidx/core/view/ActionProvider#refreshVisibility()()`

If this ActionProvider is associated with an item in a menu, refresh the visibility of the item based on `https://developer.android.com/reference/androidx/core/view/ActionProvider#overridesItemVisibility()` and `https://developer.android.com/reference/androidx/core/view/ActionProvider#isVisible()`.
`void` `https://developer.android.com/reference/androidx/core/view/ActionProvider#setVisibilityListener(androidx.core.view.ActionProvider.VisibilityListener)(
@https://jspecify.dev/docs/api/org/jspecify/annotations/Nullable.html https://developer.android.com/reference/androidx/core/view/ActionProvider.VisibilityListener listener
)`

Set a listener to be notified when this ActionProvider's overridden visibility changes.

## Public constructors

### MediaRouteActionProvider

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public MediaRouteActionProvider(@NonNull Context context)
```

Creates the action provider.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/content/Context.html context` | The context. |

## Public methods

### enableDynamicGroup

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0) Deprecated in [1.2.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.2.0)

```
public void [enableDynamicGroup](https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#enableDynamicGroup())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouterParams.Builder#setDialogType(int)` with `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouterParams#DIALOG_TYPE_DYNAMIC_GROUP()` instead.

Enables dynamic group feature. With this enabled, a different set of `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteChooserDialog` and `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteControllerDialog` is shown when the button is clicked. If a `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteProvider` supports dynamic group, the users can use that feature with the dialogs.

| See also |
|---|---|
| `https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteButton#enableDynamicGroup()` |   |
| `https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteProvider.DynamicGroupRouteController` |   |

### getDialogFactory

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public @NonNull MediaRouteDialogFactory getDialogFactory()
```

Gets the media route dialog factory to use when showing the route chooser or controller dialog.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteDialogFactory` | The dialog factory, never null. |

### getMediaRouteButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public @Nullable MediaRouteButton getMediaRouteButton()
```

Gets the associated media route button, or null if it has not yet been created.

### getRouteSelector

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public @NonNull MediaRouteSelector getRouteSelector()
```

Gets the media route selector for filtering the routes that the user can select using the media route chooser dialog.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteSelector` | The selector, never null. |

### onCreateActionView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public @NonNull View onCreateActionView()
```

Factory method for creating new action views.

| Returns |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/android/view/View.html` | A new action view. |

### onCreateMediaRouteButton

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public @NonNull MediaRouteButton onCreateMediaRouteButton()
```

Called when the media route button is being created.

Subclasses may override this method to customize the button.

### onPerformDefaultAction

```
public boolean onPerformDefaultAction()
```

Performs an optional default action.

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:

- Receiving a call to `https://developer.android.com/reference/android/view/MenuItem.OnMenuItemClickListener.html#onMenuItemClick(android.view.MenuItem)`.
- Receiving a call to `https://developer.android.com/reference/android/app/Activity.html#onOptionsItemSelected(android.view.MenuItem)` FragmentActivity.onOptionsItemSelected(MenuItem)}
- Receiving a call to `https://developer.android.com/reference/androidx/fragment/app/Fragment#onOptionsItemSelected(android.view.MenuItem)` Fragment.onOptionsItemSelected(MenuItem)}
- Launching the `https://developer.android.com/reference/android/content/Intent.html` set via `https://developer.android.com/reference/android/view/MenuItem.html#setIntent(android.content.Intent)`
- Invoking this method.

The default implementation does not perform any action and returns false.

### setAlwaysVisible

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0) Deprecated in [1.6.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.6.0)

```
public void [setAlwaysVisible](https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteActionProvider#setAlwaysVisible(boolean))(boolean alwaysVisible)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> The visibility of the button is no longer controlled from `https://developer.android.com/reference/androidx/core/view/ActionProvider`.

Does nothing. You should not call this method.

### setDialogFactory

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public void setDialogFactory(@NonNull MediaRouteDialogFactory factory)
```

Sets the media route dialog factory to use when showing the route chooser or controller dialog.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/app/MediaRouteDialogFactory factory` | The dialog factory, must not be null. |

### setRouteSelector

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/mediarouter#1.1.0)

```
public void setRouteSelector(@NonNull MediaRouteSelector selector)
```

Sets the media route selector for filtering the routes that the user can select using the media route chooser dialog.

| Parameters |
|---|---|
| `@https://jspecify.dev/docs/api/org/jspecify/annotations/NonNull.html https://developer.android.com/reference/androidx/mediarouter/media/MediaRouteSelector selector` | The selector, must not be null. |