MediaTimestamp2

public final class MediaTimestamp2
extends Object

java.lang.Object
   ↳ androidx.media2.MediaTimestamp2


An immutable object that represents the linear correlation between the media time and the system time. It contains the media clock rate, together with the media timestamp of an anchor frame and the system time when that frame was presented or is committed to be presented.

The phrase "present" means that audio/video produced on device is detectable by an external observer off device. The time is based on the implementation's best effort, using whatever knowledge is available to the system, but cannot account for any delay unknown to the implementation. The anchor frame could be any frame, including a just-rendered frame, or even a theoretical or in-between frame, based on the source of the MediaTimestamp. When the anchor frame is a just-rendered one, the media time stands for current position of the playback or recording.

Summary

Fields

public static final MediaTimestamp2 TIMESTAMP_UNKNOWN

An unknown media timestamp value

Public methods

boolean equals(Object obj)
long getAnchorMediaTimeUs()

Get the media time of the anchor in microseconds.

long getAnchorSystemNanoTime()

Get the system time corresponding to the media time in nanoseconds.

float getMediaClockRate()

Get the rate of the media clock in relation to the system time.

int hashCode()
String toString()

Inherited methods

Fields

TIMESTAMP_UNKNOWN

public static final MediaTimestamp2 TIMESTAMP_UNKNOWN

An unknown media timestamp value

Public methods

equals

public boolean equals (Object obj)

Parameters
obj Object

Returns
boolean

getAnchorMediaTimeUs

public long getAnchorMediaTimeUs ()

Get the media time of the anchor in microseconds.

Returns
long

getAnchorSystemNanoTime

public long getAnchorSystemNanoTime ()

Get the system time corresponding to the media time in nanoseconds.

Returns
long

getMediaClockRate

public float getMediaClockRate ()

Get the rate of the media clock in relation to the system time.

It is 1.0 if media clock advances in sync with the system clock; greater than 1.0 if media clock is faster than the system clock; less than 1.0 if media clock is slower than the system clock.

Returns
float

hashCode

public int hashCode ()

Returns
int

toString

public String toString ()

Returns
String