com.google.android.exoplayer2.video

Class VideoFrameReleaseTimeHelper

java.lang.Object

com.google.android.exoplayer2.video.VideoFrameReleaseTimeHelper

public final class VideoFrameReleaseTimeHelper
extends java.lang.Object

Makes a best effort to adjust frame release timestamps for a smoother visual result.

Constructor Summary

Constructors

Constructor and Description
VideoFrameReleaseTimeHelper() Constructs an instance that smooths frame release timestamps but does not align them with the default display's vsync signal.
VideoFrameReleaseTimeHelper(android.content.Context context) Constructs an instance that smooths frame release timestamps and aligns them with the default display's vsync signal.

Method Summary

Modifier and Type	Method and Description
long	adjustReleaseTime(long framePresentationTimeUs, long unadjustedReleaseTimeNs) Adjusts a frame release timestamp.
void	disable() Disables the helper.
void	enable() Enables the helper.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VideoFrameReleaseTimeHelper

public VideoFrameReleaseTimeHelper()

Constructs an instance that smooths frame release timestamps but does not align them with the default display's vsync signal.

VideoFrameReleaseTimeHelper

public VideoFrameReleaseTimeHelper(@Nullable
                                   android.content.Context context)

Constructs an instance that smooths frame release timestamps and aligns them with the default display's vsync signal.

Parameters:

context - A context from which information about the default display can be retrieved.

Method Detail

enable

public void enable()

Enables the helper. Must be called from the playback thread.

disable

public void disable()

Disables the helper. Must be called from the playback thread.

adjustReleaseTime

public long adjustReleaseTime(long framePresentationTimeUs,
                              long unadjustedReleaseTimeNs)

Adjusts a frame release timestamp. Must be called from the playback thread.

Parameters:

framePresentationTimeUs - The frame's presentation time, in microseconds.

unadjustedReleaseTimeNs - The frame's unadjusted release time, in nanoseconds and in the same time base as System.nanoTime().

Returns:

The adjusted frame release timestamp, in nanoseconds and in the same time base as System.nanoTime().