org.web3d.vrtp.rtp
Class RtpMonitorManager

java.lang.Object
  |
  +--org.web3d.vrtp.rtp.RtpMonitorManager

All Implemented Interfaces:

java.util.EventListener, javax.media.rtp.ReceiveStreamListener

public class RtpMonitorManager

extends java.lang.Object

implements javax.media.rtp.ReceiveStreamListener

A class that encapsulates all operations necessary to start a new monitoring session, play its streams, and record statistical data.

This class does not display statistics on screen. That must be done by another class, usually a frame, using data from a SessionManager object ( see method getSessionManager ).

Version:

1.0

Author:

Francisco Afonso (afonso@cs.nps.navy.mil)

Constructor Summary

RtpMonitorManager(java.lang.String locatorString, boolean willParticipate, boolean willPlayStreams, boolean willRecord, double recordInterval)

Method Summary

void	close() Closes a monitor session, stops recording and closes player windows
RtpMediaLocator	getMediaLocator() Returns the RtpMediaLocator associated with the RTP session
javax.media.rtp.SessionAddress	getSessionAddress() Returns the SessionAddress object associated with the RTP session
javax.media.rtp.SessionManager	getSessionManager() Returns the SessionManager object created by the monitor
void	update(javax.media.rtp.event.ReceiveStreamEvent event) Method of classes that implement the ReceiveStreamListener interface

Methods inherited from class java.lang.Object

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

Constructor Detail

RtpMonitorManager

public RtpMonitorManager(java.lang.String locatorString,
                         boolean willParticipate,
                         boolean willPlayStreams,
                         boolean willRecord,
                         double recordInterval)
                  throws java.net.MalformedURLException,
                         java.net.UnknownHostException,
                         javax.media.rtp.SessionManagerException,
                         java.io.IOException

Parameters:

locatorString - the session description string format, e.g. rtp://224.2.134.67:50980/127

willParticipate - true if the Monitor will participate in the session, sending RTCP packets, false otherwise.

willPlayStreams - true if the Monitor will play the receiving streams, false otherwise.

willRecord - true if the Monitor will record statistical data about the session, false otherwise.

recordInterval - the time between data recordings in seconds

Throws:

java.net.MalformedURLException - if the locatorString argument does not conform to the syntax.

java.net.UnknownHostException - if InetAddress.getByName(session address) fails

javax.media.rtp.SessionManagerException - Exception thrown when there is an error starting an RTPSessionManager

java.io.IOException - Exception thrown when there is an error in RTPSessionManager

Method Detail

update

public void update(javax.media.rtp.event.ReceiveStreamEvent event)

Method of classes that implement the ReceiveStreamListener interface

Specified by:

update in interface javax.media.rtp.ReceiveStreamListener

close

public void close()

Closes a monitor session, stops recording and closes player windows

getMediaLocator

public RtpMediaLocator getMediaLocator()

Returns the RtpMediaLocator associated with the RTP session

Returns:

the session media locator

getSessionManager

public javax.media.rtp.SessionManager getSessionManager()

Returns the SessionManager object created by the monitor

Returns:

the SessionManager (RTPSessionMgr)

getSessionAddress

public javax.media.rtp.SessionAddress getSessionAddress()

Returns the SessionAddress object associated with the RTP session

Returns:

the SessionAddress