com.otaliastudios.transcoder

Class TranscoderOptions.Builder

java.lang.Object

com.otaliastudios.transcoder.TranscoderOptions.Builder

Enclosing class:

TranscoderOptions

public static class TranscoderOptions.Builder
extends java.lang.Object

Method Summary

Modifier and Type	Method and Description
TranscoderOptions.Builder	addDataSource(android.content.Context context, android.net.Uri uri)
TranscoderOptions.Builder	addDataSource(DataSource dataSource)
TranscoderOptions.Builder	addDataSource(java.io.FileDescriptor fileDescriptor)
TranscoderOptions.Builder	addDataSource(java.lang.String inPath)
TranscoderOptions.Builder	addDataSource(TrackType type, android.content.Context context, android.net.Uri uri)
TranscoderOptions.Builder	addDataSource(TrackType type, DataSource dataSource)
TranscoderOptions.Builder	addDataSource(TrackType type, java.io.FileDescriptor fileDescriptor)
TranscoderOptions.Builder	addDataSource(TrackType type, java.lang.String inPath)
TranscoderOptions	build()
TranscoderOptions.Builder	setAudioResampler(AudioResampler audioResampler) Sets an AudioResampler to change the sample rate of audio frames when sample rate conversion is needed.
TranscoderOptions.Builder	setAudioStretcher(AudioStretcher audioStretcher) Sets an AudioStretcher to perform stretching of audio samples as a consequence of speed and time interpolator changes.
TranscoderOptions.Builder	setAudioTrackStrategy(TrackStrategy trackStrategy) Sets the audio output strategy.
TranscoderOptions.Builder	setListener(TranscoderListener listener)
TranscoderOptions.Builder	setListenerHandler(android.os.Handler listenerHandler) Sets an handler for TranscoderListener callbacks.
TranscoderOptions.Builder	setSpeed(float speedFactor) Shorthand for calling setTimeInterpolator(TimeInterpolator) and passing a SpeedTimeInterpolator.
TranscoderOptions.Builder	setTimeInterpolator(TimeInterpolator timeInterpolator) Sets a TimeInterpolator to change the frames timestamps - either video or audio or both - before they are written into the output file.
TranscoderOptions.Builder	setValidator(Validator validator) Sets a validator to understand whether the transcoding process should stop before being started, based on the tracks status.
TranscoderOptions.Builder	setVideoRotation(int rotation) The clockwise rotation to be applied to the input video frames.
TranscoderOptions.Builder	setVideoTrackStrategy(TrackStrategy trackStrategy) Sets the video output strategy.
java.util.concurrent.Future<java.lang.Void>	transcode()

Methods inherited from class java.lang.Object

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

Method Detail

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        DataSource dataSource)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        TrackType type,
                                                        @NonNull
                                                        DataSource dataSource)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        java.io.FileDescriptor fileDescriptor)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        TrackType type,
                                                        @NonNull
                                                        java.io.FileDescriptor fileDescriptor)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        java.lang.String inPath)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        TrackType type,
                                                        @NonNull
                                                        java.lang.String inPath)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        android.content.Context context,
                                                        @NonNull
                                                        android.net.Uri uri)

addDataSource

@NonNull
public TranscoderOptions.Builder addDataSource(@NonNull
                                                        TrackType type,
                                                        @NonNull
                                                        android.content.Context context,
                                                        @NonNull
                                                        android.net.Uri uri)

setAudioTrackStrategy

@NonNull
public TranscoderOptions.Builder setAudioTrackStrategy(@Nullable
                                                                TrackStrategy trackStrategy)

Sets the audio output strategy. If absent, this defaults to DefaultAudioStrategy.

Parameters:

trackStrategy - the desired strategy

Returns:

this for chaining

setVideoTrackStrategy

@NonNull
public TranscoderOptions.Builder setVideoTrackStrategy(@Nullable
                                                                TrackStrategy trackStrategy)

Sets the video output strategy. If absent, this defaults to the 16:9 strategy returned by DefaultVideoStrategies.for720x1280().

Parameters:

trackStrategy - the desired strategy

Returns:

this for chaining

setListener

@NonNull
public TranscoderOptions.Builder setListener(@NonNull
                                                      TranscoderListener listener)

setListenerHandler

@NonNull
public TranscoderOptions.Builder setListenerHandler(@Nullable
                                                             android.os.Handler listenerHandler)

Sets an handler for TranscoderListener callbacks. If null, this will default to the thread that starts the transcoding, if it has a looper, or the UI thread otherwise.

Parameters:

listenerHandler - the thread to receive callbacks

Returns:

this for chaining

setValidator

@NonNull
public TranscoderOptions.Builder setValidator(@Nullable
                                                       Validator validator)

Sets a validator to understand whether the transcoding process should stop before being started, based on the tracks status. Will default to DefaultValidator.

Parameters:

validator - the validator

Returns:

this for chaining

setVideoRotation

@NonNull
public TranscoderOptions.Builder setVideoRotation(int rotation)

The clockwise rotation to be applied to the input video frames. Defaults to 0, which leaves the input rotation unchanged.

Parameters:

rotation - either 0, 90, 180 or 270

Returns:

this for chaining

setTimeInterpolator

@NonNull
public TranscoderOptions.Builder setTimeInterpolator(@NonNull
                                                              TimeInterpolator timeInterpolator)

Sets a TimeInterpolator to change the frames timestamps - either video or audio or both - before they are written into the output file. Defaults to DefaultTimeInterpolator.

Parameters:

timeInterpolator - a time interpolator

Returns:

this for chaining

setSpeed

@NonNull
public TranscoderOptions.Builder setSpeed(float speedFactor)

Shorthand for calling setTimeInterpolator(TimeInterpolator) and passing a SpeedTimeInterpolator. This interpolator can modify the video speed by the given factor.

Parameters:

speedFactor - a factor, greather than 0

Returns:

this for chaining

setAudioStretcher

@NonNull
public TranscoderOptions.Builder setAudioStretcher(@NonNull
                                                            AudioStretcher audioStretcher)

Sets an AudioStretcher to perform stretching of audio samples as a consequence of speed and time interpolator changes. Defaults to DefaultAudioStretcher.

Parameters:

audioStretcher - an audio stretcher

Returns:

this for chaining

setAudioResampler

@NonNull
public TranscoderOptions.Builder setAudioResampler(@NonNull
                                                            AudioResampler audioResampler)

Sets an AudioResampler to change the sample rate of audio frames when sample rate conversion is needed. Upsampling is discouraged. Defaults to DefaultAudioResampler.

Parameters:

audioResampler - an audio resampler

Returns:

this for chaining

build

@NonNull
public TranscoderOptions build()

transcode

@NonNull
public java.util.concurrent.Future<java.lang.Void> transcode()