uTools-Manuals/docs/java/javax/sound/sampled/spi/AudioFileReader.html

373 lines
19 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.sound.sampled.spi
</div>
<h2 class="title" title="Class AudioFileReader">Class AudioFileReader</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.sound.sampled.spi.AudioFileReader</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">AudioFileReader</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>音频文件阅读服务提供商。</span>
<span>提供具体实现的类可以从一种或多种类型的音频文件解析格式信息,并且可以从这些类型的文件产生音频输入流。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.3
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#AudioFileReader--">AudioFileReader</a></span>()</code> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioFileFormat-java.io.File-">getAudioFileFormat</a></span>(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)</code>
<div class="block">
获取提供的
<code>File</code>的音频文件格式。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioFileFormat-java.io.InputStream-">getAudioFileFormat</a></span>(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)</code>
<div class="block">
获取提供的输入流的音频文件格式。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioFileFormat-java.net.URL-">getAudioFileFormat</a></span>(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)</code>
<div class="block">
获取提供的URL的音频文件格式。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioInputStream-java.io.File-">getAudioInputStream</a></span>(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)</code>
<div class="block">
从提供的
<code>File</code>获取音频输入流。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioInputStream-java.io.InputStream-">getAudioInputStream</a></span>(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)</code>
<div class="block">
从提供的输入流中获取音频输入流。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/AudioFileReader.html#getAudioInputStream-java.net.URL-">getAudioInputStream</a></span>(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)</code>
<div class="block">
从提供的URL获取音频输入流。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="AudioFileReader--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>AudioFileReader</h4> <pre>public AudioFileReader()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getAudioFileFormat-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAudioFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a> getAudioFileFormat(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取提供的输入流的音频文件格式。</span>
<span>流必须指向有效的音频文件数据。</span>
<span>通常,音频文件读取器可能需要在确定它们是否支持之前从流中读取一些数据。</span>
<span>这些解析器必须能够标记流,读取足够的数据以确定它们是否支持流,如果不是,则将流的读指针重置为其原始位置。</span>
<span>如果输入流不支持,则该方法可能会失败,并带有<code>IOException</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> - 应提取文件格式信息的输入流
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>AudioFileFormat</code>音频文件格式的
<code>AudioFileFormat</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果流不指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<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>
</dd>
</dl> </li>
</ul> <a name="getAudioFileFormat-java.net.URL-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAudioFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a> getAudioFileFormat(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取提供的URL的音频文件格式。</span>
<span>URL必须指向有效的音频文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> - 应提取文件格式信息的URL
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>AudioFileFormat</code>音频文件格式的
<code>AudioFileFormat</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果URL不指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
</dl> </li>
</ul> <a name="getAudioFileFormat-java.io.File-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAudioFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFileFormat.html" title="class in javax.sound.sampled">AudioFileFormat</a> getAudioFileFormat(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取提供的<code>File</code>的音频文件格式。</span>
<span><code>File</code>必须指向有效的音频文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>file</code> -
<code>File</code>提取文件格式信息的File
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>AudioFileFormat</code>音频文件格式的
<code>AudioFileFormat</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果
<code>File</code>未指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
</dl> </li>
</ul> <a name="getAudioInputStream-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAudioInputStream</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> getAudioInputStream(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的输入流中获取音频输入流。</span>
<span>流必须指向有效的音频文件数据。</span>
<span>通常,音频文件读取器可能需要在确定它们是否支持之前从流中读取一些数据。</span>
<span>这些解析器必须能够标记流,读取足够的数据以确定它们是否支持流,如果不是,则将流的读指针重置为其原始位置。</span>
<span>如果输入流不支持,则该方法可能会失败,并带有<code>IOException</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> -从该输入流
<code>AudioInputStream</code>应当被构造
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
基于包含在输入流中的音频文件数据的一个
<code>AudioInputStream</code>对象。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果流不指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<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>
</dd>
</dl> </li>
</ul> <a name="getAudioInputStream-java.net.URL-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAudioInputStream</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> getAudioInputStream(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的URL获取音频输入流。</span>
<span>URL必须指向有效的音频文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> -对于其中的URL
<code>AudioInputStream</code>应当建立
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个基于URL指向的音频文件数据的
<code>AudioInputStream</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果URL不指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
</dl> </li>
</ul> <a name="getAudioInputStream-java.io.File-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getAudioInputStream</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> getAudioInputStream(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)
throws <a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a>,
<a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的<code>File</code>获取音频输入流。</span>
<span><code>File</code>必须指向有效的音频文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>file</code> -所述
<code>File</code>的量,
<code>AudioInputStream</code>应当被构造
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个基于文件指向的音频文件数据的
<code>AudioInputStream</code>对象
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/sampled/UnsupportedAudioFileException.html" title="class in javax.sound.sampled">UnsupportedAudioFileException</a></code> - 如果
<code>File</code>未指向系统识别的有效音频文件数据
</dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>