org.jitsi.impl.neomedia.rtp.translator

Class RTCPFeedbackMessageSender

java.lang.Object

org.jitsi.impl.neomedia.rtp.translator.RTCPFeedbackMessageSender

public class RTCPFeedbackMessageSender
extends Object

Allows sending RTCP feedback message packets such as FIR, takes care of their (command) sequence numbers.

Author:

Boris Grozev, Lyubomir Marinov, George Politis

Constructor Summary

Constructors

Constructor and Description
RTCPFeedbackMessageSender(RTPTranslatorImpl rtpTranslator) Initializes a new RTCPFeedbackMessageSender instance which is to send RTCP feedback message packets through a specific RTPTranslatorImpl.

Method Summary

Modifier and Type	Method and Description
void	maybeStopRequesting(org.jitsi.impl.neomedia.rtp.translator.StreamRTPManagerDesc streamRTPManager, long ssrc, byte[] buf, int off, int len) Notifies this instance that an RTP packet has been received from a peer represented by a specific StreamRTPManagerDesc.
boolean	requestKeyframe(long mediaSenderSSRC) Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to the media sender/source with a specific synchronization source identifier (SSRC).
boolean	requestKeyframe(long[] mediaSenderSSRCs) Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to media senders/sources with a specific synchronization source identifiers (SSRCs).
boolean	sendFIR(int mediaSenderSSRC) Deprecated. Use the generic requestKeyframe(long) instead.
boolean	sendFIR(int[] mediaSenderSSRCs) Deprecated. Use the generic requestKeyframe(long[]) instead.

Methods inherited from class java.lang.Object

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

Constructor Detail

RTCPFeedbackMessageSender

public RTCPFeedbackMessageSender(RTPTranslatorImpl rtpTranslator)

Initializes a new RTCPFeedbackMessageSender instance which is to send RTCP feedback message packets through a specific RTPTranslatorImpl.

Parameters:

rtpTranslator - the RTPTranslatorImpl through which the new instance is to send RTCP feedback message packets and the SSRC of which is to be used as the SSRC of packet sender

Method Detail

sendFIR

@Deprecated
public boolean sendFIR(int mediaSenderSSRC)

Deprecated. Use the generic requestKeyframe(long) instead.

Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to the media sender/source with a specific synchronization source identifier (SSRC). Whether to send a FIR or a PLI message is decided based on whether the MediaStream associated with the SSRC supports FIR or PLI.

Parameters:

mediaSenderSSRC - the SSRC of the media sender/source

Returns:

true if an RTCP message was sent; otherwise, false.

requestKeyframe

public boolean requestKeyframe(long mediaSenderSSRC)

Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to the media sender/source with a specific synchronization source identifier (SSRC). Whether to send a FIR or a PLI message is decided based on whether the MediaStream associated with the SSRC supports FIR or PLI.

Parameters:

mediaSenderSSRC - the SSRC of the media sender/source

Returns:

true if an RTCP message was sent; otherwise, false.

sendFIR

@Deprecated
public boolean sendFIR(int[] mediaSenderSSRCs)

Deprecated. Use the generic requestKeyframe(long[]) instead.

Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to media senders/sources with a specific synchronization source identifiers (SSRCs). Whether to send a FIR or a PLI message is decided based on whether the MediaStream associated with the SSRC supports FIR or PLI.

Parameters:

mediaSenderSSRCs - the SSRCs of the media senders/sources

Returns:

true if an RTCP message was sent; otherwise, false.

requestKeyframe

public boolean requestKeyframe(long[] mediaSenderSSRCs)

Sends an RTCP Full Intra Request (FIR) or Picture Loss Indication (PLI), to media senders/sources with a specific synchronization source identifiers (SSRCs). Whether to send a FIR or a PLI message is decided based on whether the MediaStream associated with the SSRC supports FIR or PLI.

Parameters:

mediaSenderSSRCs - the SSRCs of the media senders/sources

Returns:

true if an RTCP message was sent; otherwise, false.

maybeStopRequesting

public void maybeStopRequesting(org.jitsi.impl.neomedia.rtp.translator.StreamRTPManagerDesc streamRTPManager,
                                long ssrc,
                                byte[] buf,
                                int off,
                                int len)

Notifies this instance that an RTP packet has been received from a peer represented by a specific StreamRTPManagerDesc.

Parameters:

streamRTPManager - a StreamRTPManagerDesc which identifies the peer from which an RTP packet has been received

buf - the buffer which contains the bytes of the received RTP or RTCP packet

off - the zero-based index in buf at which the bytes of the received RTP or RTCP packet begin

len - the number of bytes in buf beginning at off which represent the received RTP or RTCP packet