SpeedChangingAudioProcessor

public final SpeedProvider speedProvider

The speed provider that provides the speed for each timestamp.

public AudioProcessor.AudioFormat configure(AudioProcessor.AudioFormat inputAudioFormat)

Configures the processor to process input audio with the specified format. After calling this method, call isActive to determine whether the audio processor is active. Returns the configured output audio format if this instance is active.

After calling this method, it is necessary to flush the processor to apply the new configuration. Before applying the new configuration, it is safe to queue input and get output in the old input/output formats. Call queueEndOfStream when no more input will be supplied in the old input format.

public void flush(AudioProcessor.StreamMetadata streamMetadata)

Prepares the audio processor to receive a new stream of input in the last configured format and clears any buffered data and pending output.

This method is a no-op if the processor is not active.

public long getDurationAfterProcessorApplied(long durationUs)

Returns the expected duration of the output stream when the processor is applied given a input durationUs.

This method assumes durationUs of input is applied from the beginning of the stream (i.e. after a flush(StreamMetadata.DEFAULT) call).

public long getMediaDurationUs(long playoutDurationUs)

Returns the input media duration in microseconds for the given playout duration.

This method returns the inverse of getSpeedAdjustedTimeAsync when the instance has been configured and flushed. Otherwise, it returns playoutDurationUs.

public ByteBuffer getOutput()

Returns a buffer containing processed output data between its position and limit. The buffer will always be a direct byte buffer with native byte order. Calling this method invalidates any previously returned buffer. The buffer will be empty if no output is available.

public static long getSampleCountAfterProcessorApplied(
    SpeedProvider speedProvider,
    @IntRange(from = 1) int inputSampleRateHz,
    @IntRange(from = 0) long inputSamples
)

Returns the estimated number of samples output given the provided parameters.

public void getSpeedAdjustedTimeAsync(long inputTimeUs, TimestampConsumer callback)

Calculates the time at which the inputTimeUs is outputted at after the speed changes has been applied.

Calls the callback with the output time as soon as enough audio has been processed to calculate it.

If the audio processor has ended, speeds will come out at the last processed speed of the audio processor.

Successive calls must have monotonically increasing inputTimeUs.

Can be called from any thread.

public SpeedProvider getSpeedProvider()

Returns the SpeedProvider set for this instance.

public boolean isActive()

Returns whether the processor is configured and will process input buffers.

public boolean isEnded()

Returns whether this processor will return no more output from getOutput until flush has been called and more input has been queued.

public void queueEndOfStream()

Queues an end of stream signal. After this method has been called, queueInput may not be called until after the next call to flush. Calling getOutput will return any remaining output data. Multiple calls may be required to read all of the remaining output data. isEnded will return true once all remaining output data has been read.

public void queueInput(ByteBuffer inputBuffer)

Queues audio data between the position and limit of the inputBuffer for processing. After calling this method, processed output may be available via getOutput. Calling queueInput(ByteBuffer) again invalidates any pending output.

public void reset()

Resets the processor to its unconfigured state, releasing any resources.