Media Controller Test
Create a simple MediaController that connects to a MediaBrowserService
in order to test inter-app media controls.
This app works with the Universal Android Music Player sample,
or any other app that implements the media APIs.
https://github.com/googlesamples/android-UniversalMusicPlayer
Usage
- Select an app from the list of those presented.
- Only apps that register a service with an intent filter action of
"android.media.browse.MediaBrowserService" will be shown.
- Only apps that register a service with an intent filter action of
- Select the type of action to perform to start the player. Options are:
- Search: Sends the text provided as a search via prepareFromSearch() or
playFromSearch(). - Media ID: Sends the text provided as a media ID via prepareFromMediaId() or
playFromMediaId(). - URI: Sends the text provided as a URI via prepareFromUri() or
playFromUri(). - No Input: Calls the methods prepare() or play() directly.
- Search: Sends the text provided as a search via prepareFromSearch() or
- Text below the
PREPAREandPLAYbuttons updates based on changes to
the media player state via onPlaybackStateChanged and onMetadataChanged and
includes the current player state reported via PlaybackStateCompat.getState(). - Swipe to the left to see typical media controls with the media's art as a
background, if provided. - Press
backto return to the list of media apps.
Via ADB
It's also possible to launch the app via ADB and the Activity manager (am).
Parameter, Extra Name
----------, -----------
Package name, com.example.android.mediacontroller.PACKAGE_NAME
Search term, com.example.android.mediacontroller.SEARCH
Media ID, com.example.android.mediacontroller.MEDIA_ID
URI, com.example.android.mediacontroller.URI
To start the app and connect to UAMP:
adb shell am start -n com.example.android.mediacontroller/.LaunchActivity --es com.example.android.mediacontroller.PACKAGE_NAME "com.example.android.uamp"
To perform a search with the term "jazz?" one would use:
adb shell am start -n com.example.android.mediacontroller/.MediaAppControllerActivity --es com.example.android.mediacontroller.SEARCH "jazz?"
Verification
Audio Focus
This app allows for testing how media apps respond to audio focus changes.
The app allows requesting and abandoning the following types of audio focus:
- AUDIOFOCUS_GAIN
- AUDIOFOCUS_GAIN_TRANSIENT
- AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK
For more information on audio focus please see
Managing Audio Focus.
Supported Actions
This tool displays the supported actions as reported by the MediaSession in the call to
MediaSessionCompat.setPlaybackState()
as a list of prepare and play actions on the main screen. For actions that are not declared as
supported, it also colors the buttons red on the controller screen.
See the screenshots below for examples.
Screenshots
License
Copyright 2017 Google Inc. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.