TimestampAdjuster

const val MODE_NO_OFFSET = 9223372036854775807: Long

A special firstSampleTimestampUs value indicating that presentation timestamps should not be offset. In this mode:

• getFirstSampleTimestampUs will always return TIME_UNSET.
• The only timestamp adjustment performed is to account for MPEG-2 TS timestamp rollover.

const val MODE_SHARED = 9223372036854775806: Long

A special firstSampleTimestampUs value indicating that the adjuster will be shared by multiple threads. In this mode:

• getFirstSampleTimestampUs will always return TIME_UNSET.
• Calling threads must call sharedInitializeOrWait prior to adjusting timestamps.

synchronized fun adjustSampleTimestamp(timeUs: Long): Long

Offsets a timestamp in microseconds.

synchronized fun adjustTsTimestamp(pts90Khz: Long): Long

Scales and offsets an MPEG-2 TS presentation timestamp considering wraparound.

When estimating the wraparound, the method assumes that this timestamp is close to the previous adjusted timestamp.

synchronized fun adjustTsTimestampGreaterThanPreviousTimestamp(pts90Khz: Long): Long

Scales and offsets an MPEG-2 TS presentation timestamp considering wraparound.

When estimating the wraparound, the method assumes that the timestamp is strictly greater than the previous adjusted timestamp.

synchronized fun getLastAdjustedTimestampUs(): Long

Returns the last adjusted timestamp, in microseconds. If no timestamps have been adjusted yet then the result of getFirstSampleTimestampUs is returned.

synchronized fun isInitialized(): Boolean

Returns whether the instance is initialized with a timestamp offset.

java-static fun ptsToUs(pts: Long): Long

Converts a 90 kHz clock timestamp to a timestamp in microseconds.

synchronized fun reset(firstSampleTimestampUs: Long): Unit

Resets the instance.

synchronized fun sharedInitializeOrWait(
    canInitialize: Boolean,
    nextSampleTimestampUs: Long,
    timeoutMs: Long
): Unit

For shared timestamp adjusters, performs necessary initialization actions for a caller.

• If the adjuster has already established a timestamp offset then this method is a no-op.
• If canInitialize is true and the adjuster has not yet established a timestamp offset, then the adjuster records the desired first sample timestamp for the calling thread and returns to allow the caller to proceed. If the timestamp offset has still not been established when the caller attempts to adjust its first timestamp, then the recorded timestamp is used to set it.
• If canInitialize is false and the adjuster has not yet established a timestamp offset, then the call blocks until the timestamp offset is set.

java-static fun usToNonWrappedPts(us: Long): Long

Converts a timestamp in microseconds to a 90 kHz clock timestamp.

Does not perform any wraparound. To get a 90 kHz timestamp suitable for use with MPEG-TS, use usToWrappedPts.

java-static fun usToWrappedPts(us: Long): Long

Converts a timestamp in microseconds to a 90 kHz clock timestamp, performing wraparound to keep the result within 33-bits.