RTP_Session Class Reference

#include <rtp.h>

Inheritance diagram for RTP_Session:


Call back functions
enum	SendReceiveStatus { e_ProcessPacket, e_IgnorePacket, e_AbortTransport }
virtual SendReceiveStatus	OnSendData (RTP_DataFrame &frame)
virtual SendReceiveStatus	Internal_OnSendData (RTP_DataFrame &frame)
virtual SendReceiveStatus	OnSendControl (RTP_ControlFrame &frame, PINDEX &len)
virtual SendReceiveStatus	Internal_OnSendControl (RTP_ControlFrame &frame, PINDEX &len)
virtual SendReceiveStatus	OnReceiveData (RTP_DataFrame &frame)
virtual SendReceiveStatus	Internal_OnReceiveData (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
virtual void	SetCloseOnBYE (PBoolean v)
virtual void	SendIntraFrameRequest ()
void	SetNextSentSequenceNumber (WORD num)
virtual PString	GetEncoding () const
virtual void	SetEncoding (const PString &newEncoding)
DWORD	GetSyncSourceIn () const
void	SetFailed (bool v)
bool	HasFailed () const
void	AddFilter (const PNotifier &filter)
Operations
void	SetJitterBufferSize (unsigned minJitterDelay, unsigned maxJitterDelay, unsigned timeUnits=8, PINDEX stackSize=30000)
unsigned	GetJitterBufferSize () const
unsigned	GetJitterTimeUnits () const
virtual PBoolean	ModifyQOS (RTP_QOS *)
virtual PBoolean	ReadBufferedData (RTP_DataFrame &frame)
virtual PBoolean	ReadData (RTP_DataFrame &frame, PBoolean loop)=0
virtual PBoolean	WriteData (RTP_DataFrame &frame)=0
virtual PBoolean	WriteOOBData (RTP_DataFrame &frame, bool rewriteTimeStamp=true)
virtual PBoolean	WriteControl (RTP_ControlFrame &frame)=0
virtual PBoolean	SendReport ()
virtual void	Close (PBoolean reading)=0
virtual void	Reopen (PBoolean isReading)=0
virtual PString	GetLocalHostName ()=0
Member variable access
unsigned	GetSessionID () const
bool	IsAudio () const
void	SetAudio (bool aud)
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, PBoolean autoDeleteUserData=PTrue)
DWORD	GetSyncSourceOut () const
bool	AllowAnySyncSource () const
void	SetAnySyncSource (bool allow)
PBoolean	WillIgnoreOutOfOrderPackets () const
void	SetIgnoreOutOfOrderPackets (PBoolean ignore)
void	SetIgnorePayloadTypeChanges (PBoolean ignore)
const PTimeInterval &	GetReportTimeInterval ()
void	SetReportTimeInterval (const PTimeInterval &interval)
PTimeInterval	GetReportTimer ()
unsigned	GetTxStatisticsInterval ()
void	SetTxStatisticsInterval (unsigned packets)
unsigned	GetRxStatisticsInterval ()
void	SetRxStatisticsInterval (unsigned packets)
void	ClearStatistics ()
DWORD	GetPacketsSent () const
DWORD	GetOctetsSent () const
DWORD	GetPacketsReceived () const
DWORD	GetOctetsReceived () const
DWORD	GetPacketsLost () const
DWORD	GetPacketsOutOfOrder () const
DWORD	GetPacketsTooLate () const
DWORD	GetPacketOverruns () const
DWORD	GetAverageSendTime () const
DWORD	GetMarkerRecvCount () const
DWORD	GetMarkerSendCount () const
DWORD	GetMaximumSendTime () const
DWORD	GetMinimumSendTime () const
DWORD	GetAverageReceiveTime () const
DWORD	GetMaximumReceiveTime () const
DWORD	GetMinimumReceiveTime () const
DWORD	GetAvgJitterTime () const
DWORD	GetMaxJitterTime () const
Functions added to support RTP aggregation
virtual int	GetDataSocketHandle () const
virtual int	GetControlSocketHandle () const
Protected Types
typedef PSafePtr< RTP_JitterBuffer, PSafePtrMultiThreaded >	JitterBufferPtr
Protected Member Functions
virtual void	SendBYE ()
void	AddReceiverReport (RTP_ControlFrame::ReceiverReport &receiver)
PBoolean	InsertReportPacket (RTP_ControlFrame &report)
Protected Attributes
PString	m_encoding
PMutex	m_encodingMutex
RTP_Encoding *	m_encodingHandler
unsigned	sessionID
bool	isAudio
PString	canonicalName
PString	toolName
RTP_UserData *	userData
PBoolean	autoDeleteUserData
JitterBufferPtr	m_jitterBuffer
PBoolean	ignoreOutOfOrderPackets
DWORD	syncSourceOut
DWORD	syncSourceIn
DWORD	lastSentTimestamp
bool	allowAnySyncSource
bool	allowOneSyncSourceChange
PBoolean	allowRemoteTransmitAddressChange
PBoolean	allowSequenceChange
PTimeInterval	reportTimeInterval
unsigned	txStatisticsInterval
unsigned	rxStatisticsInterval
WORD	lastSentSequenceNumber
WORD	expectedSequenceNumber
PTimeInterval	lastSentPacketTime
PTimeInterval	lastReceivedPacketTime
WORD	lastRRSequenceNumber
PINDEX	consecutiveOutOfOrderPackets
PMutex	dataMutex
DWORD	timeStampOffs
PBoolean	oobTimeStampBaseEstablished
DWORD	oobTimeStampOutBase
PTimeInterval	oobTimeStampBase
DWORD	packetsSent
DWORD	rtcpPacketsSent
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
DWORD	markerSendCount
DWORD	markerRecvCount
unsigned	txStatisticsCount
unsigned	rxStatisticsCount
DWORD	averageSendTimeAccum
DWORD	maximumSendTimeAccum
DWORD	minimumSendTimeAccum
DWORD	averageReceiveTimeAccum
DWORD	maximumReceiveTimeAccum
DWORD	minimumReceiveTimeAccum
DWORD	packetsLostSinceLastRR
DWORD	lastTransitTime
RTP_DataFrame::PayloadTypes	lastReceivedPayloadType
PBoolean	ignorePayloadTypeChanges
PMutex	reportMutex
PTimer	reportTimer
PBoolean	closeOnBye
PBoolean	byeSent
bool	failed
	set to true if session has received too many ICMP destination unreachable
PList< Filter >	filters
Friends
class	EncodingLock
Classes
class	EncodingLock
class	Filter
struct	Params
class	ReceiverReport
class	SenderReport
class	SourceDescription

Detailed Description

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

Member Typedef Documentation

typedef PSafePtr<RTP_JitterBuffer, PSafePtrMultiThreaded> RTP_Session::JitterBufferPtr [protected]

Member Enumeration Documentation

enum RTP_Session::SendReceiveStatus

Enumerator:

e_ProcessPacket
e_IgnorePacket
e_AbortTransport

Constructor & Destructor Documentation

RTP_Session::RTP_Session ( const Params & options )

Create a new RTP session.

Parameters:

options

Parameters to construct with session.

RTP_Session::~RTP_Session ( )

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

RTP_Session::RTP_Session ( const Params & options )

Create a new RTP session.

Parameters:

options

Parameters to construct with session.

RTP_Session::~RTP_Session ( )

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

Member Function Documentation

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

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 PBoolean RTP_Session::ModifyQOS ( RTP_QOS * ) [inline, virtual]

Modifies the QOS specifications for this RTP session

Reimplemented in RTP_UDP.

virtual PBoolean RTP_Session::ReadBufferedData ( RTP_DataFrame & frame ) [virtual]

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

Parameters:

frame

Frame read from the RTP session

virtual PBoolean RTP_Session::ReadData	(	RTP_DataFrame &	frame,
		PBoolean	loop
	)			`[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
loop	If PTrue, loop as long as data is available, if PFalse, only process once

Implemented in RTP_UDP.

virtual PBoolean 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.

virtual PBoolean RTP_Session::WriteOOBData	(	RTP_DataFrame &	frame,
		bool	rewriteTimeStamp = `true`
	)			`[virtual]`

Write data frame to the RTP channel outside the normal stream of media Used for RFC2833 packets

Reimplemented in RTP_UDP.

virtual PBoolean 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 PBoolean RTP_Session::SendReport ( ) [virtual]

Write the RTCP reports.

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

Close down the RTP session.

Parameters:

reading

Closing the read side of the session

Implemented in RTP_UDP.

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

Reopens an existing session in the given direction.

Implemented in RTP_UDP.

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

Get the local host name as used in SDES packes.

Implemented in RTP_UDP.

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

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

virtual SendReceiveStatus RTP_Session::OnSendControl	(	RTP_ControlFrame &	frame,
		PINDEX &	len
	)			`[virtual]`

virtual SendReceiveStatus RTP_Session::Internal_OnSendControl	(	RTP_ControlFrame &	frame,
		PINDEX &	len
	)			`[virtual]`

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

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

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

RTP_Session::PARRAY	(	ReceiverReportArray	,
		ReceiverReport
	)

virtual void RTP_Session::OnRxSenderReport	(	const SenderReport &	sender,
		const ReceiverReportArray &	reports
	)			`[virtual]`

virtual void RTP_Session::OnRxReceiverReport	(	DWORD	src,
		const ReceiverReportArray &	reports
	)			`[virtual]`

RTP_Session::PARRAY	(	SourceDescriptionArray	,
		SourceDescription
	)

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

virtual void RTP_Session::OnRxGoodbye	(	const PDWORDArray &	sources,
		const PString &	reason
	)			`[virtual]`

virtual void RTP_Session::OnRxApplDefined	(	const PString &	type,
		unsigned	subtype,
		DWORD	src,
		const BYTE *	data,
		PINDEX	size
	)			`[virtual]`

unsigned RTP_Session::GetSessionID ( ) const [inline]

Get the ID for the RTP session.

bool RTP_Session::IsAudio ( ) const [inline]

Get flag for is audio RTP.

void RTP_Session::SetAudio ( bool aud ) [inline]

Set flag for RTP session is audio.

Parameters:

aud

New audio indication flag

PString RTP_Session::GetCanonicalName ( ) const

Get the canonical name for the RTP session.

void RTP_Session::SetCanonicalName ( const PString & name )

Set the canonical name for the RTP session.

PString RTP_Session::GetToolName ( ) const

Get the tool name for the RTP session.

void RTP_Session::SetToolName ( const PString & name )

Set the tool name for the RTP session.

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

Get the user data for the session.

void RTP_Session::SetUserData	(	RTP_UserData *	data,
		PBoolean	autoDeleteUserData = `PTrue`
	)

Set the user data for the session.

Parameters:

data	New user data to be used
autoDeleteUserData	Delete optional data with session.

DWORD RTP_Session::GetSyncSourceOut ( ) const [inline]

Get the source output identifier.

bool RTP_Session::AllowAnySyncSource ( ) const [inline]

Indicate if will ignore all but first received SSRC value.

void RTP_Session::SetAnySyncSource ( bool allow ) [inline]

Indicate if will ignore all but first received SSRC value.

Parameters:

allow

Flag for allow any SSRC values

PBoolean RTP_Session::WillIgnoreOutOfOrderPackets ( ) const [inline]

Indicate if will ignore out of order packets.

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

Indicate if will ignore out of order packets.

Parameters:

ignore

Flag for ignore out of order packets

void RTP_Session::SetIgnorePayloadTypeChanges ( PBoolean ignore ) [inline]

Indicate if will ignore rtp payload type changes in received packets.

Parameters:

ignore

Flag to ignore payload type changes

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

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

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.

PTimeInterval RTP_Session::GetReportTimer ( ) [inline]

Get the current report timer

unsigned RTP_Session::GetTxStatisticsInterval ( ) [inline]

Get the interval for transmitter statistics in the session.

void RTP_Session::SetTxStatisticsInterval ( unsigned packets )

Set the interval for transmitter statistics in the session.

Parameters:

packets

Number of packets between callbacks

unsigned RTP_Session::GetRxStatisticsInterval ( ) [inline]

Get the interval for receiver statistics in the session.

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::ClearStatistics ( )

Clear statistics

DWORD RTP_Session::GetPacketsSent ( ) const [inline]

Get total number of packets sent in session.

DWORD RTP_Session::GetOctetsSent ( ) const [inline]

Get total number of octets sent in session.

DWORD RTP_Session::GetPacketsReceived ( ) const [inline]

Get total number of packets received in session.

DWORD RTP_Session::GetOctetsReceived ( ) const [inline]

Get total number of octets received 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::GetPacketsTooLate ( ) const

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

DWORD RTP_Session::GetPacketOverruns ( ) const

Get total number received packets that could not fit into the jitter buffer.

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::GetMarkerRecvCount ( ) const [inline]

Get the number of marker packets received this session. This can be used to find out the number of frames received in a video RTP stream.

DWORD RTP_Session::GetMarkerSendCount ( ) const [inline]

Get the number of marker packets sent this session. This can be used to find out the number of frames sent in a video RTP stream.

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::GetMinimumSendTime ( ) const [inline]

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

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::GetMaximumReceiveTime ( ) const [inline]

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

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::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.

DWORD RTP_Session::GetMaxJitterTime ( ) const [inline]

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

virtual int RTP_Session::GetDataSocketHandle ( ) const [inline, virtual]

Reimplemented in RTP_UDP.

virtual int RTP_Session::GetControlSocketHandle ( ) const [inline, virtual]

Reimplemented in RTP_UDP.

virtual void RTP_Session::SetCloseOnBYE ( PBoolean v ) [inline, virtual]

virtual void RTP_Session::SendIntraFrameRequest ( ) [virtual]

Tell the rtp session to send out an intra frame request control packet. This is called when the media stream receives an OpalVideoUpdatePicture media command.

void RTP_Session::SetNextSentSequenceNumber ( WORD num ) [inline]