manager.html

JMF原版英文说明文档

</DD>
</DL>
<HR>

<A NAME="createRealizedPlayer(java.net.URL)"><!-- --></A><H3>
createRealizedPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createRealizedPlayer</B>(java.net.URL&nbsp;sourceURL)
                                   throws java.io.IOException,
                                          <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A>,
                                          <A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A></PRE>
<DL>
<DD>Create a Realized <code>Player</code> for the specified media.
 <p>
 This is a blocking method that creates a <code>Player</code>, calls
 realize on it and returns only after the <code>Player</code> has
 been Realized. Realizing a <code>Player</code> could be a time consuming
 operation and one should use caution when using this method as it
 could block the thread for several seconds.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ml</CODE> - The <code>MediaLocator</code> that describes the source of
 the media.<DT><B>Returns:</B><DD>A new <code>Player</code> that is in the <code>Realized</code>
 state.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A> - Thrown if a <code>Player</code> can't
 be created.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.<DD><A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A> - Thrown if there was a problem 
 realizing the Player.</DL>
</DD>
</DL>
<HR>

<A NAME="createRealizedPlayer(javax.media.MediaLocator)"><!-- --></A><H3>
createRealizedPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createRealizedPlayer</B>(<A HREF="../../javax/media/MediaLocator.html">MediaLocator</A>&nbsp;ml)
                                   throws java.io.IOException,
                                          <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A>,
                                          <A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A></PRE>
<DL>
<DD>Create a Realized <code>Player</code> for the specified media.
 <p>
 This is a blocking method that creates a <code>Player</code>, calls
 realize on it and returns only after the <code>Player</code> has
 been Realized. Realizing a <code>Player</code> could be a time consuming
 operation and one should use caution when using this method as it
 could block the thread for several seconds.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>ml</CODE> - The <code>MediaLocator</code> that describes the source of
 the media.<DT><B>Returns:</B><DD>A new <code>Player</code> that is in the <code>Realized</code>
 state.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A> - Thrown if a <code>Player</code> can't
 be created.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.<DD><A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A> - Thrown if there was a problem 
 realizing the Player.</DL>
</DD>
</DL>
<HR>

<A NAME="createRealizedPlayer(javax.media.protocol.DataSource)"><!-- --></A><H3>
createRealizedPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createRealizedPlayer</B>(<A HREF="../../javax/media/protocol/DataSource.html">DataSource</A>&nbsp;source)
                                   throws java.io.IOException,
                                          <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A>,
                                          <A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A></PRE>
<DL>
<DD>Create a Realized <code>Player</code> for the specified source.
 <p>
 This is a blocking method that creates a <code>Player</code>, calls
 realize on it and returns only after the <code>Player</code> has
 been Realized. Realizing a <code>Player</code> could be a time consuming
 operation and one should use caution when using this method as it
 could block the thread for several seconds.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>source</CODE> - The <code>DataSource</code> that describes the media
 content.<DT><B>Returns:</B><DD>A new <code>Player</code> that is in the <code>Realized</code>
 state.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A> - Thrown if a <code>Player</code> can't
 be created.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.<DD><A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A> - Thrown if there was a problem 
 realizing the Player.</DL>
</DD>
</DL>
<HR>

<A NAME="createProcessor(java.net.URL)"><!-- --></A><H3>
createProcessor</H3>
<PRE>
public static <A HREF="../../javax/media/Processor.html">Processor</A> <B>createProcessor</B>(java.net.URL&nbsp;sourceURL)
                                 throws java.io.IOException,
                                        <A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A></PRE>
<DL>
<DD>Create a <code>Processor</code> for the specified media.
 <p>
 The algorithm is similar to that for creating a <code>Player</code>
 from a <code>URL</code><DD><DL>
<DT><B>Parameters:</B><DD><CODE>sourceURL</CODE> - A <CODE>URL</CODE> that describes
 the media content.<DT><B>Returns:</B><DD>A <CODE>Processor</CODE> for the media described by the source.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A> - Thrown if no <CODE>Processor</CODE> can
 be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createProcessor(javax.media.MediaLocator)"><!-- --></A><H3>
createProcessor</H3>
<PRE>
public static <A HREF="../../javax/media/Processor.html">Processor</A> <B>createProcessor</B>(<A HREF="../../javax/media/MediaLocator.html">MediaLocator</A>&nbsp;sourceLocator)
                                 throws java.io.IOException,
                                        <A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A></PRE>
<DL>
<DD>Create a <code>Processor</code> for the specified media.
 <p>
 The algorithm is similar to that for creating a <code>Player</code>
 from a <code>MediaLocator</code><DD><DL>
<DT><B>Parameters:</B><DD><CODE>sourceLocator</CODE> - A <CODE>MediaLocator</CODE> that describes
 the media content.<DT><B>Returns:</B><DD>A <CODE>Processor</CODE> for the media described by the source.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A> - Thrown if no <CODE>Processor</CODE> can
 be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createProcessor(javax.media.protocol.DataSource)"><!-- --></A><H3>
createProcessor</H3>
<PRE>
public static <A HREF="../../javax/media/Processor.html">Processor</A> <B>createProcessor</B>(<A HREF="../../javax/media/protocol/DataSource.html">DataSource</A>&nbsp;source)
                                 throws java.io.IOException,
                                        <A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A></PRE>
<DL>
<DD>Create a <code>Processor</code> for the <code>DataSource</code>.
 <p>
 The algorithm for creating a <CODE>Processor</CODE> is similar
 to creating a <code>Player</code> from a <code>DataSource</code>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>DataSource</CODE> - The <CODE>DataSource</CODE> that describes
 the media content.<DT><B>Returns:</B><DD>A new <code>Processor</code>.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A> - Thrown if a <code>Processor</code> can't
 be created.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createRealizedProcessor(javax.media.ProcessorModel)"><!-- --></A><H3>
createRealizedProcessor</H3>
<PRE>
public static <A HREF="../../javax/media/Processor.html">Processor</A> <B>createRealizedProcessor</B>(<A HREF="../../javax/media/ProcessorModel.html">ProcessorModel</A>&nbsp;model)
                                         throws java.io.IOException,
                                                <A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A>,
                                                <A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A></PRE>
<DL>
<DD>Create a Realized <code>Processor</code> for the specified
 <code>ProcessorModel</code>.
 <P>
 This method accepts a <code>ProcessorModel</code> that describes
 the required input and/or output format of the media data. It is a
 blocking method and returns only after the <code>Processor</code>
 reaches the <code>Realized</code> state.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>model</CODE> - The <code>ProcessorModel</code> that describes the input and
 output media<DT><B>Returns:</B><DD>A new <code>Processor</code> that is in the <code>Realized</code>
 state.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoProcessorException.html">NoProcessorException</A> - Thrown if a <code>Processor</code> can't
 be created.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.<DD><A HREF="../../javax/media/CannotRealizeException.html">CannotRealizeException</A> - Thrown if there was a problem 
 realizing the Player.<DT><B>See Also: </B><DD><A HREF="../../javax/media/ProcessorModel.html"><CODE>ProcessorModel</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="createDataSource(java.net.URL)"><!-- --></A><H3>
createDataSource</H3>
<PRE>
public static <A HREF="../../javax/media/protocol/DataSource.html">DataSource</A> <B>createDataSource</B>(java.net.URL&nbsp;sourceURL)
                                   throws java.io.IOException,
                                          <A HREF="../../javax/media/NoDataSourceException.html">NoDataSourceException</A></PRE>
<DL>
<DD>Create a <code>DataSource</code> for the specified media.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sourceURL</CODE> - The <CODE>URL</CODE> that describes the media data.<DT><B>Returns:</B><DD>A new <CODE>DataSource</CODE> for the media.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoDataSourceException.html">NoDataSourceException</A> - Thrown if no <code>DataSource</code>
 can be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createDataSource(javax.media.MediaLocator)"><!-- --></A><H3>
createDataSource</H3>
<PRE>
public static <A HREF="../../javax/media/protocol/DataSource.html">DataSource</A> <B>createDataSource</B>(<A HREF="../../javax/media/MediaLocator.html">MediaLocator</A>&nbsp;sourceLocator)
                                   throws java.io.IOException,
                                          <A HREF="../../javax/media/NoDataSourceException.html">NoDataSourceException</A></PRE>
<DL>
<DD>Create a <code>DataSource</code> for the specified media.
 <p>

 Returns a data source for the protocol specified by
 the <CODE>MediaLocator</CODE>. The returned data source
 is <i>connected</i>; <code>DataSource.connect</code> has been
 invoked.
 <p>

 The algorithm for creating a <code>DataSource</code> from
 a <code>MediaLocator</code> is:
 <ol>
 <li>Get the protocol from the <code>MediaLocator</code>.
 <li>Use the protocol package-prefix list to get a list of 
 <code>DataSource</code> classes that
 support the protocol.
 <li> For each source class in the list:
 <ol>
 <li>Instantiate a new <code>DataSource</code>.
 <li>Call <code>connect</code> to connect the source.
 <li>If there are no errors, return the connected
 source; otherwise, try the next source in the list.
 </ol>
 <li>If no source has been found, obtain a <code>URL</code> from the
 <code>MediaLocator</code> and use it to create
 a <code>URLDataSource</code>
 <li>If no source can be found, a <CODE>NoDataSourceException</CODE>
 is thrown.
 </ol><DD><DL>
<DT><B>Parameters:</B><DD><CODE>sourceLocator</CODE> - The source protocol for the media data.<DT><B>Returns:</B><DD>A connected <CODE>DataSource</CODE>.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoDataSourceException.html">NoDataSourceException</A> - Thrown if no <CODE>DataSource</CODE>
 can be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createMergingDataSource(javax.media.protocol.DataSource[])"><!-- --></A><H3>
createMergingDataSource</H3>
<PRE>
public static <A HREF="../../javax/media/protocol/DataSource.html">DataSource</A> <B>createMergingDataSource</B>(<A HREF="../../javax/media/protocol/DataSource.html">DataSource</A>[]&nbsp;sources)
                                          throws <A HREF="../../javax/media/IncompatibleSourceException.html">IncompatibleSourceException</A></PRE>
<DL>
<DD>Creates a merged <code>DataSource</code> from an array of sources. 
 All sources must be of the same type (i.e <code>PullDataSource</code>,
 <code>PushDataSource</code>, etc.) otherwise an
 IncompatibleSourceException is thrown.
 The returned <code>DataSource</code> is of the same type of 
 the given sources. Its content-type is RAW if all sources are of 
 type RAW. Otherwise, its content-type is MIXED.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sources</CODE> - the <code>DataSources</code> to be merged<DT><B>Returns:</B><DD>a <code>DataSource</code> which contains all the streams 
 of the original sources<DT><B>Throws:</B><DD><A HREF="../../javax/media/IncompatibleSourceException.html">IncompatibleSourceException</A> - if the sources are not 
 of the same type</DL>
</DD>
</DL>
<HR>

<A NAME="createCloneableDataSource(javax.media.protocol.DataSource)"><!-- --></A><H3>
createCloneableDataSource</H3>
<PRE>
public static <A HREF="../../javax/media/protocol/DataSource.html">DataSource</A> <B>createCloneableDataSource</B>(<A HREF="../../javax/media/protocol/DataSource.html">DataSource</A>&nbsp;source)</PRE>
<DL>
<DD>Creates a cloneable <code>DataSource</code>. The returned 
 <code>DataSource</code> implements the <code>SourceCloneable</code> 
 interface and enables the creation of clones by the createClone method.
 <br> 
 If the input <code>DataSource</code> implements
 <code>SourceCloneable</code>, it will be returned right away
 as the result.  Otherwise, a "proxy" <code>DataSource</code> is
 created.  It implements the <code>SourceCloneable</code> interface and
 can be used to generate other clones.
 <br>
 When <code>createCloneableDataSource</code> is called on a
 <code>DataSource</code>, the returned <code>DataSource</code> should