Class ExportException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- com.google.android.exoplayer2.transformer.ExportException
-
- All Implemented Interfaces:
Serializable
@Deprecated public final class ExportException extends Exception
Deprecated.com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.Thrown when a non-locally recoverable export failure occurs.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
ExportException.ErrorCode
Deprecated.Error codes that identify causes ofTransformer
errors.
-
Field Summary
Fields Modifier and Type Field Description static int
ERROR_CODE_AUDIO_PROCESSING_FAILED
Deprecated.Caused by an audio processing failure.static int
ERROR_CODE_DECODER_INIT_FAILED
Deprecated.Caused by a decoder initialization failure.static int
ERROR_CODE_DECODING_FAILED
Deprecated.Caused by a failure while trying to decode media samples.static int
ERROR_CODE_DECODING_FORMAT_UNSUPPORTED
Deprecated.Caused by trying to decode content whose format is not supported.static int
ERROR_CODE_ENCODER_INIT_FAILED
Deprecated.Caused by an encoder initialization failure.static int
ERROR_CODE_ENCODING_FAILED
Deprecated.Caused by a failure while trying to encode media samples.static int
ERROR_CODE_ENCODING_FORMAT_UNSUPPORTED
Deprecated.Caused by trying to encode content whose format is not supported.static int
ERROR_CODE_FAILED_RUNTIME_CHECK
Deprecated.Caused by a failed runtime check.static int
ERROR_CODE_IO_BAD_HTTP_STATUS
Deprecated.Caused by an HTTP server returning an unexpected HTTP response status code.static int
ERROR_CODE_IO_CLEARTEXT_NOT_PERMITTED
Deprecated.Caused by theAssetLoader
trying to access cleartext HTTP traffic (meaning http:// rather than https://) when the app's Network Security Configuration does not permit it.static int
ERROR_CODE_IO_FILE_NOT_FOUND
Deprecated.Caused by a non-existent file.static int
ERROR_CODE_IO_INVALID_HTTP_CONTENT_TYPE
Deprecated.Caused by a server returning a resource with an invalid "Content-Type" HTTP header value.static int
ERROR_CODE_IO_NETWORK_CONNECTION_FAILED
Deprecated.Caused by a network connection failure.static int
ERROR_CODE_IO_NETWORK_CONNECTION_TIMEOUT
Deprecated.Caused by a network timeout, meaning the server is taking too long to fulfill a request.static int
ERROR_CODE_IO_NO_PERMISSION
Deprecated.Caused by lack of permission to perform an IO operation.static int
ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE
Deprecated.Caused by reading data out of the data bound.static int
ERROR_CODE_IO_UNSPECIFIED
Deprecated.Caused by an Input/Output error which could not be identified.static int
ERROR_CODE_MUXING_FAILED
Deprecated.Caused by a failure while muxing media samples.static int
ERROR_CODE_MUXING_TIMEOUT
Deprecated.Caused by a timeout while muxing media samples.static int
ERROR_CODE_UNSPECIFIED
Deprecated.Caused by an error whose cause could not be identified.static int
ERROR_CODE_VIDEO_FRAME_PROCESSING_FAILED
Deprecated.Caused by a video frame processing failure.@com.google.android.exoplayer2.transformer.ExportException.ErrorCode int
errorCode
Deprecated.An error code which identifies the cause of the export failure.long
timestampMs
Deprecated.The value ofSystemClock.elapsedRealtime()
when this exception was created.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description static ExportException
createForAssetLoader(Throwable cause, int errorCode)
Deprecated.Creates an instance for anAssetLoader
related exception.static ExportException
createForAudioProcessing(Throwable cause, AudioProcessor.AudioFormat audioFormat)
Deprecated.Creates an instance for an audio processing related exception.static ExportException
createForCodec(Throwable cause, @com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode, boolean isVideo, boolean isDecoder, Format format)
Deprecated.Creates an instance for aCodec
related exception.static ExportException
createForCodec(Throwable cause, @com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode, boolean isVideo, boolean isDecoder, String details)
Deprecated.Creates an instance for aCodec
related exception.static ExportException
createForUnexpected(Exception cause)
Deprecated.Creates an instance for an unexpected exception.boolean
errorInfoEquals(ExportException other)
Deprecated.Returns whether the error data associated to this exception equals the error data associated toother
.String
getErrorCodeName()
Deprecated.Equivalent toExportException.getErrorCodeName(this.errorCode)
.static String
getErrorCodeName(@com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode)
Deprecated.Returns the name of a givenerrorCode
.-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Field Detail
-
ERROR_CODE_UNSPECIFIED
public static final int ERROR_CODE_UNSPECIFIED
Deprecated.Caused by an error whose cause could not be identified.- See Also:
- Constant Field Values
-
ERROR_CODE_FAILED_RUNTIME_CHECK
public static final int ERROR_CODE_FAILED_RUNTIME_CHECK
Deprecated.Caused by a failed runtime check.This can happen when transformer reaches an invalid state.
- See Also:
- Constant Field Values
-
ERROR_CODE_IO_UNSPECIFIED
public static final int ERROR_CODE_IO_UNSPECIFIED
Deprecated.Caused by an Input/Output error which could not be identified.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_NETWORK_CONNECTION_FAILED
public static final int ERROR_CODE_IO_NETWORK_CONNECTION_FAILED
Deprecated.Caused by a network connection failure.The following is a non-exhaustive list of possible reasons:
- There is no network connectivity.
- The URL's domain is misspelled or does not exist.
- The target host is unreachable.
- The server unexpectedly closes the connection.
- See Also:
- Constant Field Values
-
ERROR_CODE_IO_NETWORK_CONNECTION_TIMEOUT
public static final int ERROR_CODE_IO_NETWORK_CONNECTION_TIMEOUT
Deprecated.Caused by a network timeout, meaning the server is taking too long to fulfill a request.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_INVALID_HTTP_CONTENT_TYPE
public static final int ERROR_CODE_IO_INVALID_HTTP_CONTENT_TYPE
Deprecated.Caused by a server returning a resource with an invalid "Content-Type" HTTP header value.For example, this can happen when the
AssetLoader
is expecting a piece of media, but the server returns a paywall HTML page, with content type "text/html".- See Also:
- Constant Field Values
-
ERROR_CODE_IO_BAD_HTTP_STATUS
public static final int ERROR_CODE_IO_BAD_HTTP_STATUS
Deprecated.Caused by an HTTP server returning an unexpected HTTP response status code.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_FILE_NOT_FOUND
public static final int ERROR_CODE_IO_FILE_NOT_FOUND
Deprecated.Caused by a non-existent file.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_NO_PERMISSION
public static final int ERROR_CODE_IO_NO_PERMISSION
Deprecated.Caused by lack of permission to perform an IO operation. For example, lack of permission to access internet or external storage.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_CLEARTEXT_NOT_PERMITTED
public static final int ERROR_CODE_IO_CLEARTEXT_NOT_PERMITTED
Deprecated.Caused by theAssetLoader
trying to access cleartext HTTP traffic (meaning http:// rather than https://) when the app's Network Security Configuration does not permit it.- See Also:
- Constant Field Values
-
ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE
public static final int ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE
Deprecated.Caused by reading data out of the data bound.- See Also:
- Constant Field Values
-
ERROR_CODE_DECODER_INIT_FAILED
public static final int ERROR_CODE_DECODER_INIT_FAILED
Deprecated.Caused by a decoder initialization failure.- See Also:
- Constant Field Values
-
ERROR_CODE_DECODING_FAILED
public static final int ERROR_CODE_DECODING_FAILED
Deprecated.Caused by a failure while trying to decode media samples.- See Also:
- Constant Field Values
-
ERROR_CODE_DECODING_FORMAT_UNSUPPORTED
public static final int ERROR_CODE_DECODING_FORMAT_UNSUPPORTED
Deprecated.Caused by trying to decode content whose format is not supported.- See Also:
- Constant Field Values
-
ERROR_CODE_ENCODER_INIT_FAILED
public static final int ERROR_CODE_ENCODER_INIT_FAILED
Deprecated.Caused by an encoder initialization failure.- See Also:
- Constant Field Values
-
ERROR_CODE_ENCODING_FAILED
public static final int ERROR_CODE_ENCODING_FAILED
Deprecated.Caused by a failure while trying to encode media samples.- See Also:
- Constant Field Values
-
ERROR_CODE_ENCODING_FORMAT_UNSUPPORTED
public static final int ERROR_CODE_ENCODING_FORMAT_UNSUPPORTED
Deprecated.Caused by trying to encode content whose format is not supported. *Supported output formats are limited by the encoders available.
- See Also:
- Constant Field Values
-
ERROR_CODE_VIDEO_FRAME_PROCESSING_FAILED
public static final int ERROR_CODE_VIDEO_FRAME_PROCESSING_FAILED
Deprecated.Caused by a video frame processing failure.- See Also:
- Constant Field Values
-
ERROR_CODE_AUDIO_PROCESSING_FAILED
public static final int ERROR_CODE_AUDIO_PROCESSING_FAILED
Deprecated.Caused by an audio processing failure.- See Also:
- Constant Field Values
-
ERROR_CODE_MUXING_FAILED
public static final int ERROR_CODE_MUXING_FAILED
Deprecated.Caused by a failure while muxing media samples.- See Also:
- Constant Field Values
-
ERROR_CODE_MUXING_TIMEOUT
public static final int ERROR_CODE_MUXING_TIMEOUT
Deprecated.Caused by a timeout while muxing media samples.
-
errorCode
public final @com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode
Deprecated.An error code which identifies the cause of the export failure.
-
timestampMs
public final long timestampMs
Deprecated.The value ofSystemClock.elapsedRealtime()
when this exception was created.
-
-
Method Detail
-
getErrorCodeName
public static String getErrorCodeName(@com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode)
Deprecated.Returns the name of a givenerrorCode
.
-
getErrorCodeName
public String getErrorCodeName()
Deprecated.Equivalent toExportException.getErrorCodeName(this.errorCode)
.
-
createForAssetLoader
public static ExportException createForAssetLoader(Throwable cause, int errorCode)
Deprecated.Creates an instance for anAssetLoader
related exception.- Parameters:
cause
- The cause of the failure.errorCode
- SeeerrorCode
.- Returns:
- The created instance.
-
createForCodec
public static ExportException createForCodec(Throwable cause, @com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode, boolean isVideo, boolean isDecoder, Format format)
Deprecated.
-
createForCodec
public static ExportException createForCodec(Throwable cause, @com.google.android.exoplayer2.transformer.ExportException.ErrorCode int errorCode, boolean isVideo, boolean isDecoder, String details)
Deprecated.Creates an instance for aCodec
related exception.
-
createForAudioProcessing
public static ExportException createForAudioProcessing(Throwable cause, AudioProcessor.AudioFormat audioFormat)
Deprecated.Creates an instance for an audio processing related exception.- Parameters:
cause
- The cause of the failure.audioFormat
- TheAudioProcessor.AudioFormat
used.- Returns:
- The created instance.
-
createForUnexpected
public static ExportException createForUnexpected(Exception cause)
Deprecated.Creates an instance for an unexpected exception.If the exception is a runtime exception, error code
ERROR_CODE_FAILED_RUNTIME_CHECK
is used. Otherwise, the created instance has error codeERROR_CODE_UNSPECIFIED
.- Parameters:
cause
- The cause of the failure.- Returns:
- The created instance.
-
errorInfoEquals
public boolean errorInfoEquals(@Nullable ExportException other)
Deprecated.Returns whether the error data associated to this exception equals the error data associated toother
.Note that this method does not compare the exceptions' stack traces.
-
-