MediaDataSource

Class Overview

For supplying media data to the framework. Implement this if your app has special requirements for the way media data is obtained.

Methods of this interface may be called on multiple different threads. There will be a thread synchronization point between each call to ensure that modifications to the state of your MediaDataSource are visible to future calls. This means you don't need to do your own synchronization unless you're modifying the MediaDataSource from another thread while it's being used by the framework.

Summary

Public Constructors
	MediaDataSource()

Public Constructors

MediaDataSource()

Public Methods
abstract long	getSize() Called to get the size of the data source.
abstract int	readAt(long position, byte[] buffer, int offset, int size) Called to request data from the given position.

Public Methods

abstract long

getSize()

Called to get the size of the data source.

abstract int

readAt(long position, byte[] buffer, int offset, int size)

Called to request data from the given position.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

From interface java.io.Closeable

From interface java.lang.AutoCloseable

Public Methods

public abstract long getSize ()

Added in API level 23

Called to get the size of the data source.

Returns

the size of data source in bytes, or -1 if the size is unknown.

Throws

IOException	on fatal errors

public abstract int readAt (long position, byte[] buffer, int offset, int size)

Added in API level 23

Called to request data from the given position. Implementations should should write up to size bytes into buffer, and return the number of bytes written. Return 0 if size is zero (thus no bytes are read). Return -1 to indicate that end of stream is reached.

Parameters

position	the position in the data source to read from.
buffer	the buffer to read the data into.
offset	the offset within buffer to read the data into.
size	the number of bytes to read.

Returns

the number of bytes read, or -1 if there was an error.

Throws

IOException	on fatal errors.

Results

Interfaces

Classes

Exceptions

Class Overview

Summary

Public Constructors

public MediaDataSource ()

Public Methods

public abstract long getSize ()

Returns

Throws

public abstract int readAt (long position, byte[] buffer, int offset, int size)

Parameters

Returns

Throws

java.lang.Object
↳	android.media.MediaDataSource