com.otaliastudios.transcoder.transcode

Class BaseTrackTranscoder

java.lang.Object

com.otaliastudios.transcoder.transcode.BaseTrackTranscoder

All Implemented Interfaces:

TrackTranscoder

Direct Known Subclasses:

AudioTrackTranscoder, VideoTrackTranscoder

public abstract class BaseTrackTranscoder
extends java.lang.Object
implements TrackTranscoder

A base implementation of TrackTranscoder that reads from MediaExtractor and does feeding and draining job.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseTrackTranscoder(DataSource dataSource, DataSink dataSink, TrackType trackType)

Method Summary

Modifier and Type	Method and Description
boolean	isFinished()
protected void	onCodecsStarted(android.media.MediaFormat inputFormat, android.media.MediaFormat outputFormat, android.media.MediaCodec decoder, android.media.MediaCodec encoder) Called when both codecs have been started with the given formats.
protected void	onConfigureDecoder(android.media.MediaFormat format, android.media.MediaCodec decoder) Wraps the configure operation on the decoder.
protected void	onConfigureEncoder(android.media.MediaFormat format, android.media.MediaCodec encoder) Wraps the configure operation on the encoder.
protected void	onDecoderOutputFormatChanged(android.media.MediaCodec decoder, android.media.MediaFormat format) Called when the decoder has defined its actual output format.
protected abstract void	onDrainDecoder(android.media.MediaCodec decoder, int bufferIndex, java.nio.ByteBuffer bufferData, long presentationTimeUs, boolean endOfStream) Called to drain the decoder.
protected void	onEncoderOutputFormatChanged(android.media.MediaCodec encoder, android.media.MediaFormat format) Called when the encoder has defined its actual output format.
protected abstract boolean	onFeedEncoder(android.media.MediaCodec encoder, MediaCodecBuffers encoderBuffers, long timeoutUs) Called to feed the encoder with processed data.
protected void	onStartDecoder(android.media.MediaFormat format, android.media.MediaCodec decoder) Wraps the start operation on the decoder.
protected void	onStartEncoder(android.media.MediaFormat format, android.media.MediaCodec encoder) Wraps the start operation on the encoder.
void	release()
void	setUp(android.media.MediaFormat desiredOutputFormat)
boolean	transcode(boolean forceInputEos) Perform transcoding if output is available in any step of it.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BaseTrackTranscoder

protected BaseTrackTranscoder(@NonNull
                              DataSource dataSource,
                              @NonNull
                              DataSink dataSink,
                              @NonNull
                              TrackType trackType)

Method Detail

setUp

public final void setUp(@NonNull
                        android.media.MediaFormat desiredOutputFormat)

Specified by:

setUp in interface TrackTranscoder

onConfigureEncoder

protected void onConfigureEncoder(@NonNull
                                  android.media.MediaFormat format,
                                  @NonNull
                                  android.media.MediaCodec encoder)

Wraps the configure operation on the encoder.

Parameters:

format - output format

encoder - encoder

onStartEncoder

@CallSuper
protected void onStartEncoder(@NonNull
                                         android.media.MediaFormat format,
                                         @NonNull
                                         android.media.MediaCodec encoder)

Wraps the start operation on the encoder.

Parameters:

format - output format

encoder - encoder

onConfigureDecoder

protected void onConfigureDecoder(@NonNull
                                  android.media.MediaFormat format,
                                  @NonNull
                                  android.media.MediaCodec decoder)

Wraps the configure operation on the decoder.

Parameters:

format - input format

decoder - decoder

onStartDecoder

@CallSuper
protected void onStartDecoder(@NonNull
                                         android.media.MediaFormat format,
                                         @NonNull
                                         android.media.MediaCodec decoder)

Wraps the start operation on the decoder.

Parameters:

format - input format

decoder - decoder

onCodecsStarted

protected void onCodecsStarted(@NonNull
                               android.media.MediaFormat inputFormat,
                               @NonNull
                               android.media.MediaFormat outputFormat,
                               @NonNull
                               android.media.MediaCodec decoder,
                               @NonNull
                               android.media.MediaCodec encoder)

Called when both codecs have been started with the given formats.

Parameters:

inputFormat - input format

outputFormat - output format

decoder - decoder

encoder - encoder

isFinished

public final boolean isFinished()

Specified by:

isFinished in interface TrackTranscoder

release

public void release()

Specified by:

release in interface TrackTranscoder

transcode

public final boolean transcode(boolean forceInputEos)

Description copied from interface: TrackTranscoder

Perform transcoding if output is available in any step of it. It assumes muxer has been started, so you should call muxer.start() first.

Specified by:

transcode in interface TrackTranscoder

Returns:

true if data moved in pipeline.

onDecoderOutputFormatChanged

@CallSuper
protected void onDecoderOutputFormatChanged(@NonNull
                                                       android.media.MediaCodec decoder,
                                                       @NonNull
                                                       android.media.MediaFormat format)

Called when the decoder has defined its actual output format.

Parameters:

format - format

onEncoderOutputFormatChanged

@CallSuper
protected void onEncoderOutputFormatChanged(@NonNull
                                                       android.media.MediaCodec encoder,
                                                       @NonNull
                                                       android.media.MediaFormat format)

Called when the encoder has defined its actual output format.

Parameters:

format - format

onDrainDecoder

protected abstract void onDrainDecoder(@NonNull
                                       android.media.MediaCodec decoder,
                                       int bufferIndex,
                                       @NonNull
                                       java.nio.ByteBuffer bufferData,
                                       long presentationTimeUs,
                                       boolean endOfStream)

Called to drain the decoder. Implementors are required to call MediaCodec.releaseOutputBuffer(int, boolean) with the given bufferIndex at some point.

Parameters:

decoder - the decoder

bufferIndex - the buffer index to be released

bufferData - the buffer data

presentationTimeUs - frame timestamp

endOfStream - whether we are in end of stream

onFeedEncoder

protected abstract boolean onFeedEncoder(@NonNull
                                         android.media.MediaCodec encoder,
                                         @NonNull
                                         MediaCodecBuffers encoderBuffers,
                                         long timeoutUs)

Called to feed the encoder with processed data.

Parameters:

encoder - the encoder

timeoutUs - a timeout for this op

Returns:

true if we want to keep working