org.jlibrtp

Interface RTCPAppIntf

All Known Implementing Classes:

RTPURLConnection

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

Modifier and Type	Method and Description
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