VideoFrameProcessorTestRunner

Artifact: androidx.media3:media3-test-utils

View Source

---

Kotlin |Java

@UnstableApi
public final class VideoFrameProcessorTestRunner

---

A test runner for VideoFrameProcessor tests.

Summary

Nested types
public interface VideoFrameProcessorTestRunner.BitmapReader Reads a Bitmap from VideoFrameProcessor output.
public final class VideoFrameProcessorTestRunner.Builder A builder for VideoFrameProcessorTestRunner instances.
public interface VideoFrameProcessorTestRunner.OnOutputFrameAvailableForRenderingListener
public interface VideoFrameProcessorTestRunner.OnVideoFrameProcessingEndedListener
public final class VideoFrameProcessorTestRunner.SurfaceBitmapReader implements VideoFrameProcessorTestRunner.BitmapReader Reads from a Surface.

Constants
static final int	VIDEO_FRAME_PROCESSING_WAIT_MS = 5000 Time to wait for the decoded frame to populate the VideoFrameProcessor instance's input surface and the VideoFrameProcessor to finish processing the frame, in milliseconds.

Public methods
void	awaitFrameProcessingEnd(long videoFrameProcessingWaitMs) After signalEndOfInput, is called, wait for this instance to end.
static TimestampIterator	createTimestampIterator(List<Long> elements)
void	endFrameProcessing() endFrameProcessing with VIDEO_FRAME_PROCESSING_WAIT_MS applied.
void	endFrameProcessing(long videoFrameProcessingWaitMs) Ends VideoFrameProcessor frame processing.
void	flush() Calls flush.
Bitmap	getOutputBitmap() Returns the Bitmap from the provided BitmapReader.
void	processFirstFrameAndEnd()
void	queueInputBitmap(     Bitmap inputBitmap,     long durationUs,     long offsetToAddUs,     float frameRate )
void	queueInputBitmap(     Bitmap inputBitmap,     long durationUs,     long offsetToAddUs,     float frameRate,     ColorInfo colorInfo )
void	queueInputBitmaps(int width, int height, Pair[] frames)
void	queueInputBitmaps(     int width,     int height,     ColorInfo colorInfo,     Pair[] frames )
void	queueInputTexture(     GlTextureInfo inputTexture,     long pts,     ColorInfo colorInfo )
void	release()
void	signalEndOfInput() Calls signalEndOfInput.

Constants

VIDEO_FRAME_PROCESSING_WAIT_MS

public static final int VIDEO_FRAME_PROCESSING_WAIT_MS = 5000

Time to wait for the decoded frame to populate the VideoFrameProcessor instance's input surface and the VideoFrameProcessor to finish processing the frame, in milliseconds.

Public methods

awaitFrameProcessingEnd

public void awaitFrameProcessingEnd(long videoFrameProcessingWaitMs)

After signalEndOfInput, is called, wait for this instance to end.

Throws
java.lang.Exception

createTimestampIterator

public static TimestampIterator createTimestampIterator(List<Long> elements)

endFrameProcessing

public void endFrameProcessing()

endFrameProcessing with VIDEO_FRAME_PROCESSING_WAIT_MS applied.

Throws
java.lang.Exception

endFrameProcessing

public void endFrameProcessing(long videoFrameProcessingWaitMs)

Ends VideoFrameProcessor frame processing.

Waits for frame processing to end, for videoFrameProcessingWaitMs.

Throws
java.lang.Exception

flush

public void flush()

Calls flush.

getOutputBitmap

public Bitmap getOutputBitmap()

Returns the Bitmap from the provided BitmapReader.

Also saves the bitmap to the cache directory.

processFirstFrameAndEnd

public void processFirstFrameAndEnd()

Throws
java.lang.Exception

queueInputBitmap

public void queueInputBitmap(
    Bitmap inputBitmap,
    long durationUs,
    long offsetToAddUs,
    float frameRate
)

Throws
androidx.media3.common.VideoFrameProcessingException

queueInputBitmap

public void queueInputBitmap(
    Bitmap inputBitmap,
    long durationUs,
    long offsetToAddUs,
    float frameRate,
    ColorInfo colorInfo
)

Throws
androidx.media3.common.VideoFrameProcessingException

queueInputBitmaps

public void queueInputBitmaps(int width, int height, Pair[] frames)

Throws
androidx.media3.common.VideoFrameProcessingException

queueInputBitmaps

public void queueInputBitmaps(
    int width,
    int height,
    ColorInfo colorInfo,
    Pair[] frames
)

Throws
androidx.media3.common.VideoFrameProcessingException

queueInputTexture

public void queueInputTexture(
    GlTextureInfo inputTexture,
    long pts,
    ColorInfo colorInfo
)

Throws
androidx.media3.common.VideoFrameProcessingException

release

public void release()

signalEndOfInput

public void signalEndOfInput()

Calls signalEndOfInput.

Calling this and awaitFrameProcessingEnd is an alternative to endFrameProcessing.