com.google.android.exoplayer2.audio

Class SonicAudioProcessor

java.lang.Object

com.google.android.exoplayer2.audio.SonicAudioProcessor

All Implemented Interfaces:

AudioProcessor

public final class SonicAudioProcessor
extends java.lang.Object
implements AudioProcessor

An AudioProcessor that uses the Sonic library to modify audio speed/pitch/sample rate.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.android.exoplayer2.audio.AudioProcessor

AudioProcessor.UnhandledFormatException

Field Summary

Fields

Modifier and Type	Field and Description
static float	MAXIMUM_PITCH The maximum allowed pitch in setPitch(float).
static float	MAXIMUM_SPEED The maximum allowed playback speed in setSpeed(float).
static float	MINIMUM_PITCH The minimum allowed pitch in setPitch(float).
static float	MINIMUM_SPEED The minimum allowed playback speed in setSpeed(float).
static int	SAMPLE_RATE_NO_CHANGE Indicates that the output sample rate should be the same as the input.

Fields inherited from interface com.google.android.exoplayer2.audio.AudioProcessor

EMPTY_BUFFER

Constructor Summary

Constructors

Constructor and Description
SonicAudioProcessor() Creates a new Sonic audio processor.

Method Summary

Modifier and Type	Method and Description
boolean	configure(int sampleRateHz, int channelCount, int encoding) Configures the processor to process input audio with the specified format and returns whether to AudioProcessor.flush() it.
void	flush() Clears any state in preparation for receiving a new stream of input buffers.
java.nio.ByteBuffer	getOutput() Returns a buffer containing processed output data between its position and limit.
int	getOutputChannelCount() Returns the number of audio channels in the data output by the processor.
int	getOutputEncoding() Returns the audio encoding used in the data output by the processor.
int	getOutputSampleRateHz() Returns the sample rate of audio output by the processor, in hertz.
boolean	isActive() Returns whether the processor is configured and will process input buffers.
boolean	isEnded() Returns whether this processor will return no more output from AudioProcessor.getOutput() until it has been AudioProcessor.flush()ed and more input has been queued.
void	queueEndOfStream() Queues an end of stream signal.
void	queueInput(java.nio.ByteBuffer inputBuffer) Queues audio data between the position and limit of the input buffer for processing.
void	reset() Resets the processor to its unconfigured state.
long	scaleDurationForSpeedup(long duration) Returns the specified duration scaled to take into account the speedup factor of this instance, in the same units as duration.
void	setOutputSampleRateHz(int sampleRateHz) Sets the sample rate for output audio, in hertz.
float	setPitch(float pitch) Sets the playback pitch.
float	setSpeed(float speed) Sets the playback speed.

Methods inherited from class java.lang.Object

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

Field Detail

MAXIMUM_SPEED

public static final float MAXIMUM_SPEED

The maximum allowed playback speed in setSpeed(float).

See Also:

Constant Field Values

MINIMUM_SPEED

public static final float MINIMUM_SPEED

The minimum allowed playback speed in setSpeed(float).

See Also:

Constant Field Values

MAXIMUM_PITCH

public static final float MAXIMUM_PITCH

The maximum allowed pitch in setPitch(float).

See Also:

Constant Field Values

MINIMUM_PITCH

public static final float MINIMUM_PITCH

The minimum allowed pitch in setPitch(float).

See Also:

Constant Field Values

SAMPLE_RATE_NO_CHANGE

public static final int SAMPLE_RATE_NO_CHANGE

Indicates that the output sample rate should be the same as the input.

See Also:

Constant Field Values

Constructor Detail

SonicAudioProcessor

public SonicAudioProcessor()

Creates a new Sonic audio processor.

Method Detail

setSpeed

public float setSpeed(float speed)

Sets the playback speed. Calling this method will discard any data buffered within the processor, and may update the value returned by isActive().

Parameters:

speed - The requested new playback speed.

Returns:

The actual new playback speed.

setPitch

public float setPitch(float pitch)

Sets the playback pitch. Calling this method will discard any data buffered within the processor, and may update the value returned by isActive().

Parameters:

pitch - The requested new pitch.

Returns:

The actual new pitch.

setOutputSampleRateHz

public void setOutputSampleRateHz(int sampleRateHz)

Sets the sample rate for output audio, in hertz. Pass SAMPLE_RATE_NO_CHANGE to output audio at the same sample rate as the input. After calling this method, call configure(int, int, int) to start using the new sample rate.

Parameters:

sampleRateHz - The sample rate for output audio, in hertz.

See Also:

configure(int, int, int)

scaleDurationForSpeedup

public long scaleDurationForSpeedup(long duration)

Returns the specified duration scaled to take into account the speedup factor of this instance, in the same units as duration.

Parameters:

duration - The duration to scale taking into account speedup.

Returns:

The specified duration scaled to take into account speedup, in the same units as duration.

configure

public boolean configure(int sampleRateHz,
                         int channelCount,
                         int encoding)
                  throws AudioProcessor.UnhandledFormatException

Description copied from interface: AudioProcessor

Configures the processor to process input audio with the specified format and returns whether to AudioProcessor.flush() it. After calling this method, if the processor is active, AudioProcessor.getOutputSampleRateHz(), AudioProcessor.getOutputChannelCount() and AudioProcessor.getOutputEncoding() return its output format.

Specified by:

configure in interface AudioProcessor

Parameters:

sampleRateHz - The sample rate of input audio in Hz.

channelCount - The number of interleaved channels in input audio.

encoding - The encoding of input audio.

Returns:

Whether to AudioProcessor.flush() the processor.

Throws:

AudioProcessor.UnhandledFormatException - Thrown if the specified format can't be handled as input.

isActive

public boolean isActive()

Description copied from interface: AudioProcessor

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

Specified by:

isActive in interface AudioProcessor

getOutputChannelCount

public int getOutputChannelCount()

Description copied from interface: AudioProcessor

Returns the number of audio channels in the data output by the processor. The value may change as a result of calling AudioProcessor.configure(int, int, int) and is undefined if the instance is not active.

Specified by:

getOutputChannelCount in interface AudioProcessor

getOutputEncoding

public int getOutputEncoding()

Description copied from interface: AudioProcessor

Returns the audio encoding used in the data output by the processor. The value may change as a result of calling AudioProcessor.configure(int, int, int) and is undefined if the instance is not active.

Specified by:

getOutputEncoding in interface AudioProcessor

getOutputSampleRateHz

public int getOutputSampleRateHz()

Description copied from interface: AudioProcessor

Returns the sample rate of audio output by the processor, in hertz. The value may change as a result of calling AudioProcessor.configure(int, int, int) and is undefined if the instance is not active.

Specified by:

getOutputSampleRateHz in interface AudioProcessor

queueInput

public void queueInput(java.nio.ByteBuffer inputBuffer)

Description copied from interface: AudioProcessor

Queues audio data between the position and limit of the input buffer for processing. buffer must be a direct byte buffer with native byte order. Its contents are treated as read-only. Its position will be advanced by the number of bytes consumed (which may be zero). The caller retains ownership of the provided buffer. Calling this method invalidates any previous buffer returned by AudioProcessor.getOutput().

Specified by:

queueInput in interface AudioProcessor

Parameters:

inputBuffer - The input buffer to process.

queueEndOfStream

public void queueEndOfStream()

Description copied from interface: AudioProcessor

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

Specified by:

queueEndOfStream in interface AudioProcessor

getOutput

public java.nio.ByteBuffer getOutput()

Description copied from interface: AudioProcessor

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.

Specified by:

getOutput in interface AudioProcessor

Returns:

A buffer containing processed output data between its position and limit.

isEnded

public boolean isEnded()

Description copied from interface: AudioProcessor

Returns whether this processor will return no more output from AudioProcessor.getOutput() until it has been AudioProcessor.flush()ed and more input has been queued.

Specified by:

isEnded in interface AudioProcessor

flush

public void flush()

Description copied from interface: AudioProcessor

Clears any state in preparation for receiving a new stream of input buffers.

Specified by:

flush in interface AudioProcessor

reset

public void reset()

Description copied from interface: AudioProcessor

Resets the processor to its unconfigured state.

Specified by:

reset in interface AudioProcessor