EditedMediaItemSequence

Artifact: androidx.media3:media3-transformer

View Source

---

Kotlin |Java

@UnstableApi
class EditedMediaItemSequence

---

A sequence of EditedMediaItem instances.

EditedMediaItem instances in a sequence don't overlap in time.

Summary

Nested types
class EditedMediaItemSequence.Builder A builder for instances of EditedMediaItemSequence.

Public functions
EditedMediaItemSequence.Builder!	buildUpon() Returns a Builder initialized with the values of this instance.
String!	toString()
java-static EditedMediaItemSequence!	withAudioAndVideoFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!) Creates a sequence with both audio and video from a list of EditedMediaItems.
java-static EditedMediaItemSequence!	withAudioFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!) Creates an audio-only sequence from a list of EditedMediaItems.
java-static EditedMediaItemSequence!	withVideoFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!) Creates an video-only sequence from a list of EditedMediaItems.

Public properties
ImmutableList<EditedMediaItem!>!	editedMediaItems The EditedMediaItem instances in the sequence.
Boolean	forceAudioTrack This property is deprecated. Use trackTypes.contains(C.TRACK_TYPE_AUDIO) instead.
Boolean	forceVideoTrack This property is deprecated. Use trackTypes.contains(C.TRACK_TYPE_VIDEO) instead.
Boolean	isLooping Whether this sequence is looping.
ImmutableSet<@C.TrackType Int!>!	trackTypes The track types enabled for this sequence.

Public functions

buildUpon

fun buildUpon(): EditedMediaItemSequence.Builder!

Returns a Builder initialized with the values of this instance.

toString

fun toString(): String!

withAudioAndVideoFrom

java-static fun withAudioAndVideoFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!): EditedMediaItemSequence!

Creates a sequence with both audio and video from a list of EditedMediaItems.

This is equivalent to using the Builder and setting the track types to include TRACK_TYPE_AUDIO and TRACK_TYPE_VIDEO. The sequence will produce both audio and video output.

Parameters
editedMediaItems: (Mutable)List<EditedMediaItem!>!	The list of EditedMediaItems to add to the sequence.

Returns
EditedMediaItemSequence!	A new audio and video EditedMediaItemSequence.

withAudioFrom

java-static fun withAudioFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!): EditedMediaItemSequence!

Creates an audio-only sequence from a list of EditedMediaItems.

This is equivalent to using the Builder and setting the track types to only include TRACK_TYPE_AUDIO. The sequence will only produce an audio output.

Parameters
editedMediaItems: (Mutable)List<EditedMediaItem!>!	The list of EditedMediaItems to add to the sequence.

Returns
EditedMediaItemSequence!	A new audio-only EditedMediaItemSequence.

withVideoFrom

java-static fun withVideoFrom(editedMediaItems: (Mutable)List<EditedMediaItem!>!): EditedMediaItemSequence!

Creates an video-only sequence from a list of EditedMediaItems.

This is equivalent to using the Builder and setting the track types to only include TRACK_TYPE_VIDEO. The sequence will only produce a video output.

Parameters
editedMediaItems: (Mutable)List<EditedMediaItem!>!	The list of EditedMediaItems to add to the sequence.

Returns
EditedMediaItemSequence!	A new video-only EditedMediaItemSequence.

Public properties

editedMediaItems

val editedMediaItems: ImmutableList<EditedMediaItem!>!

The EditedMediaItem instances in the sequence.

This list must not be empty.

forceAudioTrack

val forceAudioTrack: Boolean

This property is deprecated.

Use trackTypes.contains(C.TRACK_TYPE_AUDIO) instead.

forceVideoTrack

val forceVideoTrack: Boolean

This property is deprecated.

Use trackTypes.contains(C.TRACK_TYPE_VIDEO) instead.

isLooping

val isLooping: Boolean

Whether this sequence is looping.

This value indicates whether to loop over the EditedMediaItem instances in this sequence until all the non-looping sequences in the Composition have ended.

A looping sequence ends at the same time as the longest non-looping sequence. This means that the last exported EditedMediaItem from a looping sequence can be only partially exported.

trackTypes

val trackTypes: ImmutableSet<@C.TrackType Int!>!

The track types enabled for this sequence.

This set, containing TRACK_TYPE_AUDIO and/or TRACK_TYPE_VIDEO, determines which tracks will be included in the sequence's output. For example, a set containing only TRACK_TYPE_AUDIO will result in an audio-only output.