DataSourceException

Kotlin |Java

class DataSourceException : IOException

kotlin.Any
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	java.io.IOException
			↳	androidx.media3.datasource.DataSourceException

Known direct subclasses

`AssetDataSource.AssetDataSourceException`	Thrown when an `IOException` is encountered reading a local asset.
`ContentDataSource.ContentDataSourceException`	Thrown when an `IOException` is encountered reading from a content URI.
`FileDataSource.FileDataSourceException`	Thrown when a `FileDataSource` encounters an error reading a file.
`HttpDataSource.HttpDataSourceException`	Thrown when an error is encountered when trying to read from a `HttpDataSource`.
`RawResourceDataSource.RawResourceDataSourceException`	Thrown when an `IOException` is encountered reading from a raw resource.
`UdpDataSource.UdpDataSourceException`	Thrown when an error is encountered when trying to read from a `UdpDataSource`.

Known indirect subclasses

`CronetDataSource.OpenException`	Thrown when an error is encountered when trying to open a `CronetDataSource`.
`HttpDataSource.CleartextNotPermittedException`	Thrown when cleartext HTTP traffic is not permitted.
`HttpDataSource.InvalidContentTypeException`	Thrown when the content type is invalid.
`HttpDataSource.InvalidResponseCodeException`	Thrown when an attempt to open a connection results in a response code not in the 2xx range.
`HttpEngineDataSource.OpenException`	Thrown when an error is encountered when trying to open a `HttpEngineDataSource`.

Used to specify reason of a DataSource error.

Summary

Constants
`const Int`	`@UnstableApi POSITION_OUT_OF_RANGE = 2008` This property is deprecated. Use `ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE`.

const Int

@UnstableApi
POSITION_OUT_OF_RANGE = 2008

This property is deprecated.

Use ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE.

Public constructors
`@UnstableApi DataSourceException(@PlaybackException.ErrorCode reason: Int)` Constructs a DataSourceException.
`@UnstableApi DataSourceException( cause: Throwable?, @PlaybackException.ErrorCode reason: Int )` Constructs a DataSourceException.
`@UnstableApi DataSourceException( message: String?, @PlaybackException.ErrorCode reason: Int )` Constructs a DataSourceException.
`@UnstableApi DataSourceException( message: String?, cause: Throwable?, @PlaybackException.ErrorCode reason: Int )` Constructs a DataSourceException.

Public functions
`java-static Boolean`	`@UnstableApi isCausedByPositionOutOfRange(e: IOException!)` Returns whether the given `IOException` was caused by a `DataSourceException` whose `reason` is `ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE` in its cause stack.

Public properties
`Int`	`@PlaybackException.ErrorCode reason` The reason of this `DataSourceException`, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

From java.lang.Throwable

`synchronized Unit`	`addSuppressed(exception: Throwable!)`
`synchronized Throwable!`	`fillInStackTrace()`
`synchronized Throwable!`	`getCause()`
`String!`	`getLocalizedMessage()`
`String!`	`getMessage()`
`Array<StackTraceElement!>!`	`getStackTrace()`
`synchronized Array<Throwable!>!`	`getSuppressed()`
`synchronized Throwable!`	`initCause(cause: Throwable!)`
`Unit`	`printStackTrace()`
`Unit`	`setStackTrace(stackTrace: Array<StackTraceElement!>!)`
`String!`	`toString()`

@UnstableApi
const val POSITION_OUT_OF_RANGE = 2008: Int

Indicates that the starting position of the request was outside the bounds of the data.

@UnstableApi
DataSourceException(@PlaybackException.ErrorCode reason: Int)

Constructs a DataSourceException.

Parameters
`@PlaybackException.ErrorCode reason: Int`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
DataSourceException(
    cause: Throwable?,
    @PlaybackException.ErrorCode reason: Int
)

Constructs a DataSourceException.

Parameters
`cause: Throwable?`	The error cause.
`@PlaybackException.ErrorCode reason: Int`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
DataSourceException(
    message: String?,
    @PlaybackException.ErrorCode reason: Int
)

Constructs a DataSourceException.

Parameters
`message: String?`	The error message.
`@PlaybackException.ErrorCode reason: Int`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
DataSourceException(
    message: String?,
    cause: Throwable?,
    @PlaybackException.ErrorCode reason: Int
)

Constructs a DataSourceException.

Parameters
`message: String?`	The error message.
`cause: Throwable?`	The error cause.
`@PlaybackException.ErrorCode reason: Int`	Reason of the error, should be one of the `ERROR_CODE_IO_*` in `PlaybackException.ErrorCode`.

@UnstableApi
java-static fun isCausedByPositionOutOfRange(e: IOException!): Boolean

Returns whether the given IOException was caused by a DataSourceException whose reason is ERROR_CODE_IO_READ_POSITION_OUT_OF_RANGE in its cause stack.

@PlaybackException.ErrorCode
val reason: Int

The reason of this DataSourceException, should be one of the ERROR_CODE_IO_* in PlaybackException.ErrorCode.