RTP_Session Class Reference

#include <rtp.h>

Inheritance diagram for RTP_Session:

List of all members.


Call back functions
enum	SendReceiveStatus { e_ProcessPacket, e_IgnorePacket, e_AbortTransport }
virtual SendReceiveStatus	OnSendData (RTP_DataFrame &frame)
virtual SendReceiveStatus	OnReceiveData (const RTP_DataFrame &frame)
virtual SendReceiveStatus	OnReceiveControl (RTP_ControlFrame &frame)
	PARRAY (ReceiverReportArray, ReceiverReport)
virtual void	OnRxSenderReport (const SenderReport &sender, const ReceiverReportArray &reports)
virtual void	OnRxReceiverReport (DWORD src, const ReceiverReportArray &reports)
	PARRAY (SourceDescriptionArray, SourceDescription)
virtual void	OnRxSourceDescription (const SourceDescriptionArray &descriptions)
virtual void	OnRxGoodbye (const PDWORDArray &sources, const PString &reason)
virtual void	OnRxApplDefined (const PString &type, unsigned subtype, DWORD src, const BYTE *data, PINDEX size)
Public Member Functions
Construction
	RTP_Session (unsigned id, RTP_UserData *userData=NULL, BOOL autoDeleteUserData=TRUE)
	~RTP_Session ()
Operations
void	SetJitterBufferSize (unsigned minJitterDelay, unsigned maxJitterDelay, unsigned timeUnits=8, PINDEX stackSize=30000)
unsigned	GetJitterBufferSize () const
unsigned	GetJitterTimeUnits () const
virtual BOOL	ModifyQOS (RTP_QOS *)
BOOL	ReadBufferedData (DWORD timestamp, RTP_DataFrame &frame)
virtual BOOL	ReadData (RTP_DataFrame &frame)=0
virtual BOOL	WriteData (RTP_DataFrame &frame)=0
virtual BOOL	WriteControl (RTP_ControlFrame &frame)=0
virtual BOOL	SendReport ()
virtual void	Close (BOOL reading)=0
virtual void	Reopen (BOOL isReading)=0
virtual PString	GetLocalHostName ()=0
Member variable access
unsigned	GetSessionID () const
PString	GetCanonicalName () const
void	SetCanonicalName (const PString &name)
PString	GetToolName () const
void	SetToolName (const PString &name)
RTP_UserData *	GetUserData () const
void	SetUserData (RTP_UserData *data, BOOL autoDeleteUserData=TRUE)
DWORD	GetSyncSourceOut () const
void	IncrementReference ()
BOOL	DecrementReference ()
BOOL	WillIgnoreOtherSources () const
void	SetIgnoreOtherSources (BOOL ignore)
BOOL	WillIgnoreOutOfOrderPackets () const
void	SetIgnoreOutOfOrderPackets (BOOL ignore)
const PTimeInterval &	GetReportTimeInterval ()
void	SetReportTimeInterval (const PTimeInterval &interval)
unsigned	GetTxStatisticsInterval ()
void	SetTxStatisticsInterval (unsigned packets)
unsigned	GetRxStatisticsInterval ()
void	SetRxStatisticsInterval (unsigned packets)
DWORD	GetPacketsSent () const
DWORD	GetOctetsSent () const
DWORD	GetPacketsReceived () const
DWORD	GetOctetsReceived () const
DWORD	GetPacketsLost () const
DWORD	GetPacketsOutOfOrder () const
DWORD	GetPacketsTooLate () const
DWORD	GetAverageSendTime () const
DWORD	GetMaximumSendTime () const
DWORD	GetMinimumSendTime () const
DWORD	GetAverageReceiveTime () const
DWORD	GetMaximumReceiveTime () const
DWORD	GetMinimumReceiveTime () const
DWORD	GetAvgJitterTime () const
DWORD	GetMaxJitterTime () const
Protected Member Functions
void	AddReceiverReport (RTP_ControlFrame::ReceiverReport &receiver)
Protected Attributes
unsigned	sessionID
PString	canonicalName
PString	toolName
unsigned	referenceCount
RTP_UserData *	userData
BOOL	autoDeleteUserData
RTP_JitterBuffer *	jitter
BOOL	ignoreOtherSources
BOOL	ignoreOutOfOrderPackets
DWORD	syncSourceOut
DWORD	syncSourceIn
BOOL	allowSyncSourceInChange
BOOL	allowRemoteTransmitAddressChange
BOOL	allowSequenceChange
PTimeInterval	reportTimeInterval
unsigned	txStatisticsInterval
unsigned	rxStatisticsInterval
WORD	lastSentSequenceNumber
WORD	expectedSequenceNumber
DWORD	lastSentTimestamp
PTimeInterval	lastSentPacketTime
PTimeInterval	lastReceivedPacketTime
WORD	lastRRSequenceNumber
PINDEX	consecutiveOutOfOrderPackets
DWORD	packetsSent
DWORD	octetsSent
DWORD	packetsReceived
DWORD	octetsReceived
DWORD	packetsLost
DWORD	packetsOutOfOrder
DWORD	averageSendTime
DWORD	maximumSendTime
DWORD	minimumSendTime
DWORD	averageReceiveTime
DWORD	maximumReceiveTime
DWORD	minimumReceiveTime
DWORD	jitterLevel
DWORD	maximumJitterLevel
unsigned	txStatisticsCount
unsigned	rxStatisticsCount
DWORD	averageSendTimeAccum
DWORD	maximumSendTimeAccum
DWORD	minimumSendTimeAccum
DWORD	averageReceiveTimeAccum
DWORD	maximumReceiveTimeAccum
DWORD	minimumReceiveTimeAccum
DWORD	packetsLostSinceLastRR
DWORD	lastTransitTime
PMutex	reportMutex
PTimer	reportTimer
Classes
class	ReceiverReport
class	SenderReport
class	SourceDescription

Detailed Description

This class is for encpsulating the IETF Real Time Protocol interface.

Member Enumeration Documentation

enum RTP_Session::SendReceiveStatus

Enumeration values:

e_ProcessPacket

e_IgnorePacket

e_AbortTransport

Constructor & Destructor Documentation

RTP_Session::RTP_Session ( unsigned id,

RTP_UserData * userData = NULL,

BOOL autoDeleteUserData = TRUE

)

Create a new RTP session.
Parameters:

id Session ID for RTP channel

userData Optional data for session.

autoDeleteUserData Delete optional data with session.

RTP_Session::~RTP_Session ( )

Delete a session. This deletes the userData field if autoDeleteUserData is TRUE.

Member Function Documentation

void RTP_Session::AddReceiverReport ( RTP_ControlFrame::ReceiverReport & receiver ) [protected]

virtual void RTP_Session::Close ( BOOL reading ) [pure virtual]

Close down the RTP session.
Parameters:

reading Closing the read side of the session

Implemented in RTP_UDP.

BOOL RTP_Session::DecrementReference ( ) [inline]

Decrement reference count for RTP session.

DWORD RTP_Session::GetAverageReceiveTime ( ) const [inline]

Get average time between received packets. This is averaged over the last rxStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetAverageSendTime ( ) const [inline]

Get average time between sent packets. This is averaged over the last txStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetAvgJitterTime ( ) const [inline]

Get averaged jitter time for received packets. This is the calculated statistical variance of the interarrival time of received packets in milliseconds.

PString RTP_Session::GetCanonicalName ( ) const

Get the canonical name for the RTP session.

unsigned RTP_Session::GetJitterBufferSize ( ) const

Get current size of the jitter buffer. This returns the currently used jitter buffer delay in RTP timestamp units. It will be some value between the minimum and maximum set in the SetJitterBufferSize() function.

unsigned RTP_Session::GetJitterTimeUnits ( ) const

Get current time units of the jitter buffer.

virtual PString RTP_Session::GetLocalHostName ( ) [pure virtual]

Get the local host name as used in SDES packes.
Implemented in RTP_UDP.

DWORD RTP_Session::GetMaximumReceiveTime ( ) const [inline]

Get maximum time between received packets. This is over the last rxStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetMaximumSendTime ( ) const [inline]

Get maximum time between sent packets. This is over the last txStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetMaxJitterTime ( ) const [inline]

Get averaged jitter time for received packets. This is the maximum value of jitterLevel for the session.

DWORD RTP_Session::GetMinimumReceiveTime ( ) const [inline]

Get minimum time between received packets. This is over the last rxStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetMinimumSendTime ( ) const [inline]

Get minimum time between sent packets. This is over the last txStatisticsInterval packets and is in milliseconds.

DWORD RTP_Session::GetOctetsReceived ( ) const [inline]

Get total number of octets received in session.

DWORD RTP_Session::GetOctetsSent ( ) const [inline]

Get total number of octets sent in session.

DWORD RTP_Session::GetPacketsLost ( ) const [inline]

Get total number received packets lost in session.

DWORD RTP_Session::GetPacketsOutOfOrder ( ) const [inline]

Get total number of packets received out of order in session.

DWORD RTP_Session::GetPacketsReceived ( ) const [inline]

Get total number of packets received in session.

DWORD RTP_Session::GetPacketsSent ( ) const [inline]

Get total number of packets sent in session.

DWORD RTP_Session::GetPacketsTooLate ( ) const

Get total number received packets too late to go into jitter buffer.

const PTimeInterval& RTP_Session::GetReportTimeInterval ( ) [inline]

Get the time interval for sending RTCP reports in the session.

unsigned RTP_Session::GetRxStatisticsInterval ( ) [inline]

Get the interval for receiver statistics in the session.

unsigned RTP_Session::GetSessionID ( ) const [inline]

Get the ID for the RTP session.

DWORD RTP_Session::GetSyncSourceOut ( ) const [inline]

Get the source output identifier.

PString RTP_Session::GetToolName ( ) const

Get the tool name for the RTP session.

unsigned RTP_Session::GetTxStatisticsInterval ( ) [inline]

Get the interval for transmitter statistics in the session.

RTP_UserData* RTP_Session::GetUserData ( ) const [inline]

Get the user data for the session.

void RTP_Session::IncrementReference ( ) [inline]

Increment reference count for RTP session.

virtual BOOL RTP_Session::ModifyQOS ( RTP_QOS * ) [inline, virtual]

Modifies the QOS specifications for this RTP session
Reimplemented in RTP_UDP.

virtual SendReceiveStatus RTP_Session::OnReceiveControl ( RTP_ControlFrame & frame ) [virtual]

virtual SendReceiveStatus RTP_Session::OnReceiveData ( const RTP_DataFrame & frame ) [virtual]

virtual void RTP_Session::OnRxApplDefined ( const PString & type,

unsigned subtype,

DWORD src,

const BYTE * data,

PINDEX size

) [virtual]

virtual void RTP_Session::OnRxGoodbye ( const PDWORDArray & sources,

const PString & reason

) [virtual]

virtual void RTP_Session::OnRxReceiverReport ( DWORD src,

const ReceiverReportArray & reports

) [virtual]

virtual void RTP_Session::OnRxSenderReport ( const SenderReport & sender,

const ReceiverReportArray & reports

) [virtual]

virtual void RTP_Session::OnRxSourceDescription ( const SourceDescriptionArray & descriptions ) [virtual]

virtual SendReceiveStatus RTP_Session::OnSendData ( RTP_DataFrame & frame ) [virtual]

RTP_Session::PARRAY ( SourceDescriptionArray ,

SourceDescription

)

RTP_Session::PARRAY ( ReceiverReportArray ,

ReceiverReport

)

BOOL RTP_Session::ReadBufferedData ( DWORD timestamp,

RTP_DataFrame & frame

)

Read a data frame from the RTP channel. This function will conditionally read data from eth jitter buffer or directly if there is no jitter buffer enabled. An application should generally use this in preference to directly calling ReadData().
Parameters:

timestamp Timestamp to read from buffer.

frame Frame read from the RTP session

virtual BOOL RTP_Session::ReadData ( RTP_DataFrame & frame ) [pure virtual]

Read a data frame from the RTP channel. Any control frames received are dispatched to callbacks and are not returned by this function. It will block until a data frame is available or an error occurs.
Parameters:

frame Frame read from the RTP session

Implemented in RTP_UDP.

virtual void RTP_Session::Reopen ( BOOL isReading ) [pure virtual]

Reopens an existing session in the given direction.
Implemented in RTP_UDP.

virtual BOOL RTP_Session::SendReport ( ) [virtual]

Write the RTCP reports.

void RTP_Session::SetCanonicalName ( const PString & name )

Set the canonical name for the RTP session.

void RTP_Session::SetIgnoreOtherSources ( BOOL ignore ) [inline]

Indicate if will ignore all but first received SSRC value.
Parameters:

ignore Flag for ignore other SSRC values

void RTP_Session::SetIgnoreOutOfOrderPackets ( BOOL ignore ) [inline]

Indicate if will ignore out of order packets.
Parameters:

ignore Flag for ignore out of order packets

void RTP_Session::SetJitterBufferSize ( unsigned minJitterDelay,

unsigned maxJitterDelay,

unsigned timeUnits = 8,

PINDEX stackSize = 30000

)

Sets the size of the jitter buffer to be used by this RTP session. A session default to not having any jitter buffer enabled for reading and the ReadBufferedData() function simply calls ReadData(). Once a jitter buffer has been created it cannot be removed, though its size may be adjusted.
If the jitterDelay paramter is zero, it destroys the jitter buffer attached to this RTP session.
Parameters:

minJitterDelay Minimum jitter buffer delay in RTP timestamp units

maxJitterDelay Maximum jitter buffer delay in RTP timestamp units

timeUnits Time Units

stackSize Stack size for jitter thread

void RTP_Session::SetReportTimeInterval ( const PTimeInterval & interval ) [inline]

Set the time interval for sending RTCP reports in the session.
Parameters:

interval New time interval for reports.

void RTP_Session::SetRxStatisticsInterval ( unsigned packets )

Set the interval for receiver statistics in the session.
Parameters:

packets Number of packets between callbacks

void RTP_Session::SetToolName ( const PString & name )

Set the tool name for the RTP session.

void RTP_Session::SetTxStatisticsInterval ( unsigned packets )

Set the interval for transmitter statistics in the session.
Parameters:

packets Number of packets between callbacks

void RTP_Session::SetUserData ( RTP_UserData * data,

BOOL autoDeleteUserData = TRUE

)

Set the user data for the session.
Parameters:

data New user data to be used

autoDeleteUserData Delete optional data with session.

BOOL RTP_Session::WillIgnoreOtherSources ( ) const [inline]

Indicate if will ignore all but first received SSRC value.

BOOL RTP_Session::WillIgnoreOutOfOrderPackets ( ) const [inline]

Indicate if will ignore out of order packets.

virtual BOOL RTP_Session::WriteControl ( RTP_ControlFrame & frame ) [pure virtual]

Write a control frame from the RTP channel.
Parameters:

frame Frame to write to the RTP session

Implemented in RTP_UDP.

virtual BOOL RTP_Session::WriteData ( RTP_DataFrame & frame ) [pure virtual]

Write a data frame from the RTP channel.
Parameters:

frame Frame to write to the RTP session

Implemented in RTP_UDP.