Class CapturingAudioSink
- java.lang.Object
-
- com.google.android.exoplayer2.audio.ForwardingAudioSink
-
- com.google.android.exoplayer2.testutil.CapturingAudioSink
-
- All Implemented Interfaces:
AudioSink
,Dumper.Dumpable
public final class CapturingAudioSink extends ForwardingAudioSink implements Dumper.Dumpable
AForwardingAudioSink
that captures configuration, discontinuity and buffer events.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface com.google.android.exoplayer2.audio.AudioSink
AudioSink.ConfigurationException, AudioSink.InitializationException, AudioSink.Listener, AudioSink.SinkFormatSupport, AudioSink.UnexpectedDiscontinuityException, AudioSink.WriteException
-
-
Field Summary
-
Fields inherited from interface com.google.android.exoplayer2.audio.AudioSink
CURRENT_POSITION_NOT_SET, SINK_FORMAT_SUPPORTED_DIRECTLY, SINK_FORMAT_SUPPORTED_WITH_TRANSCODING, SINK_FORMAT_UNSUPPORTED
-
-
Constructor Summary
Constructors Constructor Description CapturingAudioSink(AudioSink sink)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
configure(Format inputFormat, int specifiedBufferSize, int[] outputChannels)
Configures (or reconfigures) the sink.void
dump(Dumper dumper)
Dumps the fields of the object using thedumper
.void
flush()
Flushes the sink, after which it is ready to receive buffers from a new playback position.boolean
handleBuffer(ByteBuffer buffer, long presentationTimeUs, int encodedAccessUnitCount)
Attempts to process data from aByteBuffer
, starting from its current position and ending at its limit (exclusive).void
handleDiscontinuity()
Signals to the sink that the next buffer may be discontinuous with the previous buffer.void
reset()
Resets the sink, releasing any resources that it currently holds.-
Methods inherited from class com.google.android.exoplayer2.audio.ForwardingAudioSink
disableTunneling, enableTunnelingV21, experimentalFlushWithoutAudioTrackRelease, getAudioAttributes, getCurrentPositionUs, getFormatSupport, getPlaybackParameters, getSkipSilenceEnabled, hasPendingData, isEnded, pause, play, playToEndOfStream, setAudioAttributes, setAudioSessionId, setAuxEffectInfo, setListener, setOutputStreamOffsetUs, setPlaybackParameters, setPlayerId, setPreferredDevice, setSkipSilenceEnabled, setVolume, supportsFormat
-
-
-
-
Constructor Detail
-
CapturingAudioSink
public CapturingAudioSink(AudioSink sink)
-
-
Method Detail
-
configure
public void configure(Format inputFormat, int specifiedBufferSize, @Nullable int[] outputChannels) throws AudioSink.ConfigurationException
Description copied from interface:AudioSink
Configures (or reconfigures) the sink.- Specified by:
configure
in interfaceAudioSink
- Overrides:
configure
in classForwardingAudioSink
- Parameters:
inputFormat
- The format of audio data provided in the input buffers.specifiedBufferSize
- A specific size for the playback buffer in bytes, or 0 to infer a suitable buffer size.outputChannels
- A mapping from input to output channels that is applied to this sink's input as a preprocessing step, if handling PCM input. Specifynull
to leave the input unchanged. Otherwise, the element at indexi
specifies index of the input channel to map to output channeli
when preprocessing input buffers. After the map is applied the audio data will haveoutputChannels.length
channels.- Throws:
AudioSink.ConfigurationException
- If an error occurs configuring the sink.
-
handleDiscontinuity
public void handleDiscontinuity()
Description copied from interface:AudioSink
Signals to the sink that the next buffer may be discontinuous with the previous buffer.- Specified by:
handleDiscontinuity
in interfaceAudioSink
- Overrides:
handleDiscontinuity
in classForwardingAudioSink
-
handleBuffer
public boolean handleBuffer(ByteBuffer buffer, long presentationTimeUs, int encodedAccessUnitCount) throws AudioSink.InitializationException, AudioSink.WriteException
Description copied from interface:AudioSink
Attempts to process data from aByteBuffer
, starting from its current position and ending at its limit (exclusive). The position of theByteBuffer
is advanced by the number of bytes that were handled.AudioSink.Listener.onPositionDiscontinuity()
will be called ifpresentationTimeUs
is discontinuous with the last buffer handled since the last reset.Returns whether the data was handled in full. If the data was not handled in full then the same
ByteBuffer
must be provided to subsequent calls until it has been fully consumed, except in the case of an intervening call toAudioSink.flush()
(or toAudioSink.configure(Format, int, int[])
that causes the sink to be flushed).- Specified by:
handleBuffer
in interfaceAudioSink
- Overrides:
handleBuffer
in classForwardingAudioSink
- Parameters:
buffer
- The buffer containing audio data.presentationTimeUs
- The presentation timestamp of the buffer in microseconds.encodedAccessUnitCount
- The number of encoded access units in the buffer, or 1 if the buffer contains PCM audio. This allows batching multiple encoded access units in one buffer.- Returns:
- Whether the buffer was handled fully.
- Throws:
AudioSink.InitializationException
- If an error occurs initializing the sink.AudioSink.WriteException
- If an error occurs writing the audio data.
-
flush
public void flush()
Description copied from interface:AudioSink
Flushes the sink, after which it is ready to receive buffers from a new playback position.The audio session may remain active until
AudioSink.reset()
is called.- Specified by:
flush
in interfaceAudioSink
- Overrides:
flush
in classForwardingAudioSink
-
reset
public void reset()
Description copied from interface:AudioSink
Resets the sink, releasing any resources that it currently holds.- Specified by:
reset
in interfaceAudioSink
- Overrides:
reset
in classForwardingAudioSink
-
dump
public void dump(Dumper dumper)
Description copied from interface:Dumper.Dumpable
Dumps the fields of the object using thedumper
.- Specified by:
dump
in interfaceDumper.Dumpable
- Parameters:
dumper
- TheDumper
to be used to dump fields.
-
-