org.jitsi.impl.neomedia.rtp

Class TransportCCEngine

java.lang.Object

org.jitsi.impl.neomedia.rtp.RTCPPacketListenerAdapter

org.jitsi.impl.neomedia.rtp.TransportCCEngine

All Implemented Interfaces:

RemoteBitrateObserver, CallStatsObserver, RTCPPacketListener

public class TransportCCEngine
extends RTCPPacketListenerAdapter
implements RemoteBitrateObserver, CallStatsObserver

Implements transport-cc functionality as a TransformEngine. The intention is to have the same instance shared between all media streams of a transport channel, so we expect it will be accessed by multiple threads. See https://tools.ietf.org/html/draft-holmer-rmcat-transport-wide-cc-extensions-01

Author:

Boris Grozev, Julian Chukwu, George Politis

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	TransportCCEngine.EgressEngine Handles outgoing RTP packets for this TransportCCEngine.
class	TransportCCEngine.IngressEngine Handles incoming RTP packets for this TransportCCEngine.

Constructor Summary

Constructors

Constructor and Description
TransportCCEngine(@NotNull org.jitsi.utils.logging.DiagnosticContext diagnosticContext) Ctor.

Method Summary

Modifier and Type	Method and Description
void	addMediaStream(MediaStream mediaStream) Adds a MediaStream to the list of MediaStreams which use this TransportCCEngine.
TransformEngine	getEgressEngine() Gets the engine which handles outgoing RTP packets for this instance.
TransformEngine	getIngressEngine() Gets the engine which handles incoming RTP packets for this instance.
void	onReceiveBitrateChanged(Collection<Long> ssrcs, long bitrate) Called when a receive channel group has a new bitrate estimate for the incoming streams.
void	onRttUpdate(long avgRttMs, long maxRttMs)
void	removeMediaStream(MediaStream mediaStream) Removes a MediaStream from the list of MediaStreams which use this TransportCCEngine.
void	setExtensionID(int id) Sets the ID of the transport-cc RTP extension.
void	tccReceived(RTCPTCCPacket tccPacket) Handles an incoming RTCP transport-cc feedback packet.

Methods inherited from class org.jitsi.impl.neomedia.rtp.RTCPPacketListenerAdapter

nackReceived, rembReceived, srReceived

Methods inherited from class java.lang.Object

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

Constructor Detail

TransportCCEngine

public TransportCCEngine(@NotNull
                         @NotNull org.jitsi.utils.logging.DiagnosticContext diagnosticContext)

Ctor.

Parameters:

diagnosticContext - the DiagnosticContext of this instance.

Method Detail

onRttUpdate

public void onRttUpdate(long avgRttMs,
                        long maxRttMs)

Specified by:

onRttUpdate in interface CallStatsObserver

setExtensionID

public void setExtensionID(int id)

Sets the ID of the transport-cc RTP extension. Set to -1 to effectively disable.

Parameters:

id - the ID to set.

onReceiveBitrateChanged

public void onReceiveBitrateChanged(Collection<Long> ssrcs,
                                    long bitrate)

Called when a receive channel group has a new bitrate estimate for the incoming streams.

Specified by:

onReceiveBitrateChanged in interface RemoteBitrateObserver

Parameters:

ssrcs -

bitrate -

tccReceived

public void tccReceived(RTCPTCCPacket tccPacket)

Handles an incoming RTCP transport-cc feedback packet.

Specified by:

tccReceived in interface RTCPPacketListener

Overrides:

tccReceived in class RTCPPacketListenerAdapter

Parameters:

tccPacket - the received TCC packet.

getEgressEngine

public TransformEngine getEgressEngine()

Gets the engine which handles outgoing RTP packets for this instance.

getIngressEngine

public TransformEngine getIngressEngine()

Gets the engine which handles incoming RTP packets for this instance.

addMediaStream

public void addMediaStream(MediaStream mediaStream)

Adds a MediaStream to the list of MediaStreams which use this TransportCCEngine.

Parameters:

mediaStream - the stream to add.

removeMediaStream

public void removeMediaStream(MediaStream mediaStream)

Removes a MediaStream from the list of MediaStreams which use this TransportCCEngine.

Parameters:

mediaStream - the stream to remove.