# EditedMediaItemSequence

Artifact: [androidx.media3:media3-transformer](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/transformer/EditedMediaItemSequence.java+class:androidx.media3.transformer.EditedMediaItemSequence)

*** ** * ** ***

<br />

```
@UnstableApi
class EditedMediaItemSequence
```

<br />

*** ** * ** ***

A sequence of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` instances.

`https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` instances in a sequence don't overlap in time.

## Summary

| ### Nested types |
|---|
| `class https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder` A builder for instances of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence`. |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#buildUpon()()` Returns a `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder` initialized with the values of this instance. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-string/index.html!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#toString()()` |
| `java-static https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#withAudioAndVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)(editedMediaItems: (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/transformer/EditedMediaItem!>!)` Creates a sequence with both audio and video from a list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s. |
| `java-static https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#withAudioFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)(editedMediaItems: (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/transformer/EditedMediaItem!>!)` Creates an audio-only sequence from a list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s. |
| `java-static https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#withVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)(editedMediaItems: (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/transformer/EditedMediaItem!>!)` Creates an video-only sequence from a list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s. |

| ### Public properties |
|---|---|
| `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html<https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem!>!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#editedMediaItems()` The `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` instances in the sequence. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#forceAudioTrack()` **This property is deprecated.** Use `trackTypes.contains(C.TRACK_TYPE_AUDIO)` instead. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#forceVideoTrack()` **This property is deprecated.** Use `trackTypes.contains(C.TRACK_TYPE_VIDEO)` instead. <br /> |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-boolean/index.html` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#isLooping()` Whether this sequence is looping. |
| `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableSet.html<https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html!>!` | `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence#trackTypes()` The track types enabled for this sequence. |

## Public functions

### buildUpon

```
fun buildUpon(): EditedMediaItemSequence.Builder!
```

Returns a `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.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 `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s.

This is equivalent to using the `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder` and setting the track types to include `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_AUDIO()` and `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_VIDEO()`. The sequence will produce both audio and video output.

| Parameters |
|---|---|
| `editedMediaItems: (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/transformer/EditedMediaItem!>!` | The list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s to add to the sequence. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | A new audio and video `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence`. |

### withAudioFrom

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

Creates an audio-only sequence from a list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s.

This is equivalent to using the `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder` and setting the track types to only include `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_AUDIO()`. The sequence will only produce an audio output.

| Parameters |
|---|---|
| `editedMediaItems: (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/transformer/EditedMediaItem!>!` | The list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s to add to the sequence. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | A new audio-only `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence`. |

### withVideoFrom

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

Creates an video-only sequence from a list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s.

This is equivalent to using the `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence.Builder` and setting the track types to only include `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_VIDEO()`. The sequence will only produce a video output.

| Parameters |
|---|---|
| `editedMediaItems: (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/transformer/EditedMediaItem!>!` | The list of `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem`s to add to the sequence. |

| Returns |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence!` | A new video-only `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItemSequence`. |

## Public properties

### editedMediaItems

```
val editedMediaItems: ImmutableList<EditedMediaItem!>!
```

The `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` instances in the sequence.

This list must not be empty.

### forceAudioTrack

```
val forceAudioTrack: Boolean
```

> [!CAUTION]
> **This property is deprecated.**   
>
> Use `trackTypes.contains(C.TRACK_TYPE_AUDIO)` instead.

### forceVideoTrack

```
val forceVideoTrack: Boolean
```

> [!CAUTION]
> **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 `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` instances in this sequence until all the non-looping sequences in the `https://developer.android.com/reference/kotlin/androidx/media3/transformer/Composition` have ended.

A looping sequence ends at the same time as the longest non-looping sequence. This means that the last exported `https://developer.android.com/reference/kotlin/androidx/media3/transformer/EditedMediaItem` from a looping sequence can be only partially exported.

### trackTypes

```
val trackTypes: ImmutableSet<Int!>!
```

The track types enabled for this sequence.

This set, containing `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_AUDIO()` and/or `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_VIDEO()`, determines which tracks will be included in the sequence's output. For example, a set containing only `https://developer.android.com/reference/kotlin/androidx/media3/common/C#TRACK_TYPE_AUDIO()` will result in an audio-only output.