# AdTimeline

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

*** ** * ** ***


```
@VisibleForTesting(otherwise = VisibleForTesting.PACKAGE_PRIVATE)
@UnstableApi
class AdTimeline : ForwardingTimeline
```

<br />

|---|---|---|---|
| [kotlin.Any](https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html) ||||
| ↳ | [androidx.media3.common.Timeline](https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline) |||
|   | ↳ | [androidx.media3.exoplayer.source.ForwardingTimeline](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline) ||
|   |   | ↳ | [androidx.media3.exoplayer.source.ads.AdTimeline](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ads/AdTimeline) |

*** ** * ** ***

A custom `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline` for sources that have `https://developer.android.com/reference/kotlin/androidx/media3/common/AdPlaybackState` split among multiple periods.

The ad group times in the input `https://developer.android.com/reference/kotlin/androidx/media3/common/AdPlaybackState` must be relative to the start of the first `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` (i.e. `timeUs = 0` corresponds to the start of period 0). For each period a modified `https://developer.android.com/reference/kotlin/androidx/media3/common/AdPlaybackState` is created:

- Ad group time is offset relative to the period's start time
- Post-roll ad group is kept only for the last period
- Ad group count and indices are kept unchanged

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ads/AdTimeline#AdTimeline(androidx.media3.common.Timeline,androidx.media3.common.AdPlaybackState)(contentTimeline: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline!, adPlaybackState: https://developer.android.com/reference/kotlin/androidx/media3/common/AdPlaybackState!)` Creates a new timeline alongside which ads will be played. |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ads/AdTimeline#getPeriod(int,androidx.media3.common.Timeline.Period,boolean)(periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html, period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!, setIds: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)` Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` with data for the period at the specified index. |

### Inherited Constants

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

An empty timeline.

### Inherited functions

From [androidx.media3.exoplayer.source.ForwardingTimeline](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline) `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#equals(java.lang.Object)(obj: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html?)` `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getFirstWindowIndex(boolean)(shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`

Returns the index of the first window in the playback order depending on whether shuffling is enabled.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getIndexOfPeriod(java.lang.Object)(uid: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!)`

Returns the index of the period identified by its unique `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period#uid()`, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#INDEX_UNSET()` if the period is not in the timeline.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getLastWindowIndex(boolean)(shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)`

Returns the index of the last window in the playback order depending on whether shuffling is enabled.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getNextWindowIndex(int,int,boolean)(
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
@https://developer.android.com/reference/kotlin/androidx/media3/common/Player.RepeatMode repeatMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html
)`

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/kotlin/androidx/media3/common/Timeline.Period!` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getPeriodByUid(java.lang.Object,androidx.media3.common.Timeline.Period)(periodUid: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!)`

Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` with data for the period with the specified unique identifier.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getPeriodCount()()`

Returns the number of periods in the timeline.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getPreviousWindowIndex(int,int,boolean)(
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
@https://developer.android.com/reference/kotlin/androidx/media3/common/Player.RepeatMode repeatMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html
)`

Returns the index of the window before the window at index `windowIndex` depending on the `repeatMode` and whether shuffling is enabled.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getUidOfPeriod(int)(periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`

Returns the unique id of the period identified by its index in the timeline.
`https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getWindow(int,androidx.media3.common.Timeline.Window,long)(
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
defaultPositionProjectionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window` with data for the window at the specified index.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#getWindowCount()()`

Returns the number of windows in the timeline.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#hashCode()()` From [androidx.media3.common.Timeline](https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline) `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline!` `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#copyWithSingleWindow(int)(windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`

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

**This function is deprecated.**

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

<br />

`java-static https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline!` `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#fromBundle(android.os.Bundle,int)(bundle: https://developer.android.com/reference/android/os/Bundle.html!, interfaceVersion: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`

Restores a `Timeline` from a `https://developer.android.com/reference/android/os/Bundle.html`.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getNextPeriodIndex(int,androidx.media3.common.Timeline.Period,androidx.media3.common.Timeline.Window,int,boolean)(
periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
@https://developer.android.com/reference/kotlin/androidx/media3/common/Player.RepeatMode repeatMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html
)`

Returns the index of the period after the period at index `periodIndex` depending on the `repeatMode` and whether shuffling is enabled.
`https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getPeriod(int,androidx.media3.common.Timeline.Period)(periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html, period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!)`

Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` with data for the period at the specified index.
`https://developer.android.com/reference/android/util/Pair.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html!>!` `@https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/common/Timeline#getPeriodPosition(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long))(
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
windowPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

**This function is deprecated.**

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

<br />

`https://developer.android.com/reference/android/util/Pair.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html!>?` `@https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/common/Timeline#getPeriodPosition(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long,long))(
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
windowPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html,
defaultPositionProjectionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

**This function is deprecated.**

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

<br />

`https://developer.android.com/reference/android/util/Pair.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html!>!` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long)(
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
windowPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

Calls `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long)` with a zero default position projection.
`https://developer.android.com/reference/android/util/Pair.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-any/index.html!, https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html!>?` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getPeriodPositionUs(androidx.media3.common.Timeline.Window,androidx.media3.common.Timeline.Period,int,long,long)(
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
windowPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html,
defaultPositionProjectionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

Converts `(windowIndex, windowPositionUs)` to the corresponding `(periodUid,
periodPositionUs)`.
`https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getWindow(int,androidx.media3.common.Timeline.Window)(windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html, window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!)`

Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window` with data for the window at the specified index.
`abstract https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#getWindow(int,androidx.media3.common.Timeline.Window,long)(
windowIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
defaultPositionProjectionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html
)`

Populates a `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window` with data for the window at the specified index.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#isEmpty()()`

Returns whether the timeline is empty.
`https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#isLastPeriod(int,androidx.media3.common.Timeline.Period,androidx.media3.common.Timeline.Window,int,boolean)(
periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!,
window: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Window!,
@https://developer.android.com/reference/kotlin/androidx/media3/common/Player.RepeatMode repeatMode: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html,
shuffleModeEnabled: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html
)`

Returns whether the given period is the last period of the timeline depending on the `
repeatMode` and whether shuffling is enabled.
`https://developer.android.com/reference/android/os/Bundle.html!` `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi
[toBundle](https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#toBundle())()`

**This function is deprecated.**

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

<br />

`https://developer.android.com/reference/android/os/Bundle.html!` `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/UnstableApi
https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline#toBundle(int)(interfaceVersion: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html)`

Returns a `https://developer.android.com/reference/android/os/Bundle.html` representing the information stored in this object.

### Inherited properties

From [androidx.media3.exoplayer.source.ForwardingTimeline](https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline) `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline!` `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/ForwardingTimeline#timeline()`

## Public constructors

### AdTimeline

```
AdTimeline(contentTimeline: Timeline!, adPlaybackState: AdPlaybackState!)
```

Creates a new timeline alongside which ads will be played.

| Parameters |
|---|---|
| `contentTimeline: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline!` | The timeline of the content alongside which ads will be played. |
| `adPlaybackState: https://developer.android.com/reference/kotlin/androidx/media3/common/AdPlaybackState!` | The state of the media's ads. The ad group times in this state must be relative to the start of the first `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` (i.e. `timeUs = 0` corresponds to the start of the first period). |

## Public functions

### getPeriod

```
fun getPeriod(periodIndex: Int, period: Timeline.Period!, setIds: Boolean): Timeline.Period!
```

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

| Parameters |
|---|---|
| `periodIndex: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The index of the period. |
| `period: https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period!` | The `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period` to populate. Must not be null. |
| `setIds: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | Whether `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period#id()` and `https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/common/Timeline.Period!` | The populated `https://developer.android.com/reference/kotlin/androidx/media3/common/Timeline.Period`, for convenience. |