EditedMediaItemSequence.Builder

Artifact: androidx.media3:media3-transformer

Kotlin |Java

public final class EditedMediaItemSequence.Builder

A builder for instances of EditedMediaItemSequence.

Summary

Public constructors
`Builder(EditedMediaItem[] editedMediaItems)` This method is deprecated. Use `Builder` to create the builder, and `addItems` to add the `EditedMediaItem`s, or use the static factory methods like `withAudioFrom`, `withVideoFrom`, or `withAudioAndVideoFrom`.
`Builder(List<EditedMediaItem> editedMediaItems)` This method is deprecated. Use `Builder` to create the builder, and `addItems` to add the `EditedMediaItem`s, or use the static factory methods like `withAudioFrom`, `withVideoFrom`, or `withAudioAndVideoFrom`.
`Builder(Set<@C.TrackType Integer> trackTypes)` Creates an instance.

Public constructors

Builder(EditedMediaItem[] editedMediaItems)

This method is deprecated.

Use Builder to create the builder, and addItems to add the EditedMediaItems, or use the static factory methods like withAudioFrom, withVideoFrom, or withAudioAndVideoFrom.

Builder(List<EditedMediaItem> editedMediaItems)

This method is deprecated.

Use Builder to create the builder, and addItems to add the EditedMediaItems, or use the static factory methods like withAudioFrom, withVideoFrom, or withAudioAndVideoFrom.

Builder(Set<@C.TrackType Integer> trackTypes)

Creates an instance.

Public methods
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue addGap(long durationUs)` Adds a gap to the sequence.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue addItem(EditedMediaItem item)` Adds the `item` to the sequence.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue addItems(EditedMediaItem[] items)` Adds the `items` to the sequence.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue addItems(List<EditedMediaItem> items)` Adds all the `items` in the list to the sequence.
`EditedMediaItemSequence`	`build()` Builds the `EditedMediaItemSequence`.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue experimentalSetForceAudioTrack(boolean forceAudioTrack)` This method is deprecated. Use `Builder` to set sequence track types instead.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue experimentalSetForceVideoTrack(boolean forceVideoTrack)` This method is deprecated. Use `Builder` to set sequence track types instead.
`EditedMediaItemSequence.Builder`	`@CanIgnoreReturnValue setIsLooping(boolean isLooping)` See `isLooping`.

Public constructors

Builder

public Builder(EditedMediaItem[] editedMediaItems)

Builder

public Builder(List<EditedMediaItem> editedMediaItems)

Builder

public Builder(Set<@C.TrackType Integer> trackTypes)

Creates an instance.

Parameters
`Set<@C.TrackType Integer> trackTypes`	The non-empty set of track types enabled for this sequence. Must only contain `TRACK_TYPE_AUDIO` and/or `TRACK_TYPE_VIDEO`. This determines which tracks will be included in this sequence's output. For example, passing a set containing only `TRACK_TYPE_AUDIO` will result in an audio-only sequence.

Public methods

addGap

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder addGap(long durationUs)

Adds a gap to the sequence.

A gap is a period of time with no media.

The gap's tracks match the trackTypes.

Parameters
`long durationUs`	The duration of the gap, in milliseconds.

Returns
`EditedMediaItemSequence.Builder`	This builder, for convenience.

addItem

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder addItem(EditedMediaItem item)

Adds the item to the sequence.

Parameters
`EditedMediaItem item`	The `EditedMediaItem` to add.

Returns
`EditedMediaItemSequence.Builder`	This builder, for convenience.

addItems

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder addItems(EditedMediaItem[] items)

Adds the items to the sequence.

Parameters
`EditedMediaItem[] items`	The `EditedMediaItem` instances to add.

Returns
`EditedMediaItemSequence.Builder`	This builder, for convenience.

addItems

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder addItems(List<EditedMediaItem> items)

Adds all the items in the list to the sequence.

Parameters
`List<EditedMediaItem> items`	The list of `EditedMediaItem` instances to add.

Returns
`EditedMediaItemSequence.Builder`	This builder, for convenience.

build

public EditedMediaItemSequence build()

Builds the EditedMediaItemSequence.

There must be at least one item in the sequence.

Returns
`EditedMediaItemSequence`	The built `EditedMediaItemSequence`.

experimentalSetForceAudioTrack

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder experimentalSetForceAudioTrack(boolean forceAudioTrack)

experimentalSetForceVideoTrack

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder experimentalSetForceVideoTrack(boolean forceVideoTrack)

setIsLooping

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder setIsLooping(boolean isLooping)

See isLooping.

Looping is false by default.

Parameters
`boolean isLooping`	Whether this sequence should loop.

Returns
`EditedMediaItemSequence.Builder`	This builder, for convenience.