# FakeTimeline

Artifact: [androidx.media3:media3-test-utils](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/test/utils/FakeTimeline.java+class:androidx.media3.test.utils.FakeTimeline)

*** ** * ** ***


```
@UnstableApi
public final class FakeTimeline extends Timeline
```

<br />

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) |||
| ↳ | [androidx.media3.common.Timeline](https://developer.android.com/reference/androidx/media3/common/Timeline) ||
|   | ↳ | [androidx.media3.test.utils.FakeTimeline](https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline) |

*** ** * ** ***

Fake `https://developer.android.com/reference/androidx/media3/common/Timeline` which can be setup to return custom `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition`s.

## Summary

| ### Nested types |
|---|
| `public final class https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition` Definition used to define a `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline`. |
| `public class https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition.Builder` A builder to build instances of `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition`. |

| ### Constants |
|---|---|
| `static final https://developer.android.com/reference/androidx/media3/common/MediaItem` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FAKE_MEDIA_ITEM()` The fake media item used by the fake timeline. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FakeTimeline()()` Create a fake timeline with one seekable, non-dynamic window with one period and a duration of `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition#DEFAULT_WINDOW_DURATION_US()`. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FakeTimeline(androidx.media3.test.utils.FakeTimeline.TimelineWindowDefinition...)( FakeTimeline.TimelineWindowDefinition[] windowDefinitions )` Creates a fake timeline with the given window definitions. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FakeTimeline(java.lang.Object[],androidx.media3.test.utils.FakeTimeline.TimelineWindowDefinition...)( Object[] manifests, FakeTimeline.TimelineWindowDefinition[] windowDefinitions )` Creates a fake timeline with the given window definitions. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FakeTimeline(int,java.lang.Object...)(int windowCount, Object[] manifests)` Creates a fake timeline with the given number of seekable, non-dynamic windows with one period with a duration of `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition#DEFAULT_WINDOW_DURATION_US()` each. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#FakeTimeline(java.lang.Object[],androidx.media3.exoplayer.source.ShuffleOrder,androidx.media3.test.utils.FakeTimeline.TimelineWindowDefinition...)( Object[] manifests, https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder shuffleOrder, FakeTimeline.TimelineWindowDefinition[] windowDefinitions )` Creates a fake timeline with the given window definitions and `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder`. |

| ### Public methods |
|---|---|
| `static https://developer.android.com/reference/androidx/media3/common/AdPlaybackState` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#createAdPlaybackState(int,long...)(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 https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#createMultiPeriodAdTimeline(java.lang.Object,int,boolean...)( https://developer.android.com/reference/java/lang/Object.html windowId, int numberOfPlayedAds, boolean[] isAdPeriodFlags )` Creates a multi-period timeline with ad and content periods specified by the flags passed as var-arg arguments. |
| `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/androidx/media3/common/AdPlaybackState>` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getAdPlaybackStates(int)(int windowIndex)` Returns a map of ad playback states keyed by the period UID. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getFirstWindowIndex(boolean)(boolean shuffleModeEnabled)` Returns the index of the first window in the playback order depending on whether shuffling is enabled. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getIndexOfPeriod(java.lang.Object)(https://developer.android.com/reference/java/lang/Object.html uid)` Returns the index of the period identified by its unique `https://developer.android.com/reference/androidx/media3/common/Timeline.Period#uid()`, or `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` if the period is not in the timeline. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getLastWindowIndex(boolean)(boolean shuffleModeEnabled)` Returns the index of the last window in the playback order depending on whether shuffling is enabled. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getNextWindowIndex(int,int,boolean)( int windowIndex, @https://developer.android.com/reference/androidx/media3/common/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. |
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getPeriod(int,androidx.media3.common.Timeline.Period,boolean)(int periodIndex, https://developer.android.com/reference/androidx/media3/common/Timeline.Period period, boolean setIds)` Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` with data for the period at the specified index. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getPeriodCount()()` Returns the number of periods in the timeline. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getPreviousWindowIndex(int,int,boolean)( int windowIndex, @https://developer.android.com/reference/androidx/media3/common/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. |
| `https://developer.android.com/reference/java/lang/Object.html` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getUidOfPeriod(int)(int periodIndex)` Returns the unique id of the period identified by its index in the timeline. |
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Window` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getWindow(int,androidx.media3.common.Timeline.Window,long)( int windowIndex, https://developer.android.com/reference/androidx/media3/common/Timeline.Window window, long defaultPositionProjectionUs )` Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Window` with data for the window at the specified index. |
| `int` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline#getWindowCount()()` Returns the number of windows in the timeline. |

### Inherited Constants

From [androidx.media3.common.Timeline](https://developer.android.com/reference/androidx/media3/common/Timeline) `static final https://developer.android.com/reference/androidx/media3/common/Timeline` `https://developer.android.com/reference/androidx/media3/common/Timeline#EMPTY()`

An empty timeline.

### Inherited methods

From [androidx.media3.common.Timeline](https://developer.android.com/reference/androidx/media3/common/Timeline) `final https://developer.android.com/reference/androidx/media3/common/Timeline` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/androidx/media3/common/Timeline#copyWithSingleWindow(int)(int windowIndex)`

Returns a copy of this timeline containing just the single specified `https://developer.android.com/reference/androidx/media3/common/Timeline.Window`.
`boolean` `https://developer.android.com/reference/androidx/media3/common/Timeline#equals(java.lang.Object)(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/Object.html obj)` `static https://developer.android.com/reference/androidx/media3/common/Timeline` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
[fromBundle](https://developer.android.com/reference/androidx/media3/common/Timeline#fromBundle(android.os.Bundle))(https://developer.android.com/reference/android/os/Bundle.html bundle)`

**This method is deprecated.**

Use `https://developer.android.com/reference/androidx/media3/common/Timeline#fromBundle(android.os.Bundle,int)` instead.

<br />

`static https://developer.android.com/reference/androidx/media3/common/Timeline` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/androidx/media3/common/Timeline#fromBundle(android.os.Bundle,int)(https://developer.android.com/reference/android/os/Bundle.html bundle, int interfaceVersion)`

Restores a `Timeline` from a `https://developer.android.com/reference/android/os/Bundle.html`.
`final int` `https://developer.android.com/reference/androidx/media3/common/Timeline#getNextPeriodIndex(int,androidx.media3.common.Timeline.Period,androidx.media3.common.Timeline.Window,int,boolean)(
int periodIndex,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
@https://developer.android.com/reference/androidx/media3/common/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 https://developer.android.com/reference/androidx/media3/common/Timeline.Period` `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriod(int,androidx.media3.common.Timeline.Period)(int periodIndex, https://developer.android.com/reference/androidx/media3/common/Timeline.Period period)`

Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` with data for the period at the specified index.
`https://developer.android.com/reference/androidx/media3/common/Timeline.Period` `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodByUid(java.lang.Object,androidx.media3.common.Timeline.Period)(https://developer.android.com/reference/java/lang/Object.html periodUid, https://developer.android.com/reference/androidx/media3/common/Timeline.Period period)`

Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` with data for the period with the specified unique identifier.
`final https://developer.android.com/reference/android/util/Pair.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/java/lang/Long.html>` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
@https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "this.getPeriodPositionUs(window, period, windowIndex, windowPositionUs)")
[getPeriodPosition](https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPosition(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long))(
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
int windowIndex,
long windowPositionUs
)`

**This method is deprecated.**

Use `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long)` instead.

<br />

`final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/util/Pair.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/java/lang/Long.html>` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
@https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "this.getPeriodPositionUs("
+ "window, period, windowIndex, windowPositionUs, defaultPositionProjectionUs)")
[getPeriodPosition](https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPosition(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long,long))(
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
int windowIndex,
long windowPositionUs,
long defaultPositionProjectionUs
)`

**This method is deprecated.**

Use `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long,long)` instead.

<br />

`final https://developer.android.com/reference/android/util/Pair.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/java/lang/Long.html>` `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long)(
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
int windowIndex,
long windowPositionUs
)`

Calls `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long)` with a zero default position projection.
`final @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/android/util/Pair.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/java/lang/Long.html>` `https://developer.android.com/reference/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long,long)(
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
int windowIndex,
long windowPositionUs,
long defaultPositionProjectionUs
)`

Converts `(windowIndex, windowPositionUs)` to the corresponding `(periodUid,
periodPositionUs)`.
`final https://developer.android.com/reference/androidx/media3/common/Timeline.Window` `https://developer.android.com/reference/androidx/media3/common/Timeline#getWindow(int,androidx.media3.common.Timeline.Window)(int windowIndex, https://developer.android.com/reference/androidx/media3/common/Timeline.Window window)`

Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Window` with data for the window at the specified index.
`int` `https://developer.android.com/reference/androidx/media3/common/Timeline#hashCode()()` `final boolean` `https://developer.android.com/reference/androidx/media3/common/Timeline#isEmpty()()`

Returns whether the timeline is empty.
`final boolean` `https://developer.android.com/reference/androidx/media3/common/Timeline#isLastPeriod(int,androidx.media3.common.Timeline.Period,androidx.media3.common.Timeline.Window,int,boolean)(
int periodIndex,
https://developer.android.com/reference/androidx/media3/common/Timeline.Period period,
https://developer.android.com/reference/androidx/media3/common/Timeline.Window window,
@https://developer.android.com/reference/androidx/media3/common/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 https://developer.android.com/reference/android/os/Bundle.html` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
[toBundle](https://developer.android.com/reference/androidx/media3/common/Timeline#toBundle())()`

**This method is deprecated.**

Use `https://developer.android.com/reference/androidx/media3/common/Timeline#toBundle(int)` instead.

<br />

`final https://developer.android.com/reference/android/os/Bundle.html` `@https://developer.android.com/reference/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/androidx/media3/common/Timeline#toBundle(int)(int interfaceVersion)`

Returns a `https://developer.android.com/reference/android/os/Bundle.html` 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 `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition#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 `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition`s. |

### 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 `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition`s. |

### 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 `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition#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 `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder`.

| Parameters |
|---|---|
| `Object[] manifests` | The manifests of the windows. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/ShuffleOrder shuffleOrder` | A shuffle ordering for the windows. |
| `FakeTimeline.TimelineWindowDefinition[] windowDefinitions` | A list of `https://developer.android.com/reference/androidx/media3/test/utils/FakeTimeline.TimelineWindowDefinition`s. |

## 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 |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/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 |
|---|---|
| `https://developer.android.com/reference/java/lang/Object.html 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 |
|---|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/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 |
|---|---|
| `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableMap.html<https://developer.android.com/reference/java/lang/Object.html, https://developer.android.com/reference/androidx/media3/common/AdPlaybackState>` | The map of `https://developer.android.com/reference/androidx/media3/common/AdPlaybackState`. |

### 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 `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` if the timeline is empty. |

### getIndexOfPeriod

```
public int getIndexOfPeriod(Object uid)
```

Returns the index of the period identified by its unique `https://developer.android.com/reference/androidx/media3/common/Timeline.Period#uid()`, or `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` if the period is not in the timeline.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/lang/Object.html uid` | A unique identifier for a period. |

| Returns |
|---|---|
| `int` | The index of the period, or `https://developer.android.com/reference/androidx/media3/common/C#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 `https://developer.android.com/reference/androidx/media3/common/C#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. |
| `@https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode int repeatMode` | A repeat mode. |
| `boolean shuffleModeEnabled` | Whether shuffling is enabled. |

| Returns |
|---|---|
| `int` | The index of the next window, or `https://developer.android.com/reference/androidx/media3/common/C#INDEX_UNSET()` if this is the last window. |

### getPeriod

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

Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` with data for the period at the specified index.

| Parameters |
|---|---|
| `int periodIndex` | The index of the period. |
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Period period` | The `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` to populate. Must not be null. |
| `boolean setIds` | Whether `https://developer.android.com/reference/androidx/media3/common/Timeline.Period#id()` and `https://developer.android.com/reference/androidx/media3/common/Timeline.Period#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 |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Period` | The populated `https://developer.android.com/reference/androidx/media3/common/Timeline.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. |
| `@https://developer.android.com/reference/androidx/media3/common/Player.RepeatMode int repeatMode` | A repeat mode. |
| `boolean shuffleModeEnabled` | Whether shuffling is enabled. |

| Returns |
|---|---|
| `int` | The index of the previous window, or `https://developer.android.com/reference/androidx/media3/common/C#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 |
|---|---|
| `https://developer.android.com/reference/java/lang/Object.html` | The unique id of the period. |

### getWindow

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

Populates a `https://developer.android.com/reference/androidx/media3/common/Timeline.Window` with data for the window at the specified index.

| Parameters |
|---|---|
| `int windowIndex` | The index of the window. |
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Window window` | The `https://developer.android.com/reference/androidx/media3/common/Timeline.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 |
|---|---|
| `https://developer.android.com/reference/androidx/media3/common/Timeline.Window` | The populated `https://developer.android.com/reference/androidx/media3/common/Timeline.Window`, for convenience. |

### getWindowCount

```
public int getWindowCount()
```

Returns the number of windows in the timeline.