audiosystem.html

API資料大全

<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioFileFormat.html">AudioFileFormat</A> <B>getAudioFileFormat</B>(<A HREF="../../../java/io/File.html">File</A>&nbsp;file)
                                          throws <A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A>,
                                                 <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains the audio file format of the specified <code>File</code>.  The <code>File</code> must
 point to valid audio file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the <code>File</code> from which file format information should be
 extracted<DT><B>Returns:</B><DD>an <code>AudioFileFormat</code> object describing the audio file format<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A></CODE> - if the <code>File</code> does not point to valid audio
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="getAudioInputStream(java.io.InputStream)"><!-- --></A><H3>
getAudioInputStream</H3>
<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A> <B>getAudioInputStream</B>(<A HREF="../../../java/io/InputStream.html">InputStream</A>&nbsp;stream)
                                            throws <A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A>,
                                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains an audio input stream from the provided input stream.  The stream must
 point to valid audio file data.  The implementation of this method may 
 require multiple parsers to 
 examine the stream to determine whether they support it.  These parsers must
 be able to mark the stream, read enough data to determine whether they 
 support the stream, and, if not, reset the stream's read pointer to its original 
 position.  If the input stream does not support these operation, this method may fail
 with an <code>IOException</code>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the input stream from which the <code>AudioInputStream</code> should be
 constructed<DT><B>Returns:</B><DD>an <code>AudioInputStream</code> object based on the audio file data contained
 in the input stream.<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A></CODE> - if the stream does not point to valid audio
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs<DT><B>See Also: </B><DD><A HREF="../../../java/io/InputStream.html#markSupported()"><CODE>InputStream.markSupported()</CODE></A>, 
<A HREF="../../../java/io/InputStream.html#mark(int)"><CODE>InputStream.mark(int)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getAudioInputStream(java.net.URL)"><!-- --></A><H3>
getAudioInputStream</H3>
<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A> <B>getAudioInputStream</B>(<A HREF="../../../java/net/URL.html">URL</A>&nbsp;url)
                                            throws <A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A>,
                                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains an audio input stream from the URL provided.  The URL must
 point to valid audio file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>url</CODE> - the URL for which the <code>AudioInputStream</code> should be
 constructed<DT><B>Returns:</B><DD>an <code>AudioInputStream</code> object based on the audio file data pointed
 to by the URL<DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A></CODE> - if the URL does not point to valid audio
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="getAudioInputStream(java.io.File)"><!-- --></A><H3>
getAudioInputStream</H3>
<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A> <B>getAudioInputStream</B>(<A HREF="../../../java/io/File.html">File</A>&nbsp;file)
                                            throws <A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A>,
                                                   <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Obtains an audio input stream from the provided <code>File</code>.  The <code>File</code> must
 point to valid audio file data.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the <code>File</code> for which the <code>AudioInputStream</code> should be
 constructed<DT><B>Returns:</B><DD>an <code>AudioInputStream</code> object based on the audio file data pointed
 to by the <code>File</code><DT><B>Throws:</B><DD><CODE><A HREF="../../../javax/sound/sampled/UnsupportedAudioFileException.html">UnsupportedAudioFileException</A></CODE> - if the <code>File</code> does not point to valid audio
 file data recognized by the system<DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs</DL>
</DD>
</DL>
<HR>

<A NAME="getAudioFileTypes()"><!-- --></A><H3>
getAudioFileTypes</H3>
<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>[] <B>getAudioFileTypes</B>()</PRE>
<DL>
<DD>Obtains the file types for which file writing support is provided by the system.<DD><DL>
<DT><B>Returns:</B><DD>array of file types.  If no file types are supported, 
 an array of length 0 is returned.</DL>
</DD>
</DL>
<HR>

<A NAME="isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)"><!-- --></A><H3>
isFileTypeSupported</H3>
<PRE>
public static boolean <B>isFileTypeSupported</B>(<A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>&nbsp;fileType)</PRE>
<DL>
<DD>Indicates whether file writing support for the specified file type is provided
 by the system.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fileType</CODE> - the file type for which write capabilities are queried<DT><B>Returns:</B><DD><code>true</code> if the file type is supported, 
 otherwise <code>false</code></DL>
</DD>
</DL>
<HR>

<A NAME="getAudioFileTypes(javax.sound.sampled.AudioInputStream)"><!-- --></A><H3>
getAudioFileTypes</H3>
<PRE>
public static <A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>[] <B>getAudioFileTypes</B>(<A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A>&nbsp;stream)</PRE>
<DL>
<DD>Obtains the file types that the system can write from the
 audio input stream specified.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the audio input stream for which audio file type support
 is queried<DT><B>Returns:</B><DD>array of file types.  If no file types are supported, 
 an array of length 0 is returned.</DL>
</DD>
</DL>
<HR>

<A NAME="isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type, javax.sound.sampled.AudioInputStream)"><!-- --></A><H3>
isFileTypeSupported</H3>
<PRE>
public static boolean <B>isFileTypeSupported</B>(<A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>&nbsp;fileType,
                                          <A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A>&nbsp;stream)</PRE>
<DL>
<DD>Indicates whether an audio file of the specified file type can be written
 from the indicated audio input stream.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fileType</CODE> - the file type for which write capabilities are queried<DD><CODE>stream</CODE> - the stream for which file-writing support is queried<DT><B>Returns:</B><DD><code>true</code> if the file type is supported for this audio input stream, 
 otherwise <code>false</code></DL>
</DD>
</DL>
<HR>

<A NAME="write(javax.sound.sampled.AudioInputStream, javax.sound.sampled.AudioFileFormat.Type, java.io.OutputStream)"><!-- --></A><H3>
write</H3>
<PRE>
public static int <B>write</B>(<A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A>&nbsp;stream,
                        <A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>&nbsp;fileType,
                        <A HREF="../../../java/io/OutputStream.html">OutputStream</A>&nbsp;out)
                 throws <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Writes a stream of bytes representing an audio file of the specified file type
 to the output stream provided.  Some file types require that
 the length be written into the file header; such files cannot be written from
 start to finish unless the length is known in advance.  An attempt
 to write a file of such a type will fail with an IOException if the length in 
 the audio file type is <code>AudioSystem.NOT_SPECIFIED</code>.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the audio input stream containing audio data to be 
 written to the file<DD><CODE>fileType</CODE> - the kind of audio file to write<DD><CODE>out</CODE> - the stream to which the file data should be written<DT><B>Returns:</B><DD>the number of bytes written to the output stream<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an input/output exception occurs<DD><CODE><A HREF="../../../java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if the file type is not supported by
 the system<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/sampled/AudioSystem.html#isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)"><CODE>isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)</CODE></A>, 
<A HREF="../../../javax/sound/sampled/AudioSystem.html#getAudioFileTypes()"><CODE>getAudioFileTypes()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="write(javax.sound.sampled.AudioInputStream, javax.sound.sampled.AudioFileFormat.Type, java.io.File)"><!-- --></A><H3>
write</H3>
<PRE>
public static int <B>write</B>(<A HREF="../../../javax/sound/sampled/AudioInputStream.html">AudioInputStream</A>&nbsp;stream,
                        <A HREF="../../../javax/sound/sampled/AudioFileFormat.Type.html">AudioFileFormat.Type</A>&nbsp;fileType,
                        <A HREF="../../../java/io/File.html">File</A>&nbsp;out)
                 throws <A HREF="../../../java/io/IOException.html">IOException</A></PRE>
<DL>
<DD>Writes a stream of bytes representing an audio file of the specified file type
 to the external file provided.<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stream</CODE> - the audio input stream containing audio data to be 
 written to the file<DD><CODE>fileType</CODE> - the kind of audio file to write<DD><CODE>out</CODE> - the external file to which the file data should be written<DT><B>Returns:</B><DD>the number of bytes written to the file<DT><B>Throws:</B><DD><CODE><A HREF="../../../java/io/IOException.html">IOException</A></CODE> - if an I/O exception occurs<DD><CODE><A HREF="../../../java/lang/IllegalArgumentException.html">IllegalArgumentException</A></CODE> - if the file type is not supported by
 the system<DT><B>See Also: </B><DD><A HREF="../../../javax/sound/sampled/AudioSystem.html#isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)"><CODE>isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)</CODE></A>, 
<A HREF="../../../javax/sound/sampled/AudioSystem.html#getAudioFileTypes()"><CODE>getAudioFileTypes()</CODE></A></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 CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="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="class-use/AudioSystem.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Java<sup><font size=-2>TM</font></sup>&nbsp;2&nbsp;Platform<br>Std.&nbsp;Ed. v1.3</b></EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../javax/sound/sampled/AudioPermission.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../javax/sound/sampled/BooleanControl.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="AudioSystem.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="http://java.sun.com/cgi-bin/bugreport.cgi">Submit a bug or feature</a><br>For further API reference and developer documentation, see <a href="http://java.sun.com/products/jdk/1.3/devdocs-vs-specs.html">Java 2 SDK SE Developer Documentation</a>. That documentation  contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples. <p>Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.<br>Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road<br>Palo Alto, California, 94303, U.S.A.  All Rights Reserved.</font>
</BODY>
</HTML>