EditedMediaItemSequence.Builder

Artifact: androidx.media3:media3-transformer

View Source

---

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

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

public 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

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)

This method is deprecated.

Use Builder to set sequence track types instead.

experimentalSetForceVideoTrack

@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder experimentalSetForceVideoTrack(boolean forceVideoTrack)

This method is deprecated.

Use Builder to set sequence track types instead.

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.