Configure the Media Plugins
The off-the-shelf media plugin comes with default configuration. This configuration provides a default behavior, such as showing a mini player when music is playing. This configuration is based on the configuration-framework and can be changed if necessary. This guide explains this procedure.
If you want to configure the media frontend plugin for specific media sources, you can follow this guide: How to customize a media source.
Media plugin default configuration
The media plugin default configuration is defined as a resource file that contains configuration keys and their values. The following keys and values are defined in the media plugin:
examples/media/miniplayer/src/main/res/values/example-media-configuration.xml
1<resources>2 <!-- Indicates whether the media frontend has a mini player or not; `true` by default. -->3 <bool name="hasMiniPlayerConfigKey">true</bool>4</resources>
Change the media plugin configuration
The media plugin default configuration can be changed by adding a custom configuration resource file
in your application. The custom configuration overrides the default values with the ones provided.
For an example, see the
template/app/res/value/ttivi-media-configuration.xml
file.
Configuring the mini player
When audio is playing, a mini player is shown on the home screen.
If you don't want to use the mini player provided with the off-the-shelf media plugin, or you
want to implement your own frontend plugin for the mini player, you can configure it by setting the
hasMiniPlayerConfigKey
to false
:
<bool name="hasMiniPlayerConfigKey">false</bool>
Configuring the dashboard shortcut button
The dashboard shortcut button is shown in the top right corner of the media screen during browsing the media sources. It quickly returns the user to the dashboard.
If you want to hide the dashboard shortcut button within the off-the-shelf media plugin, you
can configure it by setting the hasDashboardButtonConfigKey
to false
:
<bool name="hasDashboardButtonConfigKey">false</bool>
Configuring the collection panel play/pause button
The collection panel contains a button to play or pause the entire media collection. By default this
button shows a text:
If you want to change it and show an icon instead of the text, you can configure it by setting the
useTextForCollectionPlayPauseButtonConfigKey
to false
:
<bool name="useTextForCollectionPlayPauseButtonConfigKey">false</bool>
