# MaskingMediaPeriod

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/MaskingMediaPeriod.java+class:androidx.media3.exoplayer.source.MaskingMediaPeriod)

*** ** * ** ***

<br />

```
@UnstableApi
class MaskingMediaPeriod : MediaPeriod, MediaPeriod.Callback
```

<br />

*** ** * ** ***

Media period that defers calling `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.upstream.Allocator,long)` on a given source until `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)` has been called. This is useful if you need to return a media period immediately but the media source that should create it is not yet available or prepared.

## Summary

| ### Nested types |
|---|
| `interface https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod.PrepareListener` Listener for preparation events. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#MaskingMediaPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.upstream.Allocator,long)( id: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId!, allocator: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/Allocator!, preparePositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html )` Creates a new masking media period. |

| ### Public functions |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#continueLoading(androidx.media3.exoplayer.LoadingInfo)(loadingInfo: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/LoadingInfo!)` Attempts to continue loading. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)(id: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId!)` Calls `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.upstream.Allocator,long)` on the wrapped source then prepares it if `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#prepare(androidx.media3.exoplayer.source.MediaPeriod.Callback,long)` has been called. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#discardBuffer(long,boolean)(positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, toKeyframe: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html)` Discards buffered media up to the specified position. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#getAdjustedSeekPositionUs(long,androidx.media3.exoplayer.SeekParameters)( positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, seekParameters: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/SeekParameters! )` Returns the position to which a seek will be performed, given the specified seek position and `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/SeekParameters`. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#getBufferedPositionUs()()` Returns an estimate of the position up to which data is buffered for the enabled tracks. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#getNextLoadPositionUs()()` Returns the next load time, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` if loading has finished. |
| `(https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/media3/common/StreamKey!>!` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#getStreamKeys(java.util.List<androidx.media3.exoplayer.trackselection.ExoTrackSelection>)(trackSelections: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection!>!)` Returns a list of `https://developer.android.com/reference/kotlin/androidx/media3/common/StreamKey` which allow to filter the media in this period to load only the parts needed to play the provided `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection`. |
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/TrackGroupArray!` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#getTrackGroups()()` Returns the `https://developer.android.com/reference/kotlin/androidx/media3/common/TrackGroup`s exposed by the period. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#isLoading()()` Returns whether the media period is currently loading. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#maybeThrowPrepareError()()` Throws an error that's preventing the period from becoming prepared. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#onContinueLoadingRequested(androidx.media3.exoplayer.source.MediaPeriod)(source: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod!)` Called by the loader to indicate that it wishes for its `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SequenceableLoader#continueLoading(androidx.media3.exoplayer.LoadingInfo)` method to be called when it can continue to load data. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#onPrepared(androidx.media3.exoplayer.source.MediaPeriod)(mediaPeriod: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod!)` Called when preparation completes. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#overridePreparePositionUs(long)(preparePositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` Overrides the default prepare position at which to prepare the media period. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#prepare(androidx.media3.exoplayer.source.MediaPeriod.Callback,long)(callback: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod.Callback!, positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` Prepares this media period asynchronously. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#readDiscontinuity()()` Attempts to read a discontinuity. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#reevaluateBuffer(long)(positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` Re-evaluates the buffer given the playback position. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#releasePeriod()()` Releases the period. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#seekToUs(long)(positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` Attempts to seek to the specified position in microseconds. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#selectTracks(androidx.media3.exoplayer.trackselection.ExoTrackSelection[],boolean[],androidx.media3.exoplayer.source.SampleStream[],boolean[],long)( @https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType selections: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection!>!, mayRetainStreamFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html>!, @https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType streams: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream!>!, streamResetFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html>!, positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html )` Performs a track selection. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#setEndPositionUs(long)(endPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html)` Sets the end position at which the period stops loading and providing samples. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#setMediaSource(androidx.media3.exoplayer.source.MediaSource)(mediaSource: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource!)` Sets the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource` that will create the underlying media period. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#setPrepareListener(androidx.media3.exoplayer.source.MaskingMediaPeriod.PrepareListener)(listener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod.PrepareListener!)` Sets a listener for preparation events. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#setUsesStreamPrerollFlags()()` Notifies the media period that the player will use `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream#getFlags()` to check if streams contain initial discontinuities at the start of the period rather than using `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#readDiscontinuity()`. |

| ### Public properties |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId!` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#id()` The `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` used to create the masking media period. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#preparePositionOverrideUs()` |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#preparePositionUs()` |

## Public constructors

### MaskingMediaPeriod

```
MaskingMediaPeriod(
    id: MediaSource.MediaPeriodId!,
    allocator: Allocator!,
    preparePositionUs: Long
)
```

Creates a new masking media period. The media source must be set via `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#setMediaSource(androidx.media3.exoplayer.source.MediaSource)` before preparation can start.

| Parameters |
|---|---|
| `id: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId!` | The identifier used to create the masking media period. |
| `allocator: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/upstream/Allocator!` | The allocator used to create the media period. |
| `preparePositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The expected start position, in microseconds. |

## Public functions

### continueLoading

```
fun continueLoading(loadingInfo: LoadingInfo!): Boolean
```

Attempts to continue loading.

This method may be called both during and after the period has been prepared.

A period may call `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SequenceableLoader.Callback#onContinueLoadingRequested(T)` on the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod.Callback` passed to `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#prepare(androidx.media3.exoplayer.source.MediaPeriod.Callback,long)` to request that this method be called when the period is permitted to continue loading data. A period may do this both during and after preparation.

| Parameters |
|---|---|
| `loadingInfo: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/LoadingInfo!` | The `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/LoadingInfo` when attempting to continue loading. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | True if progress was made, meaning that `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#getNextLoadPositionUs()` will return a different value than prior to the call. False otherwise. |

### createPeriod

```
fun createPeriod(id: MediaSource.MediaPeriodId!): Unit
```

Calls `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId,androidx.media3.exoplayer.upstream.Allocator,long)` on the wrapped source then prepares it if `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#prepare(androidx.media3.exoplayer.source.MediaPeriod.Callback,long)` has been called. Call `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#releasePeriod()` to release the period.

| Parameters |
|---|---|
| `id: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId!` | The identifier that should be used to create the media period from the media source. |

### discardBuffer

```
fun discardBuffer(positionUs: Long, toKeyframe: Boolean): Unit
```

Discards buffered media up to the specified position.

This method is only called after the period has been prepared.

| Parameters |
|---|---|
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The position in microseconds. |
| `toKeyframe: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | If true then for each track discards samples up to the keyframe before or at the specified position, rather than any sample before or at that position. |

### getAdjustedSeekPositionUs

```
fun getAdjustedSeekPositionUs(
    positionUs: Long,
    seekParameters: SeekParameters!
): Long
```

Returns the position to which a seek will be performed, given the specified seek position and `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/SeekParameters`.

This method is only called after the period has been prepared.

| Parameters |
|---|---|
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The seek position in microseconds. |
| `seekParameters: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/SeekParameters!` | Parameters that control how the seek is performed. Implementations may apply seek parameters on a best effort basis. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The actual position to which a seek will be performed, in microseconds. |

### getBufferedPositionUs

```
fun getBufferedPositionUs(): Long
```

Returns an estimate of the position up to which data is buffered for the enabled tracks.

This method is only called when at least one track is selected.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | An estimate of the absolute position in microseconds up to which data is buffered, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` if the track is fully buffered. |

### getNextLoadPositionUs

```
fun getNextLoadPositionUs(): Long
```

Returns the next load time, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` if loading has finished.

This method is only called after the period has been prepared. It may be called when no tracks are selected.

### getStreamKeys

```
fun getStreamKeys(trackSelections: (Mutable)List<ExoTrackSelection!>!): (Mutable)List<StreamKey!>!
```

Returns a list of `https://developer.android.com/reference/kotlin/androidx/media3/common/StreamKey` which allow to filter the media in this period to load only the parts needed to play the provided `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection`.

This method is only called after the period has been prepared.

| Parameters |
|---|---|
| `trackSelections: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection!>!` | The `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection` describing the tracks for which stream keys are requested. |

| Returns |
|---|---|
| `(https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/kotlin/androidx/media3/common/StreamKey!>!` | The corresponding `https://developer.android.com/reference/kotlin/androidx/media3/common/StreamKey` for the selected tracks, or an empty list if filtering is not possible and the entire media needs to be loaded to play the selected tracks. |

### getTrackGroups

```
fun getTrackGroups(): TrackGroupArray!
```

Returns the `https://developer.android.com/reference/kotlin/androidx/media3/common/TrackGroup`s exposed by the period.

This method is only called after the period has been prepared.

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/TrackGroupArray!` | The `https://developer.android.com/reference/kotlin/androidx/media3/common/TrackGroup`s. |

### isLoading

```
fun isLoading(): Boolean
```

Returns whether the media period is currently loading.

### maybeThrowPrepareError

```
fun maybeThrowPrepareError(): Unit
```

Throws an error that's preventing the period from becoming prepared. Does nothing if no such error exists.

This method is only called before the period has completed preparation.

| Throws |
|---|---|
| `https://developer.android.com/reference/java/io/IOException.html` | The underlying error. |

### onContinueLoadingRequested

```
fun onContinueLoadingRequested(source: MediaPeriod!): Unit
```

Called by the loader to indicate that it wishes for its `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SequenceableLoader#continueLoading(androidx.media3.exoplayer.LoadingInfo)` method to be called when it can continue to load data. Called on the playback thread.

### onPrepared

```
fun onPrepared(mediaPeriod: MediaPeriod!): Unit
```

Called when preparation completes.

Called on the playback thread. After invoking this method, the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod` can expect for `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#selectTracks(androidx.media3.exoplayer.trackselection.ExoTrackSelection[],boolean[],androidx.media3.exoplayer.source.SampleStream[],boolean[],long)` to be called with the initial track selection.

| Parameters |
|---|---|
| `mediaPeriod: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod!` | The prepared `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod`. |

### overridePreparePositionUs

```
fun overridePreparePositionUs(preparePositionUs: Long): Unit
```

Overrides the default prepare position at which to prepare the media period. This method must be called before `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#createPeriod(androidx.media3.exoplayer.source.MediaSource.MediaPeriodId)`.

| Parameters |
|---|---|
| `preparePositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The default prepare position to use, in microseconds. |

### prepare

```
fun prepare(callback: MediaPeriod.Callback!, positionUs: Long): Unit
```

Prepares this media period asynchronously.

`callback.onPrepared` is called when preparation completes. If preparation fails, `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#maybeThrowPrepareError()` will throw an `https://developer.android.com/reference/java/io/IOException.html`.

If preparation succeeds and results in a source timeline change (e.g. the period duration becoming known), `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaSourceCaller#onSourceInfoRefreshed(androidx.media3.exoplayer.source.MediaSource,androidx.media3.common.Timeline)` will be called before `callback.onPrepared`.

| Parameters |
|---|---|
| `callback: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod.Callback!` | Callback to receive updates from this period, including being notified when preparation completes. |
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The expected starting position, in microseconds. |

### readDiscontinuity

```
fun readDiscontinuity(): Long
```

Attempts to read a discontinuity.

A discontinuity implies that the provided `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream` will start from a new playback position and any output pipelines need to be reset. This happens for example if the streams provide decode-only samples before the intended playback start position that need to be dropped.

After this method has returned a value other than `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_UNSET()`, all `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream` provided by the period are guaranteed to start from a key frame.

This method is only called after the period has been prepared.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The playback position after the discontinuity, in microseconds, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_UNSET()` if there is no discontinuity. |

### reevaluateBuffer

```
fun reevaluateBuffer(positionUs: Long): Unit
```

Re-evaluates the buffer given the playback position.

This method is only called after the period has been prepared.

A period may choose to discard buffered media or cancel ongoing loads so that media can be re-buffered in a different quality.

| Parameters |
|---|---|
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position in this period minus the duration of any media in previous periods still to be played. |

### releasePeriod

```
fun releasePeriod(): Unit
```

Releases the period.

### seekToUs

```
fun seekToUs(positionUs: Long): Long
```

Attempts to seek to the specified position in microseconds.

After this method has been called, all `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream`s provided by the period are guaranteed to start from a key frame.

This method is only called when at least one track is selected.

| Parameters |
|---|---|
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The seek position in microseconds. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The actual position to which the period was seeked, in microseconds. |

### selectTracks

```
fun selectTracks(
    @NullableType selections: Array<@NullableType ExoTrackSelection!>!,
    mayRetainStreamFlags: BooleanArray<Boolean>!,
    @NullableType streams: Array<@NullableType SampleStream!>!,
    streamResetFlags: BooleanArray<Boolean>!,
    positionUs: Long
): Long
```

Performs a track selection.

The call receives track `selections` for each renderer, `mayRetainStreamFlags` indicating whether the existing `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream` can be retained for each selection, and the existing `stream`s themselves. The call will update `streams` to reflect the provided selections, clearing, setting and replacing entries as required. If an existing sample stream is retained but with the requirement that the consuming renderer be reset, then the corresponding flag in `streamResetFlags` will be set to true. This flag will also be set if a new sample stream is created.

Note that previously passed `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection` are no longer valid, and any references to them must be updated to point to the new selections.

This method is only called after the period has been prepared.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType selections: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/trackselection/ExoTrackSelection!>!` | The renderer track selections. |
| `mayRetainStreamFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html>!` | Flags indicating whether the existing sample stream can be retained for each track selection. A `true` value indicates that the selection is equivalent to the one that was previously passed, and that the caller does not require that the sample stream be recreated. If a retained sample stream holds any references to the track selection then they must be updated to point to the new selection. |
| `@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType streams: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/index.html<@https://developer.android.com/reference/kotlin/androidx/media3/common/util/NullableType https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream!>!` | The existing sample streams, which will be updated to reflect the provided selections. |
| `streamResetFlags: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean-array/index.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html>!` | Will be updated to indicate new sample streams, and sample streams that have been retained but with the requirement that the consuming renderer be reset. |
| `positionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The actual position at which the tracks were enabled, in microseconds. |

### setEndPositionUs

```
fun setEndPositionUs(endPositionUs: Long): Long
```

Sets the end position at which the period stops loading and providing samples.

This method may be called at any time.

If a value other than `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` is returned, the implementation must stop returning samples from the created `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream` instances beyond the specified end position and mark further reads with `https://developer.android.com/reference/kotlin/androidx/media3/common/C#BUFFER_FLAG_END_OF_STREAM()`. The stream may return additional out of order samples required for decoding.

| Parameters |
|---|---|
| `endPositionUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | The requested end position, in microseconds, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` to not set an end position. |

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html` | Returns the actual position, in microseconds, at which the source stops loading and providing samples, or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TIME_END_OF_SOURCE()` if setting the end position is not supported and all samples until then end of the source will be provided. |

### setMediaSource

```
fun setMediaSource(mediaSource: MediaSource!): Unit
```

Sets the `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource` that will create the underlying media period.

### setPrepareListener

```
fun setPrepareListener(listener: MaskingMediaPeriod.PrepareListener!): Unit
```

Sets a listener for preparation events.

| Parameters |
|---|---|
| `listener: https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod.PrepareListener!` | An listener to be notified of media period preparation events. If a listener is set, `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MaskingMediaPeriod#maybeThrowPrepareError()` will not throw but will instead pass the first preparation error (if any) to the listener. |

### setUsesStreamPrerollFlags

```
fun setUsesStreamPrerollFlags(): Unit
```

Notifies the media period that the player will use `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/SampleStream#getFlags()` to check if streams contain initial discontinuities at the start of the period rather than using `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#readDiscontinuity()`.

If invoked then `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaPeriod#readDiscontinuity()` should only report discontinuities that occur during playback, not any initial discontinuities at the start of the period.

## Public properties

### id

```
val id: MediaSource.MediaPeriodId!
```

The `https://developer.android.com/reference/kotlin/androidx/media3/exoplayer/source/MediaSource.MediaPeriodId` used to create the masking media period.

### preparePositionOverrideUs

```
val preparePositionOverrideUs: Long
```

### preparePositionUs

```
val preparePositionUs: Long
```