org.jitsi.impl.neomedia.rtp

Class MediaStreamTrackReceiver

java.lang.Object

org.jitsi.impl.neomedia.transform.SinglePacketTransformer

org.jitsi.impl.neomedia.transform.SinglePacketTransformerAdapter

org.jitsi.impl.neomedia.rtp.MediaStreamTrackReceiver

All Implemented Interfaces:

PacketTransformer, TransformEngine

Direct Known Subclasses:

VideoMediaStreamTrackReceiver

public class MediaStreamTrackReceiver
extends SinglePacketTransformerAdapter
implements TransformEngine

Contains the MediaStreamTrackDescs for a MediaStream. It is also part of the MediaStream's transform chain and has the opportunity to update its MediaStreamTrackDescs with received packets. This default implementation does no update the MediaStreamTrackDescs, it only serves to contain the signalled tracks and encodings.

Author:

George Politis, Boris Grozev

Constructor Summary

Constructors

Constructor and Description
MediaStreamTrackReceiver(MediaStreamImpl stream) Ctor.

Method Summary

Modifier and Type	Method and Description
MediaStreamTrackDesc	findMediaStreamTrackDesc(long ssrc) Finds the MediaStreamTrackDesc that corresponds to the SSRC that is specified in the arguments.
RTPEncodingDesc	findRTPEncodingDesc(long ssrc) Finds the RTPEncodingDesc that matches ByteArrayBuffer passed in as a parameter.
RTPEncodingDesc	findRTPEncodingDesc(RawPacket pkt) Finds the RTPEncodingDesc that matches the RawPacket passed in as a parameter.
MediaStreamTrackDesc[]	getMediaStreamTracks() Gets the MediaStreamTrackDescs that this instance is configured to receive.
PacketTransformer	getRTCPTransformer() Gets the PacketTransformer for RTCP packets.
PacketTransformer	getRTPTransformer() Gets the PacketTransformer for RTP packets.
MediaStreamImpl	getStream() Gets the MediaStream that owns this instance.
boolean	setMediaStreamTracks(MediaStreamTrackDesc[] newTracks) Updates this MediaStreamTrackReceiver with the new RTP encoding parameters.

Methods inherited from class org.jitsi.impl.neomedia.transform.SinglePacketTransformerAdapter

reverseTransform, transform

Methods inherited from class org.jitsi.impl.neomedia.transform.SinglePacketTransformer

close, reverseTransform, transform

Methods inherited from class java.lang.Object

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

Constructor Detail

MediaStreamTrackReceiver

public MediaStreamTrackReceiver(MediaStreamImpl stream)

Ctor.

Parameters:

stream - The MediaStream that this instance receives MediaStreamTrackDescs from.

Method Detail

findRTPEncodingDesc

public RTPEncodingDesc findRTPEncodingDesc(RawPacket pkt)

Finds the RTPEncodingDesc that matches the RawPacket passed in as a parameter. Assumes that the packet is valid.

Parameters:

pkt - the packet to match.

Returns:

the RTPEncodingDesc that matches the pkt passed in as a parameter, or null if there is no matching RTPEncodingDesc.

findRTPEncodingDesc

public RTPEncodingDesc findRTPEncodingDesc(long ssrc)

Finds the RTPEncodingDesc that matches ByteArrayBuffer passed in as a parameter.

Parameters:

ssrc - the SSRC of the RTPEncodingDesc to match. If multiple encodings share the same SSRC, the first match will be returned.

Returns:

the RTPEncodingDesc that matches the pkt passed in as a parameter, or null if there is no matching RTPEncodingDesc.

getRTPTransformer

public PacketTransformer getRTPTransformer()

Gets the PacketTransformer for RTP packets.

Specified by:

getRTPTransformer in interface TransformEngine

Returns:

the PacketTransformer for RTP packets

getRTCPTransformer

public PacketTransformer getRTCPTransformer()

Gets the PacketTransformer for RTCP packets.

Specified by:

getRTCPTransformer in interface TransformEngine

Returns:

the PacketTransformer for RTCP packets

getMediaStreamTracks

public MediaStreamTrackDesc[] getMediaStreamTracks()

Gets the MediaStreamTrackDescs that this instance is configured to receive.

Returns:

the MediaStreamTrackDescs that this instance is configured to receive.

setMediaStreamTracks

public boolean setMediaStreamTracks(MediaStreamTrackDesc[] newTracks)

Updates this MediaStreamTrackReceiver with the new RTP encoding parameters. Note that in order to avoid losing the state of existing MediaStreamTrackDesc instances, when one of the new instances matches (i.e. the primary SSRC of its first encoding matches) an old instance we keep the old instance. Currently we also keep the old instance's configuration (TODO use the new configuration).

Parameters:

newTracks - the MediaStreamTrackDescs that this instance will receive. Note that the actual MediaStreamTrackDesc instances might not match. To get the actual instances call getMediaStreamTracks().

Returns:

true if the MSTs have changed, otherwise false.

getStream

public MediaStreamImpl getStream()

Gets the MediaStream that owns this instance.

Returns:

the MediaStream that owns this instance.

findMediaStreamTrackDesc

public MediaStreamTrackDesc findMediaStreamTrackDesc(long ssrc)

Finds the MediaStreamTrackDesc that corresponds to the SSRC that is specified in the arguments.

Parameters:

ssrc - the SSRC of the MediaStreamTrackDesc to match.

Returns:

the MediaStreamTrackDesc that matches the specified SSRC.