FakeTimeline

Artifact: androidx.media3:media3-test-utils

View Source

---

Kotlin |Java

@UnstableApi
public final class FakeTimeline extends Timeline

java.lang.Object
↳	androidx.media3.common.Timeline
	↳	androidx.media3.test.utils.FakeTimeline

---

Fake Timeline which can be setup to return custom TimelineWindowDefinitions.

Summary

Nested types
public final class FakeTimeline.TimelineWindowDefinition Definition used to define a FakeTimeline.

Constants
static final MediaItem	FAKE_MEDIA_ITEM The fake media item used by the fake timeline.

Public constructors
FakeTimeline() Create a fake timeline with one seekable, non-dynamic window with one period and a duration of DEFAULT_WINDOW_DURATION_US.
FakeTimeline(     FakeTimeline.TimelineWindowDefinition[] windowDefinitions ) Creates a fake timeline with the given window definitions.
FakeTimeline(     Object[] manifests,     FakeTimeline.TimelineWindowDefinition[] windowDefinitions ) Creates a fake timeline with the given window definitions.
FakeTimeline(int windowCount, Object[] manifests) Creates a fake timeline with the given number of seekable, non-dynamic windows with one period with a duration of DEFAULT_WINDOW_DURATION_US each.
FakeTimeline(     Object[] manifests,     ShuffleOrder shuffleOrder,     FakeTimeline.TimelineWindowDefinition[] windowDefinitions ) Creates a fake timeline with the given window definitions and .

Public methods
static AdPlaybackState	createAdPlaybackState(int adsPerAdGroup, long[] adGroupTimesUs) Returns an ad playback state with the specified number of ads in each of the specified ad groups, each ten seconds long.
static FakeTimeline	createMultiPeriodAdTimeline(     Object windowId,     int numberOfPlayedAds,     boolean[] isAdPeriodFlags ) Creates a multi-period timeline with ad and content periods specified by the flags passed as var-arg arguments.
ImmutableMap<Object, AdPlaybackState>	getAdPlaybackStates(int windowIndex) Returns a map of ad playback states keyed by the period UID.
int	getFirstWindowIndex(boolean shuffleModeEnabled) Returns the index of the first window in the playback order depending on whether shuffling is enabled.
int	getIndexOfPeriod(Object uid) Returns the index of the period identified by its unique uid, or INDEX_UNSET if the period is not in the timeline.
int	getLastWindowIndex(boolean shuffleModeEnabled) Returns the index of the last window in the playback order depending on whether shuffling is enabled.
int	getNextWindowIndex(     int windowIndex,     @Player.RepeatMode int repeatMode,     boolean shuffleModeEnabled ) Returns the index of the window after the window at index windowIndex depending on the repeatMode and whether shuffling is enabled.
Timeline.Period	getPeriod(int periodIndex, Timeline.Period period, boolean setIds) Populates a Period with data for the period at the specified index.
int	getPeriodCount() Returns the number of periods in the timeline.
int	getPreviousWindowIndex(     int windowIndex,     @Player.RepeatMode int repeatMode,     boolean shuffleModeEnabled ) Returns the index of the window before the window at index windowIndex depending on the repeatMode and whether shuffling is enabled.
Object	getUidOfPeriod(int periodIndex) Returns the unique id of the period identified by its index in the timeline.
Timeline.Window	getWindow(     int windowIndex,     Timeline.Window window,     long defaultPositionProjectionUs ) Populates a Window with data for the window at the specified index.
int	getWindowCount() Returns the number of windows in the timeline.

Inherited Constants
From androidx.media3.common.Timeline static final Timeline EMPTY An empty timeline.

Inherited methods

From androidx.media3.common.Timeline final Timeline @UnstableApi copyWithSingleWindow(int windowIndex) Returns a copy of this timeline containing just the single specified Window. boolean equals(@Nullable Object obj) static Timeline @UnstableApi fromBundle(Bundle bundle) Restores a Timeline from a Bundle. final int getNextPeriodIndex(     int periodIndex,     Timeline.Period period,     Timeline.Window window,     @Player.RepeatMode int repeatMode,     boolean shuffleModeEnabled ) Returns the index of the period after the period at index periodIndex depending on the repeatMode and whether shuffling is enabled. final Timeline.Period getPeriod(int periodIndex, Timeline.Period period) Populates a Period with data for the period at the specified index. Timeline.Period getPeriodByUid(Object periodUid, Timeline.Period period) Populates a Period with data for the period with the specified unique identifier. final Pair<Object, Long> @UnstableApi @InlineMe(replacement = "this.getPeriodPositionUs(window, period, windowIndex, windowPositionUs)") getPeriodPosition(     Timeline.Window window,     Timeline.Period period,     int windowIndex,     long windowPositionUs ) This method is deprecated. Use getPeriodPositionUs instead. final @Nullable Pair<Object, Long> @UnstableApi @InlineMe(replacement = "this.getPeriodPositionUs(" + "window, period, windowIndex, windowPositionUs, defaultPositionProjectionUs)") getPeriodPosition(     Timeline.Window window,     Timeline.Period period,     int windowIndex,     long windowPositionUs,     long defaultPositionProjectionUs ) This method is deprecated. Use getPeriodPositionUs instead. final Pair<Object, Long> getPeriodPositionUs(     Timeline.Window window,     Timeline.Period period,     int windowIndex,     long windowPositionUs ) Calls getPeriodPositionUs with a zero default position projection. final @Nullable Pair<Object, Long> getPeriodPositionUs(     Timeline.Window window,     Timeline.Period period,     int windowIndex,     long windowPositionUs,     long defaultPositionProjectionUs ) Converts (windowIndex, windowPositionUs) to the corresponding (periodUid, periodPositionUs). final Timeline.Window getWindow(int windowIndex, Timeline.Window window) Populates a Window with data for the window at the specified index. int hashCode() final boolean isEmpty() Returns whether the timeline is empty. final boolean isLastPeriod(     int periodIndex,     Timeline.Period period,     Timeline.Window window,     @Player.RepeatMode int repeatMode,     boolean shuffleModeEnabled ) Returns whether the given period is the last period of the timeline depending on the repeatMode and whether shuffling is enabled. final Bundle @UnstableApi toBundle() Returns a Bundle representing the information stored in this object.

Constants

FAKE_MEDIA_ITEM

public static final MediaItem FAKE_MEDIA_ITEM

The fake media item used by the fake timeline.

Public constructors

FakeTimeline

public FakeTimeline()

Create a fake timeline with one seekable, non-dynamic window with one period and a duration of DEFAULT_WINDOW_DURATION_US.

FakeTimeline

public FakeTimeline(
    FakeTimeline.TimelineWindowDefinition[] windowDefinitions
)

Creates a fake timeline with the given window definitions.

Parameters
FakeTimeline.TimelineWindowDefinition[] windowDefinitions	A list of TimelineWindowDefinitions.

FakeTimeline

public FakeTimeline(
    Object[] manifests,
    FakeTimeline.TimelineWindowDefinition[] windowDefinitions
)

Creates a fake timeline with the given window definitions.

Parameters
Object[] manifests	The manifests of the windows.
FakeTimeline.TimelineWindowDefinition[] windowDefinitions	A list of TimelineWindowDefinitions.

FakeTimeline

public FakeTimeline(int windowCount, Object[] manifests)

Creates a fake timeline with the given number of seekable, non-dynamic windows with one period with a duration of DEFAULT_WINDOW_DURATION_US each.

Parameters
int windowCount	The number of windows.
Object[] manifests	The manifests of the windows.

FakeTimeline

public FakeTimeline(
    Object[] manifests,
    ShuffleOrder shuffleOrder,
    FakeTimeline.TimelineWindowDefinition[] windowDefinitions
)

Creates a fake timeline with the given window definitions and .

Parameters
Object[] manifests	The manifests of the windows.
ShuffleOrder shuffleOrder	A shuffle ordering for the windows.
FakeTimeline.TimelineWindowDefinition[] windowDefinitions	A list of TimelineWindowDefinitions.

Public methods

createAdPlaybackState

public static AdPlaybackState createAdPlaybackState(int adsPerAdGroup, long[] adGroupTimesUs)

Returns an ad playback state with the specified number of ads in each of the specified ad groups, each ten seconds long.

Parameters
int adsPerAdGroup	The number of ads per ad group.
long[] adGroupTimesUs	The times of ad groups, in microseconds.

Returns
AdPlaybackState	The ad playback state.

createMultiPeriodAdTimeline

public static FakeTimeline createMultiPeriodAdTimeline(
    Object windowId,
    int numberOfPlayedAds,
    boolean[] isAdPeriodFlags
)

Creates a multi-period timeline with ad and content periods specified by the flags passed as var-arg arguments.

Period uid end up being a new Pair<>(windowId, periodIndex).

Parameters
Object windowId	The window ID.
int numberOfPlayedAds	The number of ads that should be marked as played.
boolean[] isAdPeriodFlags	A value of true indicates an ad period. A value of false indicated a content period.

Returns
FakeTimeline	A timeline with a single window with as many periods as var-arg arguments.

getAdPlaybackStates

public ImmutableMap<Object, AdPlaybackState> getAdPlaybackStates(int windowIndex)

Returns a map of ad playback states keyed by the period UID.

Parameters
int windowIndex	The window index of the window to get the map of ad playback states from.

Returns
ImmutableMap<Object, AdPlaybackState>	The map of ad playback states.

getFirstWindowIndex

public int getFirstWindowIndex(boolean shuffleModeEnabled)

Returns the index of the first window in the playback order depending on whether shuffling is enabled.

Parameters
boolean shuffleModeEnabled	Whether shuffling is enabled.

Returns
int	The index of the first window in the playback order, or INDEX_UNSET if the timeline is empty.

getIndexOfPeriod

public int getIndexOfPeriod(Object uid)

Returns the index of the period identified by its unique uid, or INDEX_UNSET if the period is not in the timeline.

Parameters
Object uid	A unique identifier for a period.

Returns
int	The index of the period, or INDEX_UNSET if the period was not found.

getLastWindowIndex

public int getLastWindowIndex(boolean shuffleModeEnabled)

Returns the index of the last window in the playback order depending on whether shuffling is enabled.

Parameters
boolean shuffleModeEnabled	Whether shuffling is enabled.

Returns
int	The index of the last window in the playback order, or INDEX_UNSET if the timeline is empty.

getNextWindowIndex

public int getNextWindowIndex(
    int windowIndex,
    @Player.RepeatMode int repeatMode,
    boolean shuffleModeEnabled
)

Returns the index of the window after the window at index windowIndex depending on the repeatMode and whether shuffling is enabled.

Parameters
int windowIndex	Index of a window in the timeline.
@Player.RepeatMode int repeatMode	A repeat mode.
boolean shuffleModeEnabled	Whether shuffling is enabled.

Returns
int	The index of the next window, or INDEX_UNSET if this is the last window.

getPeriod

public Timeline.Period getPeriod(int periodIndex, Timeline.Period period, boolean setIds)

Populates a Period with data for the period at the specified index.

Parameters
int periodIndex	The index of the period.
Timeline.Period period	The Period to populate. Must not be null.
boolean setIds	Whether id and uid should be populated. If false, the fields will be set to null. The caller should pass false for efficiency reasons unless the fields are required.

Returns
Timeline.Period	The populated Period, for convenience.

getPeriodCount

public int getPeriodCount()

Returns the number of periods in the timeline.

getPreviousWindowIndex

public int getPreviousWindowIndex(
    int windowIndex,
    @Player.RepeatMode int repeatMode,
    boolean shuffleModeEnabled
)

Returns the index of the window before the window at index windowIndex depending on the repeatMode and whether shuffling is enabled.

Parameters
int windowIndex	Index of a window in the timeline.
@Player.RepeatMode int repeatMode	A repeat mode.
boolean shuffleModeEnabled	Whether shuffling is enabled.

Returns
int	The index of the previous window, or INDEX_UNSET if this is the first window.

getUidOfPeriod

public Object getUidOfPeriod(int periodIndex)

Returns the unique id of the period identified by its index in the timeline.

Parameters
int periodIndex	The index of the period.

Returns
Object	The unique id of the period.

getWindow

public Timeline.Window getWindow(
    int windowIndex,
    Timeline.Window window,
    long defaultPositionProjectionUs
)

Populates a Window with data for the window at the specified index.

Parameters
int windowIndex	The index of the window.
Timeline.Window window	The Window to populate. Must not be null.
long defaultPositionProjectionUs	A duration into the future that the populated window's default start position should be projected.

Returns
Timeline.Window	The populated Window, for convenience.

getWindowCount

public int getWindowCount()

Returns the number of windows in the timeline.