# FakeMediaPeriod

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/FakeMediaPeriod.java+class:androidx.media3.test.utils.FakeMediaPeriod)

*** ** * ** ***


```
@UnstableApi
public class FakeMediaPeriod implements MediaPeriod
```

<br />

*** ** * ** ***

Fake `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod` that provides tracks from the given `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray`.

## Summary

| ### Nested types |
|---|
| `public interface https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory` A factory to create the test data for a particular track. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#FakeMediaPeriod(androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.upstream.Allocator,long,androidx.media3.exoplayer.source.MediaSourceEventListener.EventDispatcher)( https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray, https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator, long singleSampleTimeUs, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher )` Constructs a FakeMediaPeriod with a single sample for each track in `trackGroupArray`. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#FakeMediaPeriod(androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.upstream.Allocator,long,androidx.media3.exoplayer.source.MediaSourceEventListener.EventDispatcher,androidx.media3.exoplayer.drm.DrmSessionManager,androidx.media3.exoplayer.drm.DrmSessionEventListener.EventDispatcher,boolean)( https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray, https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator, long singleSampleTimeUs, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher, boolean deferOnPrepared )` Constructs a FakeMediaPeriod with a single sample for each track in `trackGroupArray`. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#FakeMediaPeriod(androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.upstream.Allocator,androidx.media3.test.utils.FakeMediaPeriod.TrackDataFactory,androidx.media3.exoplayer.source.MediaSourceEventListener.EventDispatcher,androidx.media3.exoplayer.drm.DrmSessionManager,androidx.media3.exoplayer.drm.DrmSessionEventListener.EventDispatcher,boolean)( https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray, https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator, https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory trackDataFactory, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher, boolean deferOnPrepared )` Constructs a FakeMediaPeriod. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#FakeMediaPeriod(androidx.media3.exoplayer.source.TrackGroupArray,androidx.media3.exoplayer.upstream.Allocator,androidx.media3.test.utils.FakeMediaPeriod.TrackDataFactory,long[],androidx.media3.exoplayer.source.MediaSourceEventListener.EventDispatcher,androidx.media3.exoplayer.drm.DrmSessionManager,androidx.media3.exoplayer.drm.DrmSessionEventListener.EventDispatcher,boolean)( https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray, https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator, https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory trackDataFactory, @https://developer.android.com/reference/androidx/annotation/Nullable long[] syncSampleTimestampsUs, https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher, boolean deferOnPrepared )` Constructs a FakeMediaPeriod. |

| ### Public methods |
|---|---|
| `boolean` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#continueLoading(androidx.media3.exoplayer.LoadingInfo)(https://developer.android.com/reference/androidx/media3/exoplayer/LoadingInfo loadingInfo)` Attempts to continue loading. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#discardBuffer(long,boolean)(long positionUs, boolean toKeyframe)` Discards buffered media up to the specified position. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#getAdjustedSeekPositionUs(long,androidx.media3.exoplayer.SeekParameters)( long positionUs, https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters seekParameters )` Returns the position to which a seek will be performed, given the specified seek position and `https://developer.android.com/reference/androidx/media3/exoplayer/SeekParameters`. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#getBufferedPositionUs()()` Returns an estimate of the position up to which data is buffered for the enabled tracks. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#getNextLoadPositionUs()()` Returns the next load time, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if loading has finished. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#getTrackGroups()()` Returns the `https://developer.android.com/reference/androidx/media3/common/TrackGroup`s exposed by the period. |
| `boolean` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#isLoading()()` Returns whether the media period is currently loading. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#maybeThrowPrepareError()()` Throws an error that's preventing the period from becoming prepared. |
| `synchronized void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#prepare(androidx.media3.exoplayer.source.MediaPeriod.Callback,long)(https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod.Callback callback, long positionUs)` Prepares this media period asynchronously. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#readDiscontinuity()()` Attempts to read a discontinuity. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#reevaluateBuffer(long)(long positionUs)` Re-evaluates the buffer given the playback position. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#release()()` Releases the media period. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#seekToUs(long)(long positionUs)` Attempts to seek to the specified position in microseconds. |
| `long` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#selectTracks(androidx.media3.exoplayer.trackselection.ExoTrackSelection[],boolean[],androidx.media3.exoplayer.source.SampleStream[],boolean[],long)( @https://developer.android.com/reference/androidx/media3/common/util/NullableType ExoTrackSelection[] selections, boolean[] mayRetainStreamFlags, @https://developer.android.com/reference/androidx/media3/common/util/NullableType SampleStream[] streams, boolean[] streamResetFlags, long positionUs )` Performs a track selection. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setDiscontinuityPositionUs(long)(long discontinuityPositionUs)` Sets a discontinuity position to be returned from the next call to `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#readDiscontinuity()`. |
| `synchronized void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setPreparationComplete()()` Allows the fake media period to complete preparation. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setSeekToUsOffset(long)(long seekOffsetUs)` Sets an offset to be applied to positions returned by `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#seekToUs(long)`. |
| `void` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setUsesStreamPrerollFlags()()` Notifies the media period that the player will use `https://developer.android.com/reference/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/androidx/media3/exoplayer/source/MediaPeriod#readDiscontinuity()`. |

| ### Protected methods |
|---|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream` | `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#createSampleStream(androidx.media3.exoplayer.upstream.Allocator,androidx.media3.exoplayer.source.MediaSourceEventListener.EventDispatcher,androidx.media3.exoplayer.drm.DrmSessionManager,androidx.media3.exoplayer.drm.DrmSessionEventListener.EventDispatcher,androidx.media3.common.Format,java.util.List<androidx.media3.test.utils.FakeSampleStream.FakeSampleStreamItem>)( https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator, @https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager, https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher, https://developer.android.com/reference/androidx/media3/common/Format initialFormat, https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream.FakeSampleStreamItem> fakeSampleStreamItems )` Creates a new `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream`. |

| ### Inherited methods |
|---|
| From [androidx.media3.exoplayer.source.MediaPeriod](https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod) |---|---| | `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/common/StreamKey>` | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod#getStreamKeys(java.util.List<androidx.media3.exoplayer.trackselection.ExoTrackSelection>)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/exoplayer/trackselection/ExoTrackSelection> trackSelections)` Returns a list of `https://developer.android.com/reference/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/androidx/media3/exoplayer/trackselection/ExoTrackSelection`. | | `long` | `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod#setEndPositionUs(long)(long endPositionUs)` Sets the end position at which the period stops loading and providing samples. | |

## Public constructors

### FakeMediaPeriod

```
public FakeMediaPeriod(
    TrackGroupArray trackGroupArray,
    Allocator allocator,
    long singleSampleTimeUs,
    MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher
)
```

Constructs a FakeMediaPeriod with a single sample for each track in `trackGroupArray`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray` | The track group array. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator` | An `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator`. |
| `long singleSampleTimeUs` | The timestamp to use for the single sample in each track, in microseconds. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher` | A dispatcher for `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener` events. |

### FakeMediaPeriod

```
public FakeMediaPeriod(
    TrackGroupArray trackGroupArray,
    Allocator allocator,
    long singleSampleTimeUs,
    MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher,
    DrmSessionManager drmSessionManager,
    DrmSessionEventListener.EventDispatcher drmEventDispatcher,
    boolean deferOnPrepared
)
```

Constructs a FakeMediaPeriod with a single sample for each track in `trackGroupArray`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray` | The track group array. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator` | An `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator`. |
| `long singleSampleTimeUs` | The timestamp to use for the single sample in each track, in microseconds. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher` | A dispatcher for `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener` events. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager` | The `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager` used for DRM interactions. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher` | A dispatcher for `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener` events. |
| `boolean deferOnPrepared` | Whether `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod.Callback#onPrepared(androidx.media3.exoplayer.source.MediaPeriod)` should be called only after `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setPreparationComplete()` has been called. If `false` preparation completes immediately. |

### FakeMediaPeriod

```
public FakeMediaPeriod(
    TrackGroupArray trackGroupArray,
    Allocator allocator,
    FakeMediaPeriod.TrackDataFactory trackDataFactory,
    MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher,
    DrmSessionManager drmSessionManager,
    DrmSessionEventListener.EventDispatcher drmEventDispatcher,
    boolean deferOnPrepared
)
```

Constructs a FakeMediaPeriod.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray` | The track group array. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator` | An `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator`. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory trackDataFactory` | The `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory` creating the data. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher` | A dispatcher for media source events. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager` | The `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager` used for DRM interactions. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher` | A dispatcher for `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener` events. |
| `boolean deferOnPrepared` | Whether `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod.Callback#onPrepared(androidx.media3.exoplayer.source.MediaPeriod)` should be called only after `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setPreparationComplete()` has been called. If `false` preparation completes immediately. |

### FakeMediaPeriod

```
public FakeMediaPeriod(
    TrackGroupArray trackGroupArray,
    Allocator allocator,
    FakeMediaPeriod.TrackDataFactory trackDataFactory,
    @Nullable long[] syncSampleTimestampsUs,
    MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher,
    DrmSessionManager drmSessionManager,
    DrmSessionEventListener.EventDispatcher drmEventDispatcher,
    boolean deferOnPrepared
)
```

Constructs a FakeMediaPeriod.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/TrackGroupArray trackGroupArray` | The track group array. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator` | An `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator`. |
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory trackDataFactory` | The `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod.TrackDataFactory` creating the data. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable long[] syncSampleTimestampsUs` | A list of timestamps of samples returned from ` trackDataFactory` which are 'sync samples' for the purposes of seeking. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher` | A dispatcher for media source events. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager` | The `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager` used for DRM interactions. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher` | A dispatcher for `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener` events. |
| `boolean deferOnPrepared` | Whether `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod.Callback#onPrepared(androidx.media3.exoplayer.source.MediaPeriod)` should be called only after `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#setPreparationComplete()` has been called. If `false` preparation completes immediately. |

## Public methods

### continueLoading

```
public boolean continueLoading(LoadingInfo loadingInfo)
```

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/androidx/media3/exoplayer/source/SequenceableLoader.Callback#onContinueLoadingRequested(T)` on the `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaPeriod.Callback` passed to `https://developer.android.com/reference/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 |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/LoadingInfo loadingInfo` | The `https://developer.android.com/reference/androidx/media3/exoplayer/LoadingInfo` when attempting to continue loading. |

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

### discardBuffer

```
public void discardBuffer(long positionUs, boolean toKeyframe)
```

Discards buffered media up to the specified position.

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

| Parameters |
|---|---|
| `long positionUs` | The position in microseconds. |
| `boolean toKeyframe` | 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

```
public long getAdjustedSeekPositionUs(
    long positionUs,
    SeekParameters seekParameters
)
```

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

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

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

| Returns |
|---|---|
| `long` | The actual position to which a seek will be performed, in microseconds. |

### getBufferedPositionUs

```
public long getBufferedPositionUs()
```

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 |
|---|---|
| `long` | An estimate of the absolute position in microseconds up to which data is buffered, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_END_OF_SOURCE()` if the track is fully buffered. |

### getNextLoadPositionUs

```
public long getNextLoadPositionUs()
```

Returns the next load time, or `https://developer.android.com/reference/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.

### getTrackGroups

```
public TrackGroupArray getTrackGroups()
```

Returns the `https://developer.android.com/reference/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/androidx/media3/exoplayer/source/TrackGroupArray` | The `https://developer.android.com/reference/androidx/media3/common/TrackGroup`s. |

### isLoading

```
public boolean isLoading()
```

Returns whether the media period is currently loading.

### maybeThrowPrepareError

```
public void maybeThrowPrepareError()
```

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. |

### prepare

```
synchronized public void prepare(MediaPeriod.Callback callback, long positionUs)
```

Prepares this media period asynchronously.

`callback.onPrepared` is called when preparation completes. If preparation fails, `https://developer.android.com/reference/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/androidx/media3/exoplayer/source/MediaSource.MediaSourceCaller#onSourceInfoRefreshed(androidx.media3.exoplayer.source.MediaSource,androidx.media3.common.Timeline)` will be called before `callback.onPrepared`.

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

### readDiscontinuity

```
public long readDiscontinuity()
```

Attempts to read a discontinuity.

A discontinuity implies that the provided `https://developer.android.com/reference/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/androidx/media3/common/C#TIME_UNSET()`, all `https://developer.android.com/reference/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 |
|---|---|
| `long` | The playback position after the discontinuity, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if there is no discontinuity. |

### reevaluateBuffer

```
public void reevaluateBuffer(long positionUs)
```

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 |
|---|---|
| `long positionUs` | 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. |

### release

```
public void release()
```

Releases the media period.

### seekToUs

```
public long seekToUs(long positionUs)
```

Attempts to seek to the specified position in microseconds.

After this method has been called, all `https://developer.android.com/reference/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 |
|---|---|
| `long positionUs` | The seek position in microseconds. |

| Returns |
|---|---|
| `long` | The actual position to which the period was seeked, in microseconds. |

### selectTracks

```
public long selectTracks(
    @NullableType ExoTrackSelection[] selections,
    boolean[] mayRetainStreamFlags,
    @NullableType SampleStream[] streams,
    boolean[] streamResetFlags,
    long positionUs
)
```

Performs a track selection.

The call receives track `selections` for each renderer, `mayRetainStreamFlags` indicating whether the existing `https://developer.android.com/reference/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/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/androidx/media3/common/util/NullableType ExoTrackSelection[] selections` | The renderer track selections. |
| `boolean[] mayRetainStreamFlags` | 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/androidx/media3/common/util/NullableType SampleStream[] streams` | The existing sample streams, which will be updated to reflect the provided selections. |
| `boolean[] streamResetFlags` | 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. |
| `long positionUs` | The current playback position in microseconds. If playback of this period has not yet started, the value will be the starting position. |

| Returns |
|---|---|
| `long` | The actual position at which the tracks were enabled, in microseconds. |

### setDiscontinuityPositionUs

```
public void setDiscontinuityPositionUs(long discontinuityPositionUs)
```

Sets a discontinuity position to be returned from the next call to `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#readDiscontinuity()`.

| Parameters |
|---|---|
| `long discontinuityPositionUs` | The position to be returned, in microseconds. |

### setPreparationComplete

```
synchronized public void setPreparationComplete()
```

Allows the fake media period to complete preparation. May be called on any thread.

### setSeekToUsOffset

```
public void setSeekToUsOffset(long seekOffsetUs)
```

Sets an offset to be applied to positions returned by `https://developer.android.com/reference/androidx/media3/test/utils/FakeMediaPeriod#seekToUs(long)`.

| Parameters |
|---|---|
| `long seekOffsetUs` | The offset to be applied, in microseconds. |

### setUsesStreamPrerollFlags

```
public void setUsesStreamPrerollFlags()
```

Notifies the media period that the player will use `https://developer.android.com/reference/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/androidx/media3/exoplayer/source/MediaPeriod#readDiscontinuity()`.

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

## Protected methods

### createSampleStream

```
protected FakeSampleStream createSampleStream(
    Allocator allocator,
    @Nullable MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher,
    DrmSessionManager drmSessionManager,
    DrmSessionEventListener.EventDispatcher drmEventDispatcher,
    Format initialFormat,
    List<FakeSampleStream.FakeSampleStreamItem> fakeSampleStreamItems
)
```

Creates a new `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream`.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator allocator` | An `https://developer.android.com/reference/androidx/media3/exoplayer/upstream/Allocator` from which to obtain media buffer allocations. |
| `@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher mediaSourceEventDispatcher` | A `https://developer.android.com/reference/androidx/media3/exoplayer/source/MediaSourceEventListener.EventDispatcher` to notify of media events. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager drmSessionManager` | A `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionManager` for DRM interactions. |
| `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher drmEventDispatcher` | A `https://developer.android.com/reference/androidx/media3/exoplayer/drm/DrmSessionEventListener.EventDispatcher` to notify of DRM events. |
| `https://developer.android.com/reference/androidx/media3/common/Format initialFormat` | The first `https://developer.android.com/reference/androidx/media3/common/Format` to output. |
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream.FakeSampleStreamItem> fakeSampleStreamItems` | The `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream.FakeSampleStreamItem` to output. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream` | A new `https://developer.android.com/reference/androidx/media3/test/utils/FakeSampleStream`. |