javax.media.rtp
Interface RTPControl


public interface RTPControl
extends Control

This interface is typically implemented by a RTP datasource. This interface will be used to control access to various RTP information via the datasource. e.g. dynamic payload-->EncodingName mapping can be established using this control. Reception statistics and current format being streamed on this datasource can also be queried.


Method Summary
 void addFormat(Format fmt, int payload)
          This method is used to add a dynamic payload ---> Format mapping in the RTPSessionManager.
 Format getFormat()
          Retrieves the Format object for the current stream.
 Format getFormat(int payload)
          Retrieves a format corresponding to the payload as stored by the session manager.
 Format[] getFormatList()
          Retrieves a complete list of all the formats set on this datasource.
 GlobalReceptionStats getGlobalStats()
          Query the RTP datasource for global RTP statistics
 ReceptionStats getReceptionStats()
          Query the RTP datasource for its data reception statistics
 
Methods inherited from interface javax.media.Control
getControlComponent
 

Method Detail

addFormat

public void addFormat(Format fmt,
                      int payload)
This method is used to add a dynamic payload ---> Format mapping in the RTPSessionManager. The RTPSessionManager maintains all static payload numbers and their correspnding Formats as mentioned in the Audio/Video profile document. Using the plugin packethandler interface, a user may plugin his own packetizer or depacketizer to handle RTP streams of a proprietary format using dynamic payload numbers as specified in the AV profile. Before streaming payload of a dynamic nature, a Format object needs to be created for the dynamic payload and associated with a dynamic payload number.

getReceptionStats

public ReceptionStats getReceptionStats()
Query the RTP datasource for its data reception statistics

getGlobalStats

public GlobalReceptionStats getGlobalStats()
Query the RTP datasource for global RTP statistics

getFormat

public Format getFormat()
Retrieves the Format object for the current stream. If this datasource has not received data as yet, null will be returned. This method provides a way for the application writer to query the datasource for the format it is currently streaming, since payload formats can be switched during the course of an RTP session.

getFormatList

public Format[] getFormatList()
Retrieves a complete list of all the formats set on this datasource. This is a collection of Format objects that were added by using addFormat() method.

getFormat

public Format getFormat(int payload)
Retrieves a format corresponding to the payload as stored by the session manager.


Submit a bug or feature
Copyright 1999-2000 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved. See the Specification License for more details.
Sun, Sun Microsystems, and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.