jlibrtp
Interface RTCPAppIntf


public interface RTCPAppIntf

This is the callback interface for RTCP packets. It is optional, you do not have to register it. If there are specific events you wish to ignore, you can simply implement empty functions. These are all syncrhonous, make sure to return quickly or do the handling in a new thread.

Author:
Arne Kepp

Method Summary
 void APPPktReceived(Participant part, int subtype, byte[] name, byte[] data)
          This function is called whenever an Application (APP) packet is received.
 void BYEPktReceived(Participant[] relevantParticipants, java.lang.String reason)
          This function is called whenever a Bye (BYE) packet is received.
 void RRPktReceived(long reporterSsrc, long[] reporteeSsrc, int[] lossFraction, int[] cumulPacketsLost, long[] extHighSeq, long[] interArrivalJitter, long[] lastSRTimeStamp, long[] delayLastSR)
          This function is called whenever a Receiver Report (SR) packet is received and returns unmodified values.
 void SDESPktReceived(Participant[] relevantParticipants)
          This function is called whenever a Source Description (SDES) packet is received.
 void SRPktReceived(long ssrc, long ntpHighOrder, long ntpLowOrder, long rtpTimestamp, long packetCount, long octetCount, long[] reporteeSsrc, int[] lossFraction, int[] cumulPacketsLost, long[] extHighSeq, long[] interArrivalJitter, long[] lastSRTimeStamp, long[] delayLastSR)
          This function is called whenever a Sender Report (SR) packet is received and returns unmodified values.
 

Method Detail

SRPktReceived

void SRPktReceived(long ssrc,
                   long ntpHighOrder,
                   long ntpLowOrder,
                   long rtpTimestamp,
                   long packetCount,
                   long octetCount,
                   long[] reporteeSsrc,
                   int[] lossFraction,
                   int[] cumulPacketsLost,
                   long[] extHighSeq,
                   long[] interArrivalJitter,
                   long[] lastSRTimeStamp,
                   long[] delayLastSR)
This function is called whenever a Sender Report (SR) packet is received and returns unmodified values. A sender report may optionally include Receiver Reports (RR), which are returned as arrays. Index i corresponds to the same report throughout all of the arrays.

Parameters:
ssrc - the (SR) SSRC of the sender
ntpHighOrder - (SR) NTP high order
ntpLowOrder - (SR) NTP low order
rtpTimestamp - (SR) RTP timestamp corresponding to the NTP timestamp
packetCount - (SR) Packets sent since start of session
octetCount - (SR) Octets sent since start of session
reporteeSsrc - (RR) SSRC of sender the receiver is reporting in
lossFraction - (RR) Loss fraction, see RFC 3550
cumulPacketsLost - (RR) Cumulative number of packets lost
extHighSeq - (RR) Extended highest sequence RTP packet received
interArrivalJitter - (RR) Interarrival jitter, see RFC 3550
lastSRTimeStamp - (RR) RTP timestamp when last SR was received
delayLastSR - (RR) Delay, in RTP, since last SR was received

RRPktReceived

void RRPktReceived(long reporterSsrc,
                   long[] reporteeSsrc,
                   int[] lossFraction,
                   int[] cumulPacketsLost,
                   long[] extHighSeq,
                   long[] interArrivalJitter,
                   long[] lastSRTimeStamp,
                   long[] delayLastSR)
This function is called whenever a Receiver Report (SR) packet is received and returns unmodified values. A receiver report may optionally include report blocks, which are returned as arrays. Index i corresponds to the same report throughout all of the arrays.

Parameters:
reporterSsrc - SSRC of the receiver reporting
reporteeSsrc - (RR) SSRC of sender the receiver is reporting in
lossFraction - (RR) Loss fraction, see RFC 3550
cumulPacketsLost - (RR) Cumulative number of packets lost
extHighSeq - (RR) Extended highest sequence RTP packet received
interArrivalJitter - (RR) Interarrival jitter, see RFC 3550
lastSRTimeStamp - (RR) RTP timestamp when last SR was received
delayLastSR - (RR) Delay, in RTP, since last SR was received

SDESPktReceived

void SDESPktReceived(Participant[] relevantParticipants)
This function is called whenever a Source Description (SDES) packet is received. It currently returns the updated participants AFTER they have been updated.

Parameters:
relevantParticipants - participants mentioned in the SDES packet

BYEPktReceived

void BYEPktReceived(Participant[] relevantParticipants,
                    java.lang.String reason)
This function is called whenever a Bye (BYE) packet is received. The participants will automatically be deleted from the participant database after some time, but in the mean time the application may still receive RTP packets from this source.

Parameters:
relevantParticipants - participants whose SSRC was in the packet
reason - the reason provided in the packet

APPPktReceived

void APPPktReceived(Participant part,
                    int subtype,
                    byte[] name,
                    byte[] data)
This function is called whenever an Application (APP) packet is received.

Parameters:
part - the participant associated with the SSRC
subtype - specified in the packet
name - ASCII description of packet
data - in the packet