# 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
class CuesWithTiming
```

<br />

*** ** * ** ***

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

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/media3/extractor/text/CuesWithTiming#CuesWithTiming(java.util.List<androidx.media3.common.text.Cue>,long,long)( cues: (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/common/text/Cue!>!, startTimeUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html, durationUs: https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-long/index.html )` Creates an instance. |

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

## Public constructors

### CuesWithTiming

```
CuesWithTiming(
    cues: (Mutable)List<Cue!>!,
    startTimeUs: Long,
    durationUs: Long
)
```

Creates an instance.

## Public properties

### cues

```
val cues: ImmutableList<Cue!>!
```

The cues to show on screen.

### durationUs

```
val durationUs: Long
```

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

If `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#cueReplacementBehavior()` is `https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/common/C#TIME_UNSET()` is only permitted if the `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#cueReplacementBehavior()` of the current track is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_REPLACE()`.

### endTimeUs

```
val endTimeUs: Long
```

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

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

If `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#cueReplacementBehavior()` is `https://developer.android.com/reference/kotlin/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/kotlin/androidx/media3/common/C#TIME_UNSET()` is only permitted if the `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#cueReplacementBehavior()` of the current track is `https://developer.android.com/reference/kotlin/androidx/media3/common/Format#CUE_REPLACEMENT_BEHAVIOR_REPLACE()`.

### startTimeUs

```
val startTimeUs: Long
```

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

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