ForwardingAudioSink (ExoPlayer library) - Exoplayer

Package com.google.android.exoplayer2.audio

Class ForwardingAudioSink

java.lang.Object
- com.google.android.exoplayer2.audio.ForwardingAudioSink
All Implemented Interfaces:AudioSinkDirect Known Subclasses:CapturingAudioSink, OggFileAudioBufferSink

[@Deprecated](https://developer.android.com/reference/java/lang/Deprecated.html "class or interface in java.lang")public classForwardingAudioSinkextends[Object](https://developer.android.com/reference/java/lang/Object.html "class or interface in java.lang")implements[AudioSink](AudioSink.html "interface in com.google.android.exoplayer2.audio")

Deprecated. com.google.android.exoplayer2 is deprecated. Please migrate to androidx.media3 (which contains the same ExoPlayer code). See the migration guide for more details, including a script to help with the migration.

An overridable AudioSink implementation forwarding all methods to another sink.

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 | | --- | --- | | ForwardingAudioSink(AudioSink sink) | Deprecated. |

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods | Modifier and Type | Method | Description | | --- | --- | --- | | void | configure(Format inputFormat, int specifiedBufferSize, int[] outputChannels) | Deprecated.

Configures (or reconfigures) the sink. | | void | disableTunneling() | Deprecated.

Disables tunneling. | | void | enableTunnelingV21() | Deprecated.

Enables tunneling, if possible. | | void | experimentalFlushWithoutAudioTrackRelease() | Deprecated.

Flushes the sink, after which it is ready to receive buffers from a new playback position. | | void | flush() | Deprecated.

Flushes the sink, after which it is ready to receive buffers from a new playback position. | | AudioAttributes | getAudioAttributes() | Deprecated.

Returns the audio attributes used for audio playback, or null if the sink does not use audio attributes. | | long | getCurrentPositionUs(boolean sourceEnded) | Deprecated.

Returns the playback position in the stream starting at zero, in microseconds, or AudioSink.CURRENT_POSITION_NOT_SET if it is not yet available. | | @com.google.android.exoplayer2.audio.AudioSink.SinkFormatSupport int | getFormatSupport(Format format) | Deprecated.

Returns the level of support that the sink provides for a given Format. | | PlaybackParameters | getPlaybackParameters() | Deprecated.

Returns the active PlaybackParameters. | | boolean | getSkipSilenceEnabled() | Deprecated.

Returns whether silences are skipped in the audio stream. | | boolean | handleBuffer(ByteBuffer buffer, long presentationTimeUs, int encodedAccessUnitCount) | Deprecated.

Attempts to process data from a ByteBuffer, starting from its current position and ending at its limit (exclusive). | | void | handleDiscontinuity() | Deprecated.

Signals to the sink that the next buffer may be discontinuous with the previous buffer. | | boolean | hasPendingData() | Deprecated.

Returns whether the sink has data pending that has not been consumed yet. | | boolean | isEnded() | Deprecated.

Returns whether AudioSink.playToEndOfStream() has been called and all buffers have been processed. | | void | pause() | Deprecated.

Pauses playback. | | void | play() | Deprecated.

Starts or resumes consuming audio if initialized. | | void | playToEndOfStream() | Deprecated.

Processes any remaining data. | | void | reset() | Deprecated.

Resets the sink, releasing any resources that it currently holds. | | void | setAudioAttributes(AudioAttributes audioAttributes) | Deprecated.

Sets attributes for audio playback. | | void | setAudioSessionId(int audioSessionId) | Deprecated.

Sets the audio session id. | | void | setAuxEffectInfo(AuxEffectInfo auxEffectInfo) | Deprecated.

Sets the auxiliary effect. | | void | setListener(AudioSink.Listener listener) | Deprecated.

Sets the listener for sink events, which should be the audio renderer. | | void | setOutputStreamOffsetUs(long outputStreamOffsetUs) | Deprecated.

Sets the offset that is added to the media timestamp before it is passed as presentationTimeUs in AudioSink.handleBuffer(ByteBuffer, long, int). | | void | setPlaybackParameters(PlaybackParameters playbackParameters) | Deprecated.

Attempts to set the playback parameters. | | void | setPlayerId(PlayerId playerId) | Deprecated.

Sets the PlayerId of the player using this audio sink. | | void | setPreferredDevice(AudioDeviceInfo audioDeviceInfo) | Deprecated.

Sets the preferred audio device. | | void | setSkipSilenceEnabled(boolean skipSilenceEnabled) | Deprecated.

Sets whether silences should be skipped in the audio stream. | | void | setVolume(float volume) | Deprecated.

Sets the playback volume. | | boolean | supportsFormat(Format format) | Deprecated.

Returns whether the sink supports a given Format. |

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.google.android.exoplayer2.audio.AudioSink

release

Constructor Detail

ForwardingAudioSink

public ForwardingAudioSink([AudioSink](AudioSink.html "interface in com.google.android.exoplayer2.audio")sink)

Deprecated.

Method Detail

setListener

public void setListener([AudioSink.Listener](AudioSink.Listener.html "interface in com.google.android.exoplayer2.audio")listener)

Deprecated.

Description copied from interface: AudioSink

Sets the listener for sink events, which should be the audio renderer. Specified by:setListener in interface AudioSinkParameters:listener - The listener for sink events, which should be the audio renderer.

setPlayerId

public void setPlayerId(@Nullable[PlayerId](../analytics/PlayerId.html "class in com.google.android.exoplayer2.analytics")playerId)

Deprecated.

Description copied from interface: AudioSink

Sets the PlayerId of the player using this audio sink. Specified by:setPlayerId in interface AudioSinkParameters:playerId - The PlayerId, or null to clear a previously set id.

supportsFormat

public boolean supportsFormat([Format](../Format.html "class in com.google.android.exoplayer2")format)

Deprecated.

Description copied from interface: AudioSink

Returns whether the sink supports a given Format. Specified by:supportsFormat in interface AudioSinkParameters:format - The format.Returns:Whether the sink supports the format.

getFormatSupport

public @com.google.android.exoplayer2.audio.AudioSink.SinkFormatSupport int getFormatSupport([Format](../Format.html "class in com.google.android.exoplayer2")format)

Deprecated.

Description copied from interface: AudioSink

Returns the level of support that the sink provides for a given Format. Specified by:getFormatSupport in interface AudioSinkParameters:format - The format.Returns:The level of support provided.

getCurrentPositionUs

public long getCurrentPositionUs(boolean sourceEnded)

Deprecated.

Description copied from interface: AudioSink

Returns the playback position in the stream starting at zero, in microseconds, or AudioSink.CURRENT_POSITION_NOT_SET if it is not yet available. Specified by:getCurrentPositionUs in interface AudioSinkParameters:sourceEnded - Specify true if no more input buffers will be provided.Returns:The playback position relative to the start of playback, in microseconds.

configure

public void configure([Format](../Format.html "class in com.google.android.exoplayer2")inputFormat,
                      int specifiedBufferSize,
                      @Nullable
                      int[] outputChannels)
               throws[AudioSink.ConfigurationException](AudioSink.ConfigurationException.html "class in com.google.android.exoplayer2.audio")

Deprecated.

Description copied from interface: AudioSink

Configures (or reconfigures) the sink. Specified by:configure in interface AudioSinkParameters: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. Specify null to leave the input unchanged. Otherwise, the element at index i specifies index of the input channel to map to output channel i when preprocessing input buffers. After the map is applied the audio data will have outputChannels.length channels.Throws:AudioSink.ConfigurationException - If an error occurs configuring the sink.

play

public void play()

Deprecated.

Description copied from interface: AudioSink

Starts or resumes consuming audio if initialized. Specified by:play in interface AudioSink

handleDiscontinuity

public void handleDiscontinuity()

Deprecated.

Description copied from interface: AudioSink

Signals to the sink that the next buffer may be discontinuous with the previous buffer. Specified by:handleDiscontinuity in interface AudioSink

handleBuffer

public boolean handleBuffer([ByteBuffer](https://developer.android.com/reference/java/nio/ByteBuffer.html "class or interface in java.nio")buffer,
                            long presentationTimeUs,
                            int encodedAccessUnitCount)
                     throws[AudioSink.InitializationException](AudioSink.InitializationException.html "class in com.google.android.exoplayer2.audio"),[AudioSink.WriteException](AudioSink.WriteException.html "class in com.google.android.exoplayer2.audio")

Deprecated.

Description copied from interface: AudioSink

Attempts to process data from a ByteBuffer, starting from its current position and ending at its limit (exclusive). The position of the ByteBuffer is advanced by the number of bytes that were handled. AudioSink.Listener.onPositionDiscontinuity() will be called if presentationTimeUs 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 to AudioSink.flush() (or to AudioSink.configure(Format, int, int[]) that causes the sink to be flushed).

Specified by:handleBuffer in interface AudioSinkParameters: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.

playToEndOfStream

public void playToEndOfStream()
                       throws[AudioSink.WriteException](AudioSink.WriteException.html "class in com.google.android.exoplayer2.audio")

Deprecated.

Description copied from interface: AudioSink

Processes any remaining data. AudioSink.isEnded() will return true when no data remains. Specified by:playToEndOfStream in interface AudioSinkThrows:AudioSink.WriteException - If an error occurs draining data to the sink.

isEnded

public boolean isEnded()

Deprecated.

Description copied from interface: AudioSink

Returns whether AudioSink.playToEndOfStream() has been called and all buffers have been processed. Specified by:isEnded in interface AudioSink

hasPendingData

public boolean hasPendingData()

Deprecated.

Description copied from interface: AudioSink

Returns whether the sink has data pending that has not been consumed yet. Specified by:hasPendingData in interface AudioSink

setPlaybackParameters

public void setPlaybackParameters([PlaybackParameters](../PlaybackParameters.html "class in com.google.android.exoplayer2")playbackParameters)

Deprecated.

Description copied from interface: AudioSink

Attempts to set the playback parameters. The audio sink may override these parameters if they are not supported. Specified by:setPlaybackParameters in interface AudioSinkParameters:playbackParameters - The new playback parameters to attempt to set.

getPlaybackParameters

public[PlaybackParameters](../PlaybackParameters.html "class in com.google.android.exoplayer2")getPlaybackParameters()

Deprecated.

Description copied from interface: AudioSink

Returns the active PlaybackParameters. Specified by:getPlaybackParameters in interface AudioSink

setSkipSilenceEnabled

public void setSkipSilenceEnabled(boolean skipSilenceEnabled)

Deprecated.

Description copied from interface: AudioSink

Sets whether silences should be skipped in the audio stream. Specified by:setSkipSilenceEnabled in interface AudioSink

getSkipSilenceEnabled

public boolean getSkipSilenceEnabled()

Deprecated.

Description copied from interface: AudioSink

Returns whether silences are skipped in the audio stream. Specified by:getSkipSilenceEnabled in interface AudioSink

setAudioAttributes

public void setAudioAttributes([AudioAttributes](AudioAttributes.html "class in com.google.android.exoplayer2.audio")audioAttributes)

Deprecated.

Description copied from interface: AudioSink

Sets attributes for audio playback. If the attributes have changed and if the sink is not configured for use with tunneling, then it is reset and the audio session id is cleared.

If the sink is configured for use with tunneling then the audio attributes are ignored. The sink is not reset and the audio session id is not cleared. The passed attributes will be used if the sink is later re-configured into non-tunneled mode.

Specified by:setAudioAttributes in interface AudioSinkParameters:audioAttributes - The attributes for audio playback.

getAudioAttributes

@Nullable
public[AudioAttributes](AudioAttributes.html "class in com.google.android.exoplayer2.audio")getAudioAttributes()

Deprecated.

Description copied from interface: AudioSink

Returns the audio attributes used for audio playback, or null if the sink does not use audio attributes. Specified by:getAudioAttributes in interface AudioSink

setAudioSessionId

public void setAudioSessionId(int audioSessionId)

Deprecated.

Description copied from interface: AudioSink

Sets the audio session id. Specified by:setAudioSessionId in interface AudioSink

setAuxEffectInfo

public void setAuxEffectInfo([AuxEffectInfo](AuxEffectInfo.html "class in com.google.android.exoplayer2.audio")auxEffectInfo)

Deprecated.

Description copied from interface: AudioSink

Sets the auxiliary effect. Specified by:setAuxEffectInfo in interface AudioSink

setPreferredDevice

@RequiresApi(23)
public void setPreferredDevice(@Nullable[AudioDeviceInfo](https://developer.android.com/reference/android/media/AudioDeviceInfo.html "class or interface in android.media")audioDeviceInfo)

Deprecated.

Description copied from interface: AudioSink

Sets the preferred audio device. Specified by:setPreferredDevice in interface AudioSinkParameters:audioDeviceInfo - The preferred audio device, or null to restore the default.

setOutputStreamOffsetUs

public void setOutputStreamOffsetUs(long outputStreamOffsetUs)

Deprecated.

Description copied from interface: AudioSink

Sets the offset that is added to the media timestamp before it is passed as presentationTimeUs in AudioSink.handleBuffer(ByteBuffer, long, int). Specified by:setOutputStreamOffsetUs in interface AudioSinkParameters:outputStreamOffsetUs - The output stream offset in microseconds.

enableTunnelingV21

public void enableTunnelingV21()

Deprecated.

Description copied from interface: AudioSink

Enables tunneling, if possible. The sink is reset if tunneling was previously disabled. Enabling tunneling is only possible if the sink is based on a platform AudioTrack, and requires platform API version 21 onwards. Specified by:enableTunnelingV21 in interface AudioSink

disableTunneling

public void disableTunneling()

Deprecated.

Description copied from interface: AudioSink

Disables tunneling. If tunneling was previously enabled then the sink is reset and any audio session id is cleared. Specified by:disableTunneling in interface AudioSink

setVolume

public void setVolume(float volume)

Deprecated.

Description copied from interface: AudioSink

Sets the playback volume. Specified by:setVolume in interface AudioSinkParameters:volume - Linear output gain to apply to all channels. Should be in the range [0.0, 1.0].

pause

public void pause()

Deprecated.

Description copied from interface: AudioSink

Pauses playback. Specified by:pause in interface AudioSink

flush

public void flush()

Deprecated.

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 interface AudioSink

experimentalFlushWithoutAudioTrackRelease

public void experimentalFlushWithoutAudioTrackRelease()

Deprecated.

Description copied from interface: AudioSink

Flushes the sink, after which it is ready to receive buffers from a new playback position.

Does not release the AudioTrack held by the sink.

This method is experimental, and will be renamed or removed in a future release.

Only for experimental use as part of MediaCodecAudioRenderer.experimentalSetEnableKeepAudioTrackOnSeek(boolean).

Specified by:experimentalFlushWithoutAudioTrackRelease in interface AudioSink

reset

public void reset()

Deprecated.

Description copied from interface: AudioSink

Resets the sink, releasing any resources that it currently holds. Specified by:reset in interface AudioSink