com.google.android.exoplayer2.ext.mediasession

Class TimelineQueueEditor

java.lang.Object

com.google.android.exoplayer2.ext.mediasession.TimelineQueueEditor

All Implemented Interfaces:

MediaSessionConnector.CommandReceiver, MediaSessionConnector.QueueEditor

public final class TimelineQueueEditor
extends java.lang.Object
implements MediaSessionConnector.QueueEditor, MediaSessionConnector.CommandReceiver

A MediaSessionConnector.QueueEditor implementation based on the ConcatenatingMediaSource.

This class implements the MediaSessionConnector.CommandReceiver interface and handles the COMMAND_MOVE_QUEUE_ITEM to move a queue item instead of removing and inserting it. This allows to move the currently playing window without interrupting playback.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TimelineQueueEditor.MediaIdEqualityChecker Media description comparator comparing the media IDs.
static interface	TimelineQueueEditor.MediaSourceFactory Factory to create MediaSources.
static interface	TimelineQueueEditor.QueueDataAdapter Adapter to get MediaDescriptionCompat of items in the queue and to notify the application about changes in the queue to sync the data structure backing the MediaSessionConnector.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMMAND_MOVE_QUEUE_ITEM
static java.lang.String	EXTRA_FROM_INDEX
static java.lang.String	EXTRA_TO_INDEX

Constructor Summary

Constructors

Constructor and Description
TimelineQueueEditor(android.support.v4.media.session.MediaControllerCompat mediaController, com.google.android.exoplayer2.source.ConcatenatingMediaSource queueMediaSource, TimelineQueueEditor.QueueDataAdapter queueDataAdapter, TimelineQueueEditor.MediaSourceFactory sourceFactory) Creates a new TimelineQueueEditor with a given mediaSourceFactory.
TimelineQueueEditor(android.support.v4.media.session.MediaControllerCompat mediaController, com.google.android.exoplayer2.source.ConcatenatingMediaSource queueMediaSource, TimelineQueueEditor.QueueDataAdapter queueDataAdapter, TimelineQueueEditor.MediaSourceFactory sourceFactory, com.google.android.exoplayer2.ext.mediasession.TimelineQueueEditor.MediaDescriptionEqualityChecker equalityChecker) Creates a new TimelineQueueEditor with a given mediaSourceFactory.

Method Summary

Modifier and Type	Method and Description
java.lang.String[]	getCommands() Returns the commands the receiver handles, or null if no commands need to be handled.
void	onAddQueueItem(com.google.android.exoplayer2.Player player, android.support.v4.media.MediaDescriptionCompat description) See MediaSessionCompat.Callback#onAddQueueItem(MediaDescriptionCompat description).
void	onAddQueueItem(com.google.android.exoplayer2.Player player, android.support.v4.media.MediaDescriptionCompat description, int index) See MediaSessionCompat.Callback#onAddQueueItem(MediaDescriptionCompat description, int index).
void	onCommand(com.google.android.exoplayer2.Player player, java.lang.String command, android.os.Bundle extras, android.os.ResultReceiver cb) See MediaSessionCompat.Callback#onCommand(String, Bundle, ResultReceiver).
void	onRemoveQueueItem(com.google.android.exoplayer2.Player player, android.support.v4.media.MediaDescriptionCompat description) See MediaSessionCompat.Callback#onRemoveQueueItem(MediaDescriptionCompat description).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

COMMAND_MOVE_QUEUE_ITEM

public static final java.lang.String COMMAND_MOVE_QUEUE_ITEM

See Also:

Constant Field Values

EXTRA_FROM_INDEX

public static final java.lang.String EXTRA_FROM_INDEX

See Also:

Constant Field Values

EXTRA_TO_INDEX

public static final java.lang.String EXTRA_TO_INDEX

See Also:

Constant Field Values

Constructor Detail

TimelineQueueEditor

public TimelineQueueEditor(@NonNull
                           android.support.v4.media.session.MediaControllerCompat mediaController,
                           @NonNull
                           com.google.android.exoplayer2.source.ConcatenatingMediaSource queueMediaSource,
                           @NonNull
                           TimelineQueueEditor.QueueDataAdapter queueDataAdapter,
                           @NonNull
                           TimelineQueueEditor.MediaSourceFactory sourceFactory)

Creates a new TimelineQueueEditor with a given mediaSourceFactory.

Parameters:

mediaController - A MediaControllerCompat to read the current queue.

queueMediaSource - The ConcatenatingMediaSource to manipulate.

queueDataAdapter - A TimelineQueueEditor.QueueDataAdapter to change the backing data.

sourceFactory - The TimelineQueueEditor.MediaSourceFactory to build media sources.

TimelineQueueEditor

public TimelineQueueEditor(@NonNull
                           android.support.v4.media.session.MediaControllerCompat mediaController,
                           @NonNull
                           com.google.android.exoplayer2.source.ConcatenatingMediaSource queueMediaSource,
                           @NonNull
                           TimelineQueueEditor.QueueDataAdapter queueDataAdapter,
                           @NonNull
                           TimelineQueueEditor.MediaSourceFactory sourceFactory,
                           @NonNull
                           com.google.android.exoplayer2.ext.mediasession.TimelineQueueEditor.MediaDescriptionEqualityChecker equalityChecker)

Creates a new TimelineQueueEditor with a given mediaSourceFactory.

Parameters:

mediaController - A MediaControllerCompat to read the current queue.

queueMediaSource - The ConcatenatingMediaSource to manipulate.

queueDataAdapter - A TimelineQueueEditor.QueueDataAdapter to change the backing data.

sourceFactory - The TimelineQueueEditor.MediaSourceFactory to build media sources.

equalityChecker - The MediaDescriptionEqualityChecker to match queue items.

Method Detail

onAddQueueItem

public void onAddQueueItem(com.google.android.exoplayer2.Player player,
                           android.support.v4.media.MediaDescriptionCompat description)

Description copied from interface: MediaSessionConnector.QueueEditor

See MediaSessionCompat.Callback#onAddQueueItem(MediaDescriptionCompat description).

Specified by:

onAddQueueItem in interface MediaSessionConnector.QueueEditor

onAddQueueItem

public void onAddQueueItem(com.google.android.exoplayer2.Player player,
                           android.support.v4.media.MediaDescriptionCompat description,
                           int index)

Description copied from interface: MediaSessionConnector.QueueEditor

See MediaSessionCompat.Callback#onAddQueueItem(MediaDescriptionCompat description, int index).

Specified by:

onAddQueueItem in interface MediaSessionConnector.QueueEditor

onRemoveQueueItem

public void onRemoveQueueItem(com.google.android.exoplayer2.Player player,
                              android.support.v4.media.MediaDescriptionCompat description)

Description copied from interface: MediaSessionConnector.QueueEditor

See MediaSessionCompat.Callback#onRemoveQueueItem(MediaDescriptionCompat description).

Specified by:

onRemoveQueueItem in interface MediaSessionConnector.QueueEditor

getCommands

@NonNull
public java.lang.String[] getCommands()

Description copied from interface: MediaSessionConnector.CommandReceiver

Returns the commands the receiver handles, or null if no commands need to be handled.

Specified by:

getCommands in interface MediaSessionConnector.CommandReceiver

onCommand

public void onCommand(com.google.android.exoplayer2.Player player,
                      java.lang.String command,
                      android.os.Bundle extras,
                      android.os.ResultReceiver cb)

Description copied from interface: MediaSessionConnector.CommandReceiver

See MediaSessionCompat.Callback#onCommand(String, Bundle, ResultReceiver).

Specified by:

onCommand in interface MediaSessionConnector.CommandReceiver