BaseDataSource

Kotlin |Java

@UnstableApi
abstract class BaseDataSource : DataSource

Known direct subclasses

`AssetDataSource`	A `DataSource` for reading from a local asset.
`ByteArrayDataSource`	A `DataSource` for reading from a byte array.
`ContentDataSource`	A `DataSource` for reading from a content URI.
`CronetDataSource`	DataSource without intermediate buffer based on Cronet API set using UrlRequest.
`DataSchemeDataSource`	A `DataSource` for reading data URLs, as defined by RFC 2397.
`DefaultHttpDataSource`	An `HttpDataSource` that uses Android's `HttpURLConnection`.
`FakeDataSource`	A fake `DataSource` capable of simulating various scenarios.
`FileDataSource`	A `DataSource` for reading local files.
`FileDescriptorDataSource`	A `DataSource` for reading from a `FileDescriptor`.
`HttpEngineDataSource`	DataSource without intermediate buffer based on `HttpEngine` set using `UrlRequest`.
`MediaDataSourceAdapter`	A `DataSource` for reading from a `MediaDataSource`.
`OkHttpDataSource`	An `HttpDataSource` that delegates to Square's `Call.Factory`.
`RawResourceDataSource`	A `DataSource` for reading a raw resource.
`RtmpDataSource`	A Real-Time Messaging Protocol (RTMP) `DataSource`.
`UdpDataSource`	A UDP `DataSource`.

Base DataSource implementation to keep a list of TransferListeners.

Subclasses must call transferInitializing, transferStarted, bytesTransferred, and transferEnded to inform listeners of data transfers.

Summary

Protected constructors
`BaseDataSource(isNetwork: Boolean)` Creates base data source.

Public functions
`Unit`	`@UnstableApi addTransferListener(transferListener: TransferListener!)` Adds a `TransferListener` to listen to data transfers.

Protected functions
`Unit`	`bytesTransferred(bytesTransferred: Int)` Notifies listeners that bytes were transferred.
`Unit`	`transferEnded()` Notifies listeners that a transfer ended.
`Unit`	`transferInitializing(dataSpec: DataSpec!)` Notifies listeners that data transfer for the specified `DataSpec` is being initialized.
`Unit`	`transferStarted(dataSpec: DataSpec!)` Notifies listeners that data transfer for the specified `DataSpec` started.

abstract Int

read(buffer: ByteArray!, offset: Int, length: Int)

Reads up to length bytes of data from the input.

`abstract Unit`	`@UnstableApi close()` Closes the source.
`(Mutable)Map<String!, (Mutable)List<String!>!>!`	`@UnstableApi getResponseHeaders()` When the source is open, returns the response headers associated with the last `open` call.
`abstract Uri?`	`@UnstableApi getUri()` When the source is open, returns the `Uri` from which data is being read.
`abstract Long`	`@UnstableApi open(dataSpec: DataSpec!)` Opens the source to read the specified data.

protected BaseDataSource(isNetwork: Boolean)

Creates base data source.

Parameters
`isNetwork: Boolean`	Whether the data source loads data through a network.

@UnstableApi
fun addTransferListener(transferListener: TransferListener!): Unit

Adds a TransferListener to listen to data transfers. This method is not thread-safe.

Parameters
`transferListener: TransferListener!`	A `TransferListener`.

protected fun bytesTransferred(bytesTransferred: Int): Unit

Notifies listeners that bytes were transferred.

Parameters
`bytesTransferred: Int`	The number of bytes transferred since the previous call to this method (or if the first call, since the transfer was started).

protected fun transferEnded(): Unit

Notifies listeners that a transfer ended.

protected fun transferInitializing(dataSpec: DataSpec!): Unit

Notifies listeners that data transfer for the specified DataSpec is being initialized.

Parameters
`dataSpec: DataSpec!`	`DataSpec` describing the data for initializing transfer.

protected fun transferStarted(dataSpec: DataSpec!): Unit

Notifies listeners that data transfer for the specified DataSpec started.

Parameters
`dataSpec: DataSpec!`	`DataSpec` describing the data being transferred.