org.jitsi.impl.neomedia.transform

Class RtxTransformer

java.lang.Object

org.jitsi.impl.neomedia.transform.RtxTransformer

All Implemented Interfaces:

TransformEngine

public class RtxTransformer
extends Object
implements TransformEngine

Intercepts RTX (RFC-4588) packets coming from an MediaStream, and removes their RTX encapsulation. Intercepts NACKs and retransmits packets to a mediaStream (using the RTX format if the destination supports it).

Author:

Boris Grozev, George Politis

Field Summary

Fields

Modifier and Type	Field and Description
static String	DISABLE_NACK_TERMINATION_PNAME The name of the property used to disable NACK termination.

Constructor Summary

Constructors

Constructor and Description
RtxTransformer(MediaStreamImpl mediaStream) Initializes a new RtxTransformer with a specific MediaStreamImpl.

Method Summary

Modifier and Type	Method and Description
boolean	destinationSupportsRtx() Returns a boolean that indicates whether or not the destination endpoint supports RTX.
PacketTransformer	getRTCPTransformer() Implements TransformEngine.getRTCPTransformer().
PacketTransformer	getRTPTransformer() Implements TransformEngine.getRTPTransformer().
void	onDynamicPayloadTypesChanged() Notifies this instance that the dynamic payload types of the associated MediaStream have changed.
int	sendPadding(long ssrc, int bytes) Sends padding packets with the RTX SSRC associated to the media SSRC that is passed as a parameter.

Methods inherited from class java.lang.Object

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

Field Detail

DISABLE_NACK_TERMINATION_PNAME

public static final String DISABLE_NACK_TERMINATION_PNAME

The name of the property used to disable NACK termination.

See Also:

Constant Field Values

Constructor Detail

RtxTransformer

public RtxTransformer(MediaStreamImpl mediaStream)

Initializes a new RtxTransformer with a specific MediaStreamImpl.

Parameters:

mediaStream - the MediaStreamImpl for the transformer.

Method Detail

getRTPTransformer

public PacketTransformer getRTPTransformer()

Implements TransformEngine.getRTPTransformer().

Specified by:

getRTPTransformer in interface TransformEngine

Returns:

the PacketTransformer for RTP packets

getRTCPTransformer

public PacketTransformer getRTCPTransformer()

Implements TransformEngine.getRTCPTransformer().

Specified by:

getRTCPTransformer in interface TransformEngine

Returns:

the PacketTransformer for RTCP packets

destinationSupportsRtx

public boolean destinationSupportsRtx()

Returns a boolean that indicates whether or not the destination endpoint supports RTX.

Returns:

true if the destination endpoint supports RTX, otherwise false.

onDynamicPayloadTypesChanged

public void onDynamicPayloadTypesChanged()

Notifies this instance that the dynamic payload types of the associated MediaStream have changed.

sendPadding

public int sendPadding(long ssrc,
                       int bytes)

Sends padding packets with the RTX SSRC associated to the media SSRC that is passed as a parameter. It implements packet triplication.

Parameters:

ssrc - the media SSRC to protect.

bytes - the amount of padding to send in bytes.

Returns:

the remaining padding bytes budget.