DataSource (lib 0.9.1 API)

All Known Implementing Classes:

BlankAudioDataSource, ClipDataSource, DataSourceWrapper, DefaultDataSource, FileDescriptorDataSource, FilePathDataSource, TrimDataSource, UriDataSource
```
public interface DataSource
```
Represents the source of input data.

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static class DataSource.Chunk
Represents a chunk of data.

Nested Classes
Modifier and Type	Interface and Description
`static class`	`DataSource.Chunk` Represents a chunk of data.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`boolean`	`canReadTrack(TrackType type)` Returns true if we can read the given track at this point.
`long`	`getDurationUs()` Returns the video total duration in microseconds.
`double[]`	`getLocation()` Metadata information.
`int`	`getOrientation()` Metadata information.
`long`	`getReadUs()` Returns the total number of microseconds that have been read until now.
`android.media.MediaFormat`	`getTrackFormat(TrackType type)` Called before starting to inspect the input format for this track.
`boolean`	`isDrained()` When this source has been totally read, it can return true here to notify an end of input stream.
`void`	`readTrack(DataSource.Chunk chunk)` Called to read contents for the current track type.
`void`	`releaseTrack(TrackType type)` Called to release resources for a given track.
`void`	`rewind()` Rewinds this source, moving it to its default state.
`long`	`seekTo(long desiredTimestampUs)` Moves all selected tracks to the specified presentation time.
`void`	`selectTrack(TrackType type)` Called before starting, but after `getTrackFormat(TrackType)`, to select the given track.

- Method Detail
  - getOrientation
```
int getOrientation()
```
    Metadata information. Returns the video orientation, or 0.
    
    Returns:
    
    video metadata orientation
  - getLocation
```
@Nullable
double[] getLocation()
```
    Metadata information. Returns the video location, or null.
    
    Returns:
    
    video location or null
  - getDurationUs
```
long getDurationUs()
```
    Returns the video total duration in microseconds.
    
    Returns:
    
    duration in us
  - getTrackFormat
```
@Nullable
android.media.MediaFormat getTrackFormat(@NonNull
                                                   TrackType type)
```
    Called before starting to inspect the input format for this track. Can return null if this media does not include this track type.
    
    Parameters:
    
    type - track type
    
    Returns:
    
    format or null
  - selectTrack
```
void selectTrack(@NonNull
                 TrackType type)
```
    Called before starting, but after getTrackFormat(TrackType), to select the given track.
    
    Parameters:
    
    type - track type
  - seekTo
```
long seekTo(long desiredTimestampUs)
```
    Moves all selected tracks to the specified presentation time. The timestamp should be between 0 and getDurationUs(). The actual timestamp might differ from the desired one because of seeking constraints (e.g. seek to sync frames).
    
    Parameters:
    
    desiredTimestampUs - requested timestamp
    
    Returns:
    
    actual timestamp
  - canReadTrack
```
boolean canReadTrack(@NonNull
                     TrackType type)
```
    Returns true if we can read the given track at this point. If true if returned, source should expect a readTrack(Chunk) call.
    
    Parameters:
    
    type - track type
    
    Returns:
    
    true if we can read this track now
  - readTrack
```
void readTrack(@NonNull
               DataSource.Chunk chunk)
```
    Called to read contents for the current track type. Contents should be put inside DataSource.Chunk.buffer, and the other chunk flags should be filled.
    
    Parameters:
    
    chunk - output chunk
  - getReadUs
```
long getReadUs()
```
    Returns the total number of microseconds that have been read until now.
    
    Returns:
    
    total read us
  - isDrained
```
boolean isDrained()
```
    When this source has been totally read, it can return true here to notify an end of input stream.
    
    Returns:
    
    true if drained
  - releaseTrack
```
void releaseTrack(@NonNull
                  TrackType type)
```
    Called to release resources for a given track.
    
    Parameters:
    
    type - track type
  - rewind
```
void rewind()
```
    Rewinds this source, moving it to its default state. To be used again, tracks will be selected again. After this call, for instance, - getReadUs() should be 0 - isDrained() should be false - readTrack(Chunk) should return the very first bytes

Interface DataSource

Nested Class Summary

Method Summary

Method Detail

getOrientation

getLocation

getDurationUs

getTrackFormat

selectTrack

seekTo

canReadTrack

readTrack

getReadUs

isDrained

releaseTrack

rewind