# EditedMediaItemSequence.Builder

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

*** ** * ** ***


```
public final class EditedMediaItemSequence.Builder
```

<br />

*** ** * ** ***

A builder for instances of `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence`.

## Summary

| ### Public constructors |
|---|
| `[Builder](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(androidx.media3.transformer.EditedMediaItem...))(EditedMediaItem[] editedMediaItems)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to create the builder, and `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(java.util.List<androidx.media3.transformer.EditedMediaItem>)` to add the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem`s, or use the static factory methods like `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, or `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioAndVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`. <br /> |
| `[Builder](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.List<androidx.media3.transformer.EditedMediaItem>))(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem> editedMediaItems)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to create the builder, and `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(java.util.List<androidx.media3.transformer.EditedMediaItem>)` to add the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem`s, or use the static factory methods like `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, or `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioAndVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`. <br /> |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)(https://developer.android.com/reference/java/util/Set.html<@https://developer.android.com/reference/androidx/media3/common/C.TrackType https://developer.android.com/reference/java/lang/Integer.html> trackTypes)` Creates an instance. |

| ### Public methods |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addGap(long)(long durationUs)` Adds a gap to the sequence. |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItem(androidx.media3.transformer.EditedMediaItem)(https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem item)` Adds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` to the sequence. |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(androidx.media3.transformer.EditedMediaItem...)(EditedMediaItem[] items)` Adds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` to the sequence. |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(java.util.List<androidx.media3.transformer.EditedMediaItem>)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem> items)` Adds all the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` in the list to the sequence. |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence` | `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#build()()` Builds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence`. |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html [experimentalSetForceAudioTrack](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#experimentalSetForceAudioTrack(boolean))(boolean forceAudioTrack)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to set sequence track types instead. <br /> |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html [experimentalSetForceVideoTrack](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#experimentalSetForceVideoTrack(boolean))(boolean forceVideoTrack)` **This method is deprecated.** Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to set sequence track types instead. <br /> |
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | `@https://checkerframework.org/api/com/google/errorprone/annotations/CanIgnoreReturnValue.html https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#setIsLooping(boolean)(boolean isLooping)` See `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#isLooping()`. |

## Public constructors

### Builder

```
public [Builder](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(androidx.media3.transformer.EditedMediaItem...))(EditedMediaItem[] editedMediaItems)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to create the builder, and `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(java.util.List<androidx.media3.transformer.EditedMediaItem>)` to add the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem`s, or use the static factory methods like `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, or `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioAndVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`.

### Builder

```
public [Builder](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.List<androidx.media3.transformer.EditedMediaItem>))(List<EditedMediaItem> editedMediaItems)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to create the builder, and `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#addItems(java.util.List<androidx.media3.transformer.EditedMediaItem>)` to add the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem`s, or use the static factory methods like `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`, or `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#withAudioAndVideoFrom(java.util.List<androidx.media3.transformer.EditedMediaItem>)`.

### Builder

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

Creates an instance.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/Set.html<@https://developer.android.com/reference/androidx/media3/common/C.TrackType https://developer.android.com/reference/java/lang/Integer.html> trackTypes` | The non-empty set of track types enabled for this sequence. Must only contain `https://developer.android.com/reference/androidx/media3/common/C#TRACK_TYPE_AUDIO()` and/or `https://developer.android.com/reference/androidx/media3/common/C#TRACK_TYPE_VIDEO()`. This determines which tracks will be included in this sequence's output. For example, passing a set containing only `https://developer.android.com/reference/androidx/media3/common/C#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 `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#trackTypes()`.

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

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | This builder, for convenience. |

### addItem

```
@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder addItem(EditedMediaItem item)
```

Adds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` to the sequence.

| Parameters |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem item` | The `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` to add. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | This builder, for convenience. |

### addItems

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

Adds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` to the sequence.

| Parameters |
|---|---|
| `EditedMediaItem[] items` | The `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` instances to add. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | This builder, for convenience. |

### addItems

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

Adds all the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` in the list to the sequence.

| Parameters |
|---|---|
| `https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem> items` | The list of `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItem` instances to add. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | This builder, for convenience. |

### build

```
public EditedMediaItemSequence build()
```

Builds the `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence`.

There must be at least one item in the sequence.

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence` | The built `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence`. |

### experimentalSetForceAudioTrack

```
@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder [experimentalSetForceAudioTrack](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#experimentalSetForceAudioTrack(boolean))(boolean forceAudioTrack)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to set sequence track types instead.

### experimentalSetForceVideoTrack

```
@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder [experimentalSetForceVideoTrack](https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#experimentalSetForceVideoTrack(boolean))(boolean forceVideoTrack)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder#Builder(java.util.Set<java.lang.Integer>)` to set sequence track types instead.

### setIsLooping

```
@CanIgnoreReturnValue
public EditedMediaItemSequence.Builder setIsLooping(boolean isLooping)
```

See `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence#isLooping()`.

Looping is `false` by default.

| Parameters |
|---|---|
| `boolean isLooping` | Whether this sequence should loop. |

| Returns |
|---|---|
| `https://developer.android.com/reference/androidx/media3/transformer/EditedMediaItemSequence.Builder` | This builder, for convenience. |