@UnstableApi
class Track

Encapsulates information describing an MP4 track.

Summary

Nested types
@Documented
@Retention(value = RetentionPolicy.SOURCE)
@Target(value = TYPE_USE)
@IntDef(value = )
annotation Track.Transformation

The transformation to apply to samples in the track, if any.

Constants
const Int

A transformation for caption samples in cdat atoms.
const Int

A no-op sample transformation.

Public constructors
Track(
    id: Int,
    @C.TrackType type: Int,
    timescale: Long,
    movieTimescale: Long,
    durationUs: Long,
    format: Format!,
    @Track.Transformation sampleTransformation: Int,
    sampleDescriptionEncryptionBoxes: Array<TrackEncryptionBox!>?,
    nalUnitLengthFieldLength: Int,
    editListDurations: LongArray?,
    editListMediaTimes: LongArray?
)

Public functions
Track!
TrackEncryptionBox?
getSampleDescriptionEncryptionBox(sampleDescriptionIndex: Int)

Returns the TrackEncryptionBox for the given sample description index.

Public properties
Long

The duration of the track in microseconds, or TIME_UNSET if unknown.
LongArray<Long>?

Durations of edit list segments in the movie timescale.
LongArray<Long>?

Media times for edit list segments in the track timescale.
Format!

The format.
Int

The track identifier.
Long

The movie timescale.
Int

The length in bytes of the NALUnitLength field in each sample.
Int

One of TRANSFORMATION_*.
Long

The track timescale, defined as the number of time units that pass in one second.
Int

One of TRACK_TYPE_AUDIO, TRACK_TYPE_VIDEO and TRACK_TYPE_TEXT.

Constants

TRANSFORMATION_CEA608_CDAT

const val TRANSFORMATION_CEA608_CDAT = 1: Int

A transformation for caption samples in cdat atoms.

TRANSFORMATION_NONE

const val TRANSFORMATION_NONE = 0: Int

A no-op sample transformation.

Public constructors

Track

Track(
    id: Int,
    @C.TrackType type: Int,
    timescale: Long,
    movieTimescale: Long,
    durationUs: Long,
    format: Format!,
    @Track.Transformation sampleTransformation: Int,
    sampleDescriptionEncryptionBoxes: Array<TrackEncryptionBox!>?,
    nalUnitLengthFieldLength: Int,
    editListDurations: LongArray?,
    editListMediaTimes: LongArray?
)

Public functions

copyWithFormat

fun copyWithFormat(format: Format!): Track!

getSampleDescriptionEncryptionBox

fun getSampleDescriptionEncryptionBox(sampleDescriptionIndex: Int): TrackEncryptionBox?

Returns the TrackEncryptionBox for the given sample description index.

Parameters
sampleDescriptionIndex: Int

The given sample description index
Returns
TrackEncryptionBox?

The TrackEncryptionBox for the given sample description index. Maybe null if no such entry exists.

Public properties

durationUs

val durationUs: Long

The duration of the track in microseconds, or TIME_UNSET if unknown.

editListDurations

val editListDurations: LongArray<Long>?

Durations of edit list segments in the movie timescale. Null if there is no edit list.

editListMediaTimes

val editListMediaTimes: LongArray<Long>?

Media times for edit list segments in the track timescale. Null if there is no edit list.

format

val format: Format!

The format.

id

val id: Int

The track identifier.

movieTimescale

val movieTimescale: Long

The movie timescale.

nalUnitLengthFieldLength

val nalUnitLengthFieldLength: Int

The length in bytes of the NALUnitLength field in each sample. 0 for tracks that don't use length-delimited NAL units.

sampleTransformation

@Track.Transformation
val sampleTransformation: Int

One of TRANSFORMATION_*. Defines the transformation to apply before outputting each sample.

timescale

val timescale: Long

The track timescale, defined as the number of time units that pass in one second.

type

@C.TrackType
val type: Int

One of TRACK_TYPE_AUDIO, TRACK_TYPE_VIDEO and TRACK_TYPE_TEXT.