TrackSampleTable

Artifact: androidx.media3:media3-extractor

Kotlin |Java

@UnstableApi
public final class TrackSampleTable

Sample table for a track in an MP4 file.

Summary

Public fields
`final long`	`durationUs` The duration of the track sample table in microseconds.
`final int[]`	`flags` Sample flags.
`final boolean`	`hasOnlySyncSamples` Whether all samples in the track are sync samples.
`final int`	`maximumSize` Maximum sample size in `sizes`.
`final long[]`	`offsets` Sample offsets in bytes.
`final int`	`sampleCount` Number of samples.
`final int[]`	`sizes` Sample sizes in bytes.
`final int[]`	`syncSampleIndices` The indices of sync samples, sorted in ascending order.
`final long[]`	`timestampsUs` Sample timestamps in microseconds.
`final Track`	`track` The track corresponding to this sample table.

Public constructors
`TrackSampleTable( Track track, long[] offsets, int[] sizes, int maximumSize, long[] timestampsUs, int[] flags, int[] syncSampleIndices, boolean hasOnlySyncSamples, long durationUs, int sampleCount )`

Public methods
`int`	`getIndexOfEarlierOrEqualSynchronizationSample(long timeUs)` Returns the sample index of the closest synchronization sample at or before the given timestamp, if one is available.
`int`	`getIndexOfLaterOrEqualSynchronizationSample(long timeUs)` Returns the sample index of the closest synchronization sample at or after the given timestamp, if one is available.
`boolean`	`hasSampleTableData()` Returns whether the per-sample mapping arrays (such as `offsets`, `sizes`, `timestampsUs`, and `flags`) are populated.

Public fields

durationUs

public final long durationUs

The duration of the track sample table in microseconds.

flags

public final int[] flags

Sample flags. Populated only if hasSampleTableData is true.

hasOnlySyncSamples

public final boolean hasOnlySyncSamples

Whether all samples in the track are sync samples.

maximumSize

public final int maximumSize

Maximum sample size in sizes.

offsets

public final long[] offsets

Sample offsets in bytes. Populated only if hasSampleTableData is true.

sampleCount

public final int sampleCount

Number of samples.

sizes

public final int[] sizes

Sample sizes in bytes. Populated only if hasSampleTableData is true.

syncSampleIndices

public final int[] syncSampleIndices

The indices of sync samples, sorted in ascending order. This array is only populated if hasOnlySyncSamples is false.

timestampsUs

public final long[] timestampsUs

Sample timestamps in microseconds. Populated only if hasSampleTableData is true.

track

public final Track track

The track corresponding to this sample table.

Public constructors

TrackSampleTable

public TrackSampleTable(
    Track track,
    long[] offsets,
    int[] sizes,
    int maximumSize,
    long[] timestampsUs,
    int[] flags,
    int[] syncSampleIndices,
    boolean hasOnlySyncSamples,
    long durationUs,
    int sampleCount
)

Public methods

getIndexOfEarlierOrEqualSynchronizationSample

public int getIndexOfEarlierOrEqualSynchronizationSample(long timeUs)

Returns the sample index of the closest synchronization sample at or before the given timestamp, if one is available.

Parameters
`long timeUs`	Timestamp adjacent to which to find a synchronization sample.

Returns
`int`	Index of the synchronization sample, or `INDEX_UNSET` if none.

getIndexOfLaterOrEqualSynchronizationSample

public int getIndexOfLaterOrEqualSynchronizationSample(long timeUs)

Returns the sample index of the closest synchronization sample at or after the given timestamp, if one is available.

Parameters
`long timeUs`	Timestamp adjacent to which to find a synchronization sample.

Returns
`int`	index Index of the synchronization sample, or `INDEX_UNSET` if none.

hasSampleTableData

public boolean hasSampleTableData()

Returns whether the per-sample mapping arrays (such as offsets, sizes, timestampsUs, and flags) are populated.

When FLAG_OMIT_TRACK_SAMPLE_TABLE is set, this returns false while sampleCount may still be greater than 0.