com.otaliastudios.transcoder.sink

Interface DataSink

All Known Implementing Classes:

DefaultDataSink, MultiDataSink

public interface DataSink

A DataSink is an abstract representation of an encoded data collector. Currently the only implementation is DefaultDataSink which collects data into a File using MediaMuxer. However there might be other implementations in the future, for example to stream data to a server.

Method Summary

Modifier and Type	Method and Description
void	release() Called to release resources.
void	setLocation(double latitude, double longitude) Called before starting to set the location metadata.
void	setOrientation(int orientation) Called before starting to set the orientation metadata.
void	setTrackFormat(TrackType type, android.media.MediaFormat format) Called by TrackTranscoders when they have an output format.
void	setTrackStatus(TrackType type, TrackStatus status) Called before starting to set the status for the given track.
void	stop() Called when transcoders have stopped writing.
void	writeTrack(TrackType type, java.nio.ByteBuffer byteBuffer, android.media.MediaCodec.BufferInfo bufferInfo) Called by TrackTranscoders to write data into this sink.

Method Detail

setOrientation

void setOrientation(int orientation)

Called before starting to set the orientation metadata.

Parameters:

orientation - 0, 90, 180 or 270

setLocation

void setLocation(double latitude,
                 double longitude)

Called before starting to set the location metadata.

Parameters:

latitude - latitude

longitude - longitude

setTrackStatus

void setTrackStatus(@NonNull
                    TrackType type,
                    @NonNull
                    TrackStatus status)

Called before starting to set the status for the given track. The sink object can check if the track is transcoding using TrackStatus.isTranscoding().

Parameters:

type - track type

status - status

setTrackFormat

void setTrackFormat(@NonNull
                    TrackType type,
                    @NonNull
                    android.media.MediaFormat format)

Called by TrackTranscoders when they have an output format. This is not the output format chosen by the library user but rather the output format determined by MediaCodec, which contains more information, and should be inspected to know what kind of data we're collecting.

Parameters:

type - the track type

format - the track format

writeTrack

void writeTrack(@NonNull
                TrackType type,
                @NonNull
                java.nio.ByteBuffer byteBuffer,
                @NonNull
                android.media.MediaCodec.BufferInfo bufferInfo)

Called by TrackTranscoders to write data into this sink.

Parameters:

type - the track type

byteBuffer - the data

bufferInfo - the metadata

stop

void stop()

Called when transcoders have stopped writing.

release

void release()

Called to release resources. Any exception should probably be caught here.