# CuesWithTiming

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

*** ** * ** ***

<br />

```
@UnstableApi
public class CuesWithTiming
```

<br />

*** ** * ** ***

A list of `https://developer.android.com/reference/androidx/media3/common/text/Cue` instances with a start time and duration.

## Summary

| ### Public fields |
|---|---|
| `final https://guava.dev/releases/snapshot-android/api/docs/com/google/common/collect/ImmutableList.html<https://developer.android.com/reference/androidx/media3/common/text/Cue>` | `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` The cues to show on screen. |
| `final long` | `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#durationUs()` The duration for which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should be shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known. |
| `final long` | `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#endTimeUs()` The time at which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should stop being shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known. |
| `final long` | `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#startTimeUs()` The time at which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should be shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#CuesWithTiming(java.util.List<androidx.media3.common.text.Cue>,long,long)(https://developer.android.com/reference/java/util/List.html<https://developer.android.com/reference/androidx/media3/common/text/Cue> cues, long startTimeUs, long durationUs)` Creates an instance. |

## Public fields

### cues

```
public final ImmutableList<Cue> cues
```

The cues to show on screen.

### durationUs

```
public final long durationUs
```

The duration for which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should be shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known.

If `https://developer.android.com/reference/androidx/media3/common/Format#cueReplacementBehavior()` is `https://developer.android.com/reference/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_MERGE()` then cues from multiple instances will be shown on screen simultaneously if their start times and durations overlap.

`https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` is only permitted if the `https://developer.android.com/reference/androidx/media3/common/Format#cueReplacementBehavior()` of the current track is `https://developer.android.com/reference/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_REPLACE()`.

### endTimeUs

```
public final long endTimeUs
```

The time at which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should stop being shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known.

The time base of this is the same as `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#startTimeUs()`.

If `https://developer.android.com/reference/androidx/media3/common/Format#cueReplacementBehavior()` is `https://developer.android.com/reference/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_MERGE()` then cues from multiple instances will be shown on screen simultaneously if their start and times overlap.

`https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` is only permitted if the `https://developer.android.com/reference/androidx/media3/common/Format#cueReplacementBehavior()` of the current track is `https://developer.android.com/reference/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_REPLACE()`.

### startTimeUs

```
public final long startTimeUs
```

The time at which `https://developer.android.com/reference/androidx/media3/extractor/text/CuesWithTiming#cues()` should be shown on screen, in microseconds, or `https://developer.android.com/reference/androidx/media3/common/C#TIME_UNSET()` if not known.

The time base of this depends on the context from which this instance was obtained.

## Public constructors

### CuesWithTiming

```
public CuesWithTiming(List<Cue> cues, long startTimeUs, long durationUs)
```

Creates an instance.