org.jitsi.impl.neomedia.protocol

Class RewritablePushBufferDataSource

java.lang.Object

javax.media.protocol.DataSource

javax.media.protocol.PushBufferDataSource

org.jitsi.impl.neomedia.protocol.CaptureDeviceDelegatePushBufferDataSource

org.jitsi.impl.neomedia.protocol.PushBufferDataSourceDelegate<javax.media.protocol.PushBufferDataSource>

org.jitsi.impl.neomedia.protocol.RewritablePushBufferDataSource

All Implemented Interfaces:

javax.media.Controls, javax.media.Duration, javax.media.protocol.CaptureDevice, InbandDTMFDataSource, MuteDataSource

public class RewritablePushBufferDataSource
extends PushBufferDataSourceDelegate<javax.media.protocol.PushBufferDataSource>
implements MuteDataSource, InbandDTMFDataSource

Implements a PushBufferDataSource wrapper which provides mute support for the wrapped instance.

Because the class wouldn't work for our use case without it, CaptureDevice is implemented and is being delegated to the wrapped DataSource (if it supports the interface in question).

Author:

Lyubomir Marinov

Field Summary

Fields inherited from class org.jitsi.impl.neomedia.protocol.PushBufferDataSourceDelegate

dataSource

Fields inherited from class org.jitsi.impl.neomedia.protocol.CaptureDeviceDelegatePushBufferDataSource

captureDevice, EMPTY_STREAMS

Fields inherited from interface javax.media.Duration

DURATION_UNBOUNDED, DURATION_UNKNOWN

Constructor Summary

Constructors

Constructor and Description
RewritablePushBufferDataSource(javax.media.protocol.PushBufferDataSource dataSource) Initializes a new RewritablePushBufferDataSource instance which is to provide mute support for a specific PushBufferDataSource.

Method Summary

Modifier and Type	Method and Description
void	addDTMF(DTMFInbandTone tone) Adds a new inband DTMF tone to send.
Object	getControl(String controlType) Implements Controls.getControl(String).
javax.media.protocol.PushBufferStream[]	getStreams() Implements PushBufferDataSource.getStreams().
boolean	isMute() Determines whether this DataSource is mute.
boolean	isSendingDTMF() Determines whether this DataSource sends a DTMF tone.
static void	mute(javax.media.Buffer buffer) Replaces the media data contained in a specific Buffer with a compatible representation of silence.
static void	sendDTMF(javax.media.Buffer buffer, DTMFInbandTone tone) Replaces the media data contained in a specific Buffer with an inband DTMF tone signal.
void	setMute(boolean mute) Sets the mute state of this DataSource.

Methods inherited from class org.jitsi.impl.neomedia.protocol.PushBufferDataSourceDelegate

connect, disconnect, getContentType, getControls, getDataSource, getDuration, getLocator, start, stop

Methods inherited from class org.jitsi.impl.neomedia.protocol.CaptureDeviceDelegatePushBufferDataSource

getCaptureDeviceInfo, getFormatControls

Methods inherited from class javax.media.protocol.DataSource

initCheck, setLocator

Methods inherited from class java.lang.Object

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

Constructor Detail

RewritablePushBufferDataSource

public RewritablePushBufferDataSource(javax.media.protocol.PushBufferDataSource dataSource)

Initializes a new RewritablePushBufferDataSource instance which is to provide mute support for a specific PushBufferDataSource.

Parameters:

dataSource - the PushBufferDataSource the new instance is to provide mute support for

Method Detail

getControl

public Object getControl(String controlType)

Implements Controls.getControl(String). Delegates to the wrapped DataSource. Overrides CaptureDeviceDelegatePushBufferDataSource.getControl(String) because the wrapped DataSource may not be a CaptureDevice yet it still needs to give access to the control. Overrides the super implementation to include the type hierarchy of the very wrapped dataSource instance into the search for the specified controlType.

Specified by:

getControl in interface javax.media.Controls

Overrides:

getControl in class PushBufferDataSourceDelegate<javax.media.protocol.PushBufferDataSource>

Parameters:

controlType - a String value which names the type of the control to be retrieved

Returns:

an Object which represents the control of the requested controlType of the wrapped DataSource

getStreams

public javax.media.protocol.PushBufferStream[] getStreams()

Implements PushBufferDataSource.getStreams(). Wraps the streams of the wrapped PushBufferDataSource into MutePushBufferStream instances in order to provide mute support to them.

Specified by:

getStreams in class PushBufferDataSourceDelegate<javax.media.protocol.PushBufferDataSource>

Returns:

an array of PushBufferStream instances with enabled mute support

isMute

public boolean isMute()

Determines whether this DataSource is mute.

Specified by:

isMute in interface MuteDataSource

Returns:

true if this DataSource is mute; otherwise, false

mute

public static void mute(javax.media.Buffer buffer)

Replaces the media data contained in a specific Buffer with a compatible representation of silence.

Parameters:

buffer - the Buffer the data contained in which is to be replaced with silence

setMute

public void setMute(boolean mute)

Sets the mute state of this DataSource.

Specified by:

setMute in interface MuteDataSource

Parameters:

mute - true to mute this DataSource; otherwise, false

addDTMF

public void addDTMF(DTMFInbandTone tone)

Adds a new inband DTMF tone to send.

Specified by:

addDTMF in interface InbandDTMFDataSource

Parameters:

tone - the DTMF tone to send.

isSendingDTMF

public boolean isSendingDTMF()

Determines whether this DataSource sends a DTMF tone.

Returns:

true if this DataSource is sending a DTMF tone; otherwise, false.

sendDTMF

public static void sendDTMF(javax.media.Buffer buffer,
                            DTMFInbandTone tone)

Replaces the media data contained in a specific Buffer with an inband DTMF tone signal.

Parameters:

buffer - the Buffer the data contained in which is to be replaced with the DTMF tone

tone - the DMFTTone to send via inband DTMF signal.