VideoFrameProcessingException

Kotlin |Java

@UnstableApi
public final class VideoFrameProcessingException extends Exception

java.lang.Object
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	androidx.media3.common.VideoFrameProcessingException

Thrown when an exception occurs while preparing an Effect, or applying an Effect to video frames.

Summary

Public fields
`final long`	`presentationTimeUs` The microsecond timestamp of the frame being processed while the exception occurred or `TIME_UNSET` if unknown.

Public constructors
`VideoFrameProcessingException(Throwable cause)` Creates an instance.
`VideoFrameProcessingException(String message)` Creates an instance.
`VideoFrameProcessingException(Throwable cause, long presentationTimeUs)` Creates an instance.
`VideoFrameProcessingException(String message, Throwable cause)` Creates an instance.
`VideoFrameProcessingException(String message, long presentationTimeUs)` Creates an instance.
`VideoFrameProcessingException( String message, Throwable cause, long presentationTimeUs )` Creates an instance.

Public methods
`static VideoFrameProcessingException`	`from(Exception exception)` Wraps the given exception in a `VideoFrameProcessingException` if it is not already a `VideoFrameProcessingException` and returns the exception otherwise.
`static VideoFrameProcessingException`	`from(Exception exception, long presentationTimeUs)` Wraps the given exception in a `VideoFrameProcessingException` with the given timestamp if it is not already a `VideoFrameProcessingException` and returns the exception otherwise.

Inherited methods

From java.lang.Throwable

`synchronized final void`	`addSuppressed(Throwable exception)`
`synchronized Throwable`	`fillInStackTrace()`
`synchronized Throwable`	`getCause()`
`String`	`getLocalizedMessage()`
`String`	`getMessage()`
`StackTraceElement[]`	`getStackTrace()`
`synchronized final Throwable[]`	`getSuppressed()`
`synchronized Throwable`	`initCause(Throwable cause)`
`void`	`printStackTrace()`
`void`	`setStackTrace(StackTraceElement[] stackTrace)`
`String`	`toString()`

Public fields

presentationTimeUs

public final long presentationTimeUs

The microsecond timestamp of the frame being processed while the exception occurred or TIME_UNSET if unknown.

Public constructors

VideoFrameProcessingException

public VideoFrameProcessingException(Throwable cause)

Creates an instance.

Parameters
`Throwable cause`	The cause of this exception.

VideoFrameProcessingException

public VideoFrameProcessingException(String message)

Creates an instance.

Parameters
`String message`	The detail message for this exception.

VideoFrameProcessingException

public VideoFrameProcessingException(Throwable cause, long presentationTimeUs)

Creates an instance.

Parameters
`Throwable cause`	The cause of this exception.
`long presentationTimeUs`	The timestamp of the frame for which the exception occurred.

VideoFrameProcessingException

public VideoFrameProcessingException(String message, Throwable cause)

Creates an instance.

Parameters
`String message`	The detail message for this exception.
`Throwable cause`	The cause of this exception.

VideoFrameProcessingException

public VideoFrameProcessingException(String message, long presentationTimeUs)

Creates an instance.

Parameters
`String message`	The detail message for this exception.
`long presentationTimeUs`	The timestamp of the frame for which the exception occurred.

VideoFrameProcessingException

public VideoFrameProcessingException(
    String message,
    Throwable cause,
    long presentationTimeUs
)

Creates an instance.

Parameters
`String message`	The detail message for this exception.
`Throwable cause`	The cause of this exception.
`long presentationTimeUs`	The timestamp of the frame for which the exception occurred.

Public methods

from

public static VideoFrameProcessingException from(Exception exception)

Wraps the given exception in a VideoFrameProcessingException if it is not already a VideoFrameProcessingException and returns the exception otherwise.

from

public static VideoFrameProcessingException from(Exception exception, long presentationTimeUs)

Wraps the given exception in a VideoFrameProcessingException with the given timestamp if it is not already a VideoFrameProcessingException and returns the exception otherwise.