loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

document media button handling prior to API level 21

Browse Source 
ISSUE: #6545
PiperOrigin-RevId: 281032120
This commit is contained in:
bachinger 2019-11-18 11:09:34 +00:00 committed by Oliver Woodman
parent 21957bf783
commit 07bfab8e4c
1 changed files with 12 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
extensions/mediasession/src/main/java/com/google/android/exoplayer2/ext/mediasession/MediaSessionConnector.java
View File

@ -30,6 +30,7 @@ import android.support.v4.media.session.MediaControllerCompat;
import android.support.v4.media.session.MediaSessionCompat;
import android.support.v4.media.session.PlaybackStateCompat;
import android.util.Pair;
import android.view.KeyEvent;
import androidx.annotation.LongDef;
import androidx.annotation.Nullable;
import com.google.android.exoplayer2.C;
@ -500,6 +501,17 @@ public final class MediaSessionConnector {
* Sets the {@link MediaButtonEventHandler}. Pass {@code null} if the media button event should be
* handled by {@link MediaSessionCompat.Callback#onMediaButtonEvent(Intent)}.
*
* <p>Please note that prior to API 21 MediaButton events are not delivered to the {@link
* MediaSessionCompat}. Instead they are delivered as key events (see <a
* href="https://developer.android.com/guide/topics/media-apps/mediabuttons">'Responding to media
* buttons'</a>). In an {@link android.app.Activity Activity}, media button events arrive at the
* {@link android.app.Activity#dispatchKeyEvent(KeyEvent)} method.
*
* <p>If you are running the player in a foreground service (prior to API 21), you can create an
* intent filter and handle the {@code android.intent.action.MEDIA_BUTTON} action yourself. See <a
* href="https://developer.android.com/reference/androidx/media/session/MediaButtonReceiver#service-handling-action_media_button">
* Service handling ACTION_MEDIA_BUTTON</a> for more information.
*
* @param mediaButtonEventHandler The {@link MediaButtonEventHandler}, or null to let the event be
* handled by {@link MediaSessionCompat.Callback#onMediaButtonEvent(Intent)}.
*/