mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 15:52:45 +08:00
717 lines
30 KiB
HTML
717 lines
30 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.sound.sampled
|
||
</div>
|
||
<h2 class="title" title="Class AudioInputStream">Class AudioInputStream</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><a href="../../../java/io/InputStream.html" title="class in java.io">java.io.InputStream</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li>javax.sound.sampled.AudioInputStream</li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
All Implemented Interfaces:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/io/Closeable.html" title="java.io中的接口">Closeable</a> , <a href="../../../java/lang/AutoCloseable.html" title="java.lang中的接口">AutoCloseable</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public class <span class="typeNameLabel">AudioInputStream</span>
|
||
extends <a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></pre>
|
||
<div class="block">
|
||
<span>音频输入流是具有指定音频格式和长度的输入流。</span>
|
||
<span>长度以采样帧而不是字节表示。</span>
|
||
<span>提供了几种从流中读取一定数量的字节的方法,或者是未指定的字节数。</span>
|
||
<span>音频输入流跟踪读取的最后一个字节。</span>
|
||
<span>您可以跳过任意数量的字节以获得稍后的位置进行阅读。</span>
|
||
<span>音频输入流可以支持标记。</span>
|
||
<span>设置标记时,会记住当前的位置,以便以后可以返回。</span>
|
||
<p> <span><code>AudioSystem</code>类包含许多操纵<code>AudioInputStream</code>对象的方法。</span> <span>例如,方法让你:</span> </p>
|
||
<ul>
|
||
<li> <span>从外部音频文件,流或URL获取音频输入流</span> </li>
|
||
<li> <span>从音频输入流写入一个外部文件</span> </li>
|
||
<li> <span>将音频输入流转换为不同的音频格式</span> </li>
|
||
</ul>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始:</span>
|
||
</dt>
|
||
<dd>
|
||
1.3
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/sound/sampled/AudioSystem.html" title="javax.sound.sampled中的类"><code>AudioSystem</code></a> , <a href="../../../javax/sound/sampled/Clip.html#open-javax.sound.sampled.AudioInputStream-"><code>Clip.open(AudioInputStream)</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- =========== FIELD SUMMARY =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.summary">
|
||
<!-- --> </a> <h3>Field Summary</h3>
|
||
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
|
||
<caption>
|
||
<span>Fields</span>
|
||
<span class="tabEnd"> </span>
|
||
</caption>
|
||
<tbody>
|
||
<tr>
|
||
<th class="colFirst" scope="col">Modifier and Type</th>
|
||
<th class="colLast" scope="col">Field and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>protected <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#format">format</a></span></code>
|
||
<div class="block">
|
||
流中包含的音频数据的格式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>protected long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#frameLength">frameLength</a></span></code>
|
||
<div class="block">
|
||
这个流的长度,采样帧。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code>protected long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#framePos">framePos</a></span></code>
|
||
<div class="block">
|
||
这个流中的当前位置,在采样帧中(从零开始)。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>protected int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#frameSize">frameSize</a></span></code>
|
||
<div class="block">
|
||
每个帧的大小,以字节为单位。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table> </li>
|
||
</ul>
|
||
<!-- ======== 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/AudioInputStream.html#AudioInputStream-java.io.InputStream-javax.sound.sampled.AudioFormat-long-">AudioInputStream</a></span>(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream, <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format, long length)</code>
|
||
<div class="block">
|
||
使用来自指定输入流的音频数据构建音频输入流,该音频输入流在采样帧中具有请求的格式和长度。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#AudioInputStream-javax.sound.sampled.TargetDataLine-">AudioInputStream</a></span>(<a href="../../../javax/sound/sampled/TargetDataLine.html" title="interface in javax.sound.sampled">TargetDataLine</a> line)</code>
|
||
<div class="block">
|
||
构建从所指示的目标数据线读取其数据的音频输入流。
|
||
</div> </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="t4"><span><a href="javascript:show(8);">具体的方法</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>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#available--">available</a></span>()</code>
|
||
<div class="block">
|
||
返回从该音频输入流中可以读取(或跳过)的最大字节数,而不会阻塞。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#close--">close</a></span>()</code>
|
||
<div class="block">
|
||
关闭此音频输入流并释放与流相关联的任何系统资源。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code><a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#getFormat--">getFormat</a></span>()</code>
|
||
<div class="block">
|
||
获取此音频输入流中声音数据的音频格式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#getFrameLength--">getFrameLength</a></span>()</code>
|
||
<div class="block">
|
||
获取流的长度,以采样帧而不是字节表示。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#mark-int-">mark</a></span>(int readlimit)</code>
|
||
<div class="block">
|
||
标记此音频输入流中的当前位置。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#markSupported--">markSupported</a></span>()</code>
|
||
<div class="block">
|
||
测试此音频输入流是否支持
|
||
<code>mark</code>和
|
||
<code>reset</code>方法。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#read--">read</a></span>()</code>
|
||
<div class="block">
|
||
从音频输入流读取数据的下一个字节。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-">read</a></span>(byte[] b)</code>
|
||
<div class="block">
|
||
从音频输入流读取一些字节数,并将它们存储到缓冲器阵列
|
||
<code>b</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-int-int-">read</a></span>(byte[] b, int off, int len)</code>
|
||
<div class="block">
|
||
从音频流读取指定的最大数据字节数,将它们放入给定的字节数组。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i9">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#reset--">reset</a></span>()</code>
|
||
<div class="block">
|
||
将此音频输入流重新定位到上次调用其
|
||
<code>mark</code>方法时的位置。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i10">
|
||
<td class="colFirst"><code>long</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/AudioInputStream.html#skip-long-">skip</a></span>(long n)</code>
|
||
<div class="block">
|
||
跳过并丢弃该音频输入流中指定数量的字节。
|
||
</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">
|
||
<!-- ============ FIELD DETAIL =========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="field.detail">
|
||
<!-- --> </a> <h3>字段详细信息</h3> <a name="format">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>format</h4> <pre>protected <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format</pre>
|
||
<div class="block">
|
||
流中包含的音频数据的格式。
|
||
</div> </li>
|
||
</ul> <a name="frameLength">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>frameLength</h4> <pre>protected long frameLength</pre>
|
||
<div class="block">
|
||
这个流的长度,采样帧。
|
||
</div> </li>
|
||
</ul> <a name="frameSize">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>frameSize</h4> <pre>protected int frameSize</pre>
|
||
<div class="block">
|
||
每个帧的大小,以字节为单位。
|
||
</div> </li>
|
||
</ul> <a name="framePos">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>framePos</h4> <pre>protected long framePos</pre>
|
||
<div class="block">
|
||
这个流中的当前位置,在采样帧中(从零开始)。
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="AudioInputStream-java.io.InputStream-javax.sound.sampled.AudioFormat-long-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>AudioInputStream</h4> <pre>public AudioInputStream(<a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream,
|
||
<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format,
|
||
long length)</pre>
|
||
<div class="block">
|
||
使用来自指定输入流的音频数据构建音频输入流,该音频输入流在采样帧中具有请求的格式和长度。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>stream</code> - 此
|
||
<code>AudioInputStream</code>对象所基于的流
|
||
</dd>
|
||
<dd>
|
||
<code>format</code> - 此流的音频数据的格式
|
||
</dd>
|
||
<dd>
|
||
<code>length</code> - 此流中数据的样本帧中的长度
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="AudioInputStream-javax.sound.sampled.TargetDataLine-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>AudioInputStream</h4> <pre>public AudioInputStream(<a href="../../../javax/sound/sampled/TargetDataLine.html" title="interface in javax.sound.sampled">TargetDataLine</a> line)</pre>
|
||
<div class="block">
|
||
<span>构建从所指示的目标数据线读取其数据的音频输入流。</span>
|
||
<span>流的格式与目标数据行的格式相同,长度为AudioSystem#NOT_SPECIFIED。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>line</code> - 此流获取其数据的目标数据行。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioSystem.html#NOT_SPECIFIED"><code>AudioSystem.NOT_SPECIFIED</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getFormat--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getFormat</h4> <pre>public <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> getFormat()</pre>
|
||
<div class="block">
|
||
获取此音频输入流中声音数据的音频格式。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
描述此流格式的音频格式对象
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getFrameLength--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getFrameLength</h4> <pre>public long getFrameLength()</pre>
|
||
<div class="block">
|
||
获取流的长度,以采样帧而不是字节表示。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
样品框架中的长度
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="read--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>read</h4> <pre>public int read()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>从音频输入流读取数据的下一个字节。</span>
|
||
<span>音频输入流的帧大小必须是一个字节,否则将抛出<code>IOException</code> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#read--">read</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
数据的下一个字节,如果达到流的结尾,则为-1
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-int-int-"><code>read(byte[], int, int)</code></a> , <a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-"><code>read(byte[])</code></a> , <a href="../../../javax/sound/sampled/AudioInputStream.html#available--"><code></code></a></span>
|
||
<p> <span><a href="../../../javax/sound/sampled/AudioInputStream.html#available--"><code></code></a></span> </p>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="read-byte:A-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>read</h4> <pre>public int read(byte[] b)
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>从音频输入流读取一些字节数,并将它们存储到缓冲器阵列<code>b</code> 。</span>
|
||
<span>实际读取的字节数作为整数返回。</span>
|
||
<span>该方法阻塞直到输入数据可用,检测到流的结尾,或抛出异常。</span>
|
||
<p> <span>该方法将始终读取整数个帧。</span> <span>如果阵列的长度不是整数帧,则最多可读取<code>b.length - (b.length % frameSize)</code>字节。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#read-byte:A-">read</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>b</code> - 读取数据的缓冲区
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
读取到缓冲区中的总字节数,如果没有更多的数据,因为已经到达流的末尾,则为-1
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果输入或输出错误发生
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-int-int-"><code>read(byte[], int, int)</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read--"><code>read()</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#available--"><code>available()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="read-byte:A-int-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>read</h4> <pre>public int read(byte[] b,
|
||
int off,
|
||
int len)
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>从音频流读取指定的最大数据字节数,将它们放入给定的字节数组。</span>
|
||
<p> <span>该方法将始终读取整数个帧。</span> <span>如果<code>len</code>未指定整数帧,则最多可读取<code>len - (len % frameSize)</code>字节。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#read-byte:A-int-int-">read</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>b</code> - 读取数据的缓冲区
|
||
</dd>
|
||
<dd>
|
||
<code>off</code> - 从数组
|
||
<code>b</code>的偏移量,数据将写入数组
|
||
<code>b</code>
|
||
</dd>
|
||
<dd>
|
||
<code>len</code> - 要读取的最大字节数
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
读取到缓冲区中的总字节数,如果没有更多的数据,因为已经到达流的末尾,则为-1
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-"><code>read(byte[])</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read--"><code>read()</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#skip-long-"><code>skip(long)</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#available--"><code>available()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="skip-long-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>skip</h4> <pre>public long skip(long n)
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
跳过并丢弃该音频输入流中指定数量的字节。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#skip-long-">skip</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>n</code> - 要跳过的请求的字节数
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
实际跳过的字节数
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read--"><code>read()</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#available--"><code>available()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="available--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>available</h4> <pre>public int available()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
<span>返回从该音频输入流中可以读取(或跳过)的最大字节数,而不会阻塞。</span>
|
||
<span>此限制仅适用于下一次调用此音频输入流的<code>read</code>或<code>skip</code>方法;</span>
|
||
<span>每次调用这些方法时,限制可能会有所不同。</span>
|
||
<span>根据底层流,如果此流已关闭,则可能会抛出IOException。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#available--">available</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
可以从该音频输入流中读取而不阻塞的字节数
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-int-int-"><code>read(byte[], int, int)</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read-byte:A-"><code>read(byte[])</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#read--"><code>read()</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#skip-long-"><code>skip(long)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="close--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>close</h4> <pre>public void close()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
关闭此音频输入流并释放与流相关联的任何系统资源。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/Closeable.html#close--">close</a></code>在界面
|
||
<code><a href="../../../java/io/Closeable.html" title="interface in java.io">Closeable</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/AutoCloseable.html#close--">close</a></code>在界面
|
||
<code><a href="../../../java/lang/AutoCloseable.html" title="interface in java.lang">AutoCloseable</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#close--">close</a></code>在类
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="mark-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>mark</h4> <pre>public void mark(int readlimit)</pre>
|
||
<div class="block">
|
||
标记此音频输入流中的当前位置。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#mark-int-">mark</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>readlimit</code> - 标记位置无效之前可以读取的最大字节数。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#reset--"><code>reset()</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#markSupported--"><code>markSupported()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="reset--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>reset</h4> <pre>public void reset()
|
||
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
|
||
<div class="block">
|
||
将此音频输入流重新定位到上次调用其
|
||
<code>mark</code>方法时的位置。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#reset--">reset</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生输入或输出错误。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#mark-int-"><code>mark(int)</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#markSupported--"><code>markSupported()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="markSupported--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>markSupported</h4> <pre>public boolean markSupported()</pre>
|
||
<div class="block">
|
||
测试此音频输入流是否支持
|
||
<code>mark</code>和
|
||
<code>reset</code>方法。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/io/InputStream.html#markSupported--">markSupported</a></code>在类别
|
||
<code><a href="../../../java/io/InputStream.html" title="class in java.io">InputStream</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>true</code>如果这个流支持<code>mark</code>和<code>reset</code>方法;</span>
|
||
<span><code>false</code>否则</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见:</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#mark-int-"><code>mark(int)</code></a> ,
|
||
<a href="../../../javax/sound/sampled/AudioInputStream.html#reset--"><code>reset()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |