manager.html

JMF原版英文说明文档

</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;<A HREF="../../javax/media/TimeBase.html">TimeBase</A></CODE></FONT></TD>
<TD><CODE><B><A HREF="../../javax/media/Manager.html#getSystemTimeBase()">getSystemTimeBase</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the time-base object for the system.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../javax/media/Manager.html#getVersion()">getVersion</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the version string for this revision of JMF.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../javax/media/Manager.html#setHint(int, java.lang.Object)">setHint</A></B>(int&nbsp;hint,
        java.lang.Object&nbsp;value)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Specify a hint for the <code>Manager</code> to use.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>clone, 
equals, 
finalize, 
getClass, 
hashCode, 
notify, 
notifyAll, 
toString, 
wait, 
wait, 
wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="MAX_SECURITY"><!-- --></A><H3>
MAX_SECURITY</H3>
<PRE>
public static final int <B>MAX_SECURITY</B></PRE>
<DL>
<DD>Boolean hint to turn on/off maximum security.</DL>
<HR>

<A NAME="CACHING"><!-- --></A><H3>
CACHING</H3>
<PRE>
public static final int <B>CACHING</B></PRE>
<DL>
<DD>Boolean hint to turn on/off the use of playback caching.</DL>
<HR>

<A NAME="LIGHTWEIGHT_RENDERER"><!-- --></A><H3>
LIGHTWEIGHT_RENDERER</H3>
<PRE>
public static final int <B>LIGHTWEIGHT_RENDERER</B></PRE>
<DL>
<DD>Boolean hint to turn on/off the use of light weight rendering.
 If on, the <code>Manager</code> will try to create
 <code>Players</code> that use renderers which can interoperate with 
 light weight GUI components.</DL>
<HR>

<A NAME="PLUGIN_PLAYER"><!-- --></A><H3>
PLUGIN_PLAYER</H3>
<PRE>
public static final int <B>PLUGIN_PLAYER</B></PRE>
<DL>
<DD>Boolean hint to request the <code>Manager</code> to create
 <code>Players</code> that support
 <code>PlugIns</code>.  Such <code>Players</code> use 
 <code>PlugIns</code> to demultiplex, decode, render or multiplex 
 the data.  It will also support <code>TrackControls</code> for
 application level programming.</DL>
<HR>

<A NAME="UNKNOWN_CONTENT_NAME"><!-- --></A><H3>
UNKNOWN_CONTENT_NAME</H3>
<PRE>
public static final java.lang.String <B>UNKNOWN_CONTENT_NAME</B></PRE>
<DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->


<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getVersion()"><!-- --></A><H3>
getVersion</H3>
<PRE>
public static java.lang.String <B>getVersion</B>()</PRE>
<DL>
<DD>Returns the version string for this revision of JMF.</DL>
<HR>

<A NAME="createPlayer(java.net.URL)"><!-- --></A><H3>
createPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createPlayer</B>(java.net.URL&nbsp;sourceURL)
                           throws java.io.IOException,
                                  <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A></PRE>
<DL>
<DD>Create a <CODE>Player</CODE> for the specified media.
 This creates a MediaLocator from the URL and then
 calls <CODE>createPlayer</CODE>.<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>Player</CODE>.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A> - Thrown if no <CODE>Player</CODE>
 can be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createPlayer(javax.media.MediaLocator)"><!-- --></A><H3>
createPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createPlayer</B>(<A HREF="../../javax/media/MediaLocator.html">MediaLocator</A>&nbsp;sourceLocator)
                           throws java.io.IOException,
                                  <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A></PRE>
<DL>
<DD>Create a <code>Player</code> for the specified media.
 <p>
 The algorithm for creating a <CODE>Player</CODE> from
 a <code>MediaLocator</code> is:
 <ol>
 <li>Get the protocol from the <code>MediaLocator</code>.
 <li>Get a list of <code>DataSource</code> classes that
 support the protocol, using the protocol package-prefix-list.
 <li> For each source class in the list:
 <ol>
 <li>Instantiate a new <code>DataSource</code>,
 <li>Call the <code>connect</code> method to connect the source.
 <li>Get the media content-type-name (using <code>getContentType</code>)
 from the source.
 <li>Get a list of <code>MediaHandler</code> classes that support the
 media-content-type-name, using the content package-prefix-list.
 <li>For each <code>MediaHandler</code> class in the list:
 <ol>
 <li>Instantiate a new <code>MediaHandler</code>.
 <li>Attach the source to the <code>MediaHandler</code> by calling
 <code>MediaHandler.setSource</code>.
 <li>If there are no failures, determine the type of
 the <code>MediaHandler</code>; otherwise try the next
 <coded>MediaHandler</code> in the list.
 <li>If the <code>MediaHandler</code> is a <code>Player</code>,
 return the new <code>Player</code>.
 <li>If the <code>MediaHandler</code> is a <code>MediaProxy</code>,
 obtain a new <code>DataSource</code> from the <code>MediaProxy</code>,
 obtain the list of <code>MediaHandlers</code> that support the new
 <code>DataSource</code>, and continue searching the new list.
 </ol>
 <li>If no <code>MediaHandler</code> is found for this source,
 try the next source in the list.
 </ol>
 <li>If no <code>Player</code> is found after trying all of the sources,
 reuse the source list.<br>
 This time, for each source class in the list:
 <ol>
 <li>Instantiate the source.
 <li>Call the <code>connect</code> method to connect to the source.
 <li>Use the content package-prefix-list to create a list of 
 <code>MediaHandler</code> classes that support the
 "unknown" content-type-name.
 <li>For each <code>MediaHandler</code> class in the list,
 search for a <code>Player</code> as in the previous search.
 <ol>
 <li>If no <code>Player</code> is found after trying all of the sources,
 a <CODE>NoPlayerException</CODE> is thrown.
 </ol>
 </ol><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>Player</CODE> for the media described by the source.<DT><B>Throws:</B><DD><A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A> - Thrown if no <CODE>Player</CODE> can
 be found.<DD>java.io.IOException - Thrown if there was a problem connecting
 with the source.</DL>
</DD>
</DL>
<HR>

<A NAME="createPlayer(javax.media.protocol.DataSource)"><!-- --></A><H3>
createPlayer</H3>
<PRE>
public static <A HREF="../../javax/media/Player.html">Player</A> <B>createPlayer</B>(<A HREF="../../javax/media/protocol/DataSource.html">DataSource</A>&nbsp;source)
                           throws java.io.IOException,
                                  <A HREF="../../javax/media/NoPlayerException.html">NoPlayerException</A></PRE>
<DL>
<DD>Create a <code>Player</code> for the <code>DataSource</code>.
 <p>
 The algorithm for creating a <CODE>Player</CODE> from
 a <code>DataSource</code> is:
 <ol>
 <li>Get the media content-type-name from the source by
 calling <code>getContentType</code>.
 <li>Use the content package-prefix-list to get a list of 
 <code>Player</code> classes that support the media content-type name.
 <li>For each <code>Player</code> class in the list:
 <ol>
 <li>Instantiate a new <code>Player</code>.
 <li>Attach the source to the <code>Player</code> by calling
 <code>setSource</code> on the <code>Player</code>.
 <li>If there are no failures,  return the new <code>Player</code>;
 otherwise,
 try the next <code>Player</code> in the list.
</ol>
 <li>If no <code>Player</code> is found for this source:
 <ol>
 <li>Use the content package-prefix-list to create a list 
 of <code>Player</code> classes that support the
 "unknown" content-type-name.
 <li>For each <code>Player</code> class in the list:
 <ol>
 <li>Instantiate a new <code>Player</code>.
 <li>Attach the source to the <code>Player</code> by
 calling <code>setSource</code> 
 on the <code>Player</code>.
 <li>If there are no failures, return the new <code>Player</code>;
 otherwise, try the next <code>Player</code> in the list.
 </ol>
 </ol>
 <li>If no <code>Player</code> can be created,
 a <CODE>NoPlayerException</CODE> is thrown.
 </ol><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>Player</code>.<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.</DL>