mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 15:52:45 +08:00
391 lines
18 KiB
HTML
391 lines
18 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.sound.sampled
|
||
</div>
|
||
<h2 class="title" title="Class DataLine.Info">Class DataLine.Info</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="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">javax.sound.sampled.Line.Info</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li>javax.sound.sampled.DataLine.Info</li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<dl>
|
||
<dt>
|
||
Enclosing interface:
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/sound/sampled/DataLine.html" title="javax.sound.sampled中的接口">DataLine</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public static class <span class="typeNameLabel">DataLine.Info</span>
|
||
extends <a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a></pre>
|
||
<div class="block">
|
||
<span>除了从其超类继承的类信息， <code>DataLine.Info</code>还提供了特定于数据行的附加信息。</span>
|
||
<span>此信息包括：</span>
|
||
<ul>
|
||
<li> <span>数据线支持的音频格式</span> </li>
|
||
<li> <span>其内部缓冲区的最小和最大大小</span> </li>
|
||
</ul>
|
||
<span>因为一个<code>Line.Info</code>知道类其描述了线，一个<code>DataLine.Info</code>对象可以描述<code>DataLine</code>子接口，如<code><a href="../../../javax/sound/sampled/SourceDataLine.html" title="interface in javax.sound.sampled"><code>SourceDataLine</code></a></code> ， <code><a href="../../../javax/sound/sampled/TargetDataLine.html" title="interface in javax.sound.sampled"><code>TargetDataLine</code></a></code>和<code><a href="../../../javax/sound/sampled/Clip.html" title="interface in javax.sound.sampled"><code>Clip</code></a></code> 。</span>
|
||
<span>可以查询的任何这些类型的线混合器，传递的适当实例<code>DataLine.Info</code>作为参数的方法，如<code><a href="../../../javax/sound/sampled/Mixer.html#getLine-javax.sound.sampled.Line.Info-"><code>Mixer.getLine(Line.Info)</code></a></code> 。</span>
|
||
</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/Line.Info.html" title="javax.sound.sampled中的类"><code>Line.Info</code></a></span>
|
||
</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/DataLine.Info.html#Info-java.lang.Class-javax.sound.sampled.AudioFormat-">Info</a></span>(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass, <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format)</code>
|
||
<div class="block">
|
||
根据指定的信息构建数据行的信息对象，其中包含单个音频格式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#Info-java.lang.Class-javax.sound.sampled.AudioFormat:A-int-int-">Info</a></span>(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass, <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a>[] formats, int minBufferSize, int maxBufferSize)</code>
|
||
<div class="block">
|
||
根据指定的信息构建数据行的信息对象，其中包括一组支持的音频格式和缓冲区大小的范围。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#Info-java.lang.Class-javax.sound.sampled.AudioFormat-int-">Info</a></span>(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass, <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format, int bufferSize)</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><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/DataLine.Info.html#getFormats--">getFormats</a></span>()</code>
|
||
<div class="block">
|
||
获取数据线支持的一组音频格式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#getMaxBufferSize--">getMaxBufferSize</a></span>()</code>
|
||
<div class="block">
|
||
获取数据线支持的最大缓冲区大小。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#getMinBufferSize--">getMinBufferSize</a></span>()</code>
|
||
<div class="block">
|
||
获取数据线支持的最小缓冲区大小。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#isFormatSupported-javax.sound.sampled.AudioFormat-">isFormatSupported</a></span>(<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format)</code>
|
||
<div class="block">
|
||
指示此数据线是否支持特定的音频格式。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<td class="colFirst"><code>boolean</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#matches-javax.sound.sampled.Line.Info-">matches</a></span>(<a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a> info)</code>
|
||
<div class="block">
|
||
确定指定的信息对象是否与此匹配。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/sampled/DataLine.Info.html#toString--">toString</a></span>()</code>
|
||
<div class="block">
|
||
获取数据行信息的文本描述。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.javax.sound.sampled.Line.Info">
|
||
<!-- --> </a> <h3>Methods inherited from class javax.sound.sampled.<a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a></h3> <code><a href="../../../javax/sound/sampled/Line.Info.html#getLineClass--">getLineClass</a></code></li>
|
||
</ul>
|
||
<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#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="Info-java.lang.Class-javax.sound.sampled.AudioFormat:A-int-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>Info</h4> <pre>public Info(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass,
|
||
<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a>[] formats,
|
||
int minBufferSize,
|
||
int maxBufferSize)</pre>
|
||
<div class="block">
|
||
<span>根据指定的信息构建数据行的信息对象，其中包括一组支持的音频格式和缓冲区大小的范围。</span>
|
||
<span>当返回有关支持的行的信息时，此构造函数通常由混合器实现使用。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>lineClass</code> - 由info对象描述的数据行的类
|
||
</dd>
|
||
<dd>
|
||
<code>formats</code> - 支持的格式集
|
||
</dd>
|
||
<dd>
|
||
<code>minBufferSize</code> - 数据线支持的最小缓冲区大小（以字节为单位）
|
||
</dd>
|
||
<dd>
|
||
<code>maxBufferSize</code> - 数据线支持的最大缓冲区大小（以字节为单位）
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="Info-java.lang.Class-javax.sound.sampled.AudioFormat-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>Info</h4> <pre>public Info(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass,
|
||
<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format,
|
||
int bufferSize)</pre>
|
||
<div class="block">
|
||
<span>从指定的信息构建数据行的信息对象，其中包含单个音频格式和所需的缓冲区大小。</span>
|
||
<span>该构造函数通常由应用程序用于描述所需的行。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>lineClass</code> - 由info对象描述的数据行的类
|
||
</dd>
|
||
<dd>
|
||
<code>format</code> - 所需格式
|
||
</dd>
|
||
<dd>
|
||
<code>bufferSize</code> - 所需的缓冲区大小（以字节为单位）
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="Info-java.lang.Class-javax.sound.sampled.AudioFormat-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>Info</h4> <pre>public Info(<a href="../../../java/lang/Class.html" title="class in java.lang">类</a><?> lineClass,
|
||
<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format)</pre>
|
||
<div class="block">
|
||
<span>根据指定的信息构建数据行的信息对象，其中包含单个音频格式。</span>
|
||
<span>该构造函数通常由应用程序用于描述所需的行。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>lineClass</code> - 由info对象描述的数据行的类
|
||
</dd>
|
||
<dd>
|
||
<code>format</code> - 所需格式
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="getFormats--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getFormats</h4> <pre>public <a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a>[] getFormats()</pre>
|
||
<div class="block">
|
||
<span>获取数据线支持的一组音频格式。</span>
|
||
<span>需要注意的是<code>isFormatSupported(AudioFormat)</code>可能返回<code>true</code>为从返回的集中缺少某些附加格式<code>getFormats()</code> 。</span>
|
||
<span>相反的情况并非如此： <code>isFormatSupported(AudioFormat)</code>保证返回<code>true</code>通过返回的所有格式<code>getFormats()</code> 。</span>
|
||
<span>如果该字段不适用于格式，或者如果格式支持该字段的宽范围值，则AudioFormat实例中的某些字段可以设置为<a href="../../../javax/sound/sampled/AudioSystem.html#NOT_SPECIFIED"><code>NOT_SPECIFIED</code></a> 。</span>
|
||
<span>例如，支持多达64个通道的多通道设备可以将此方法返回的<code>AudioFormat</code>实例中的通道字段设置为<code>NOT_SPECIFIED</code> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一组支持的音频格式。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/DataLine.Info.html#isFormatSupported-javax.sound.sampled.AudioFormat-"><code>isFormatSupported(AudioFormat)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="isFormatSupported-javax.sound.sampled.AudioFormat-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>isFormatSupported</h4> <pre>public boolean isFormatSupported(<a href="../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> format)</pre>
|
||
<div class="block">
|
||
<span>指示此数据线是否支持特定的音频格式。</span>
|
||
<span>如果指定的格式匹配任何支持的格式，则此方法的默认实现方法只返回<code>true</code> 。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>format</code> - 查询支持的音频格式。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>true</code>如果格式支持，否则
|
||
<code>false</code>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/sampled/DataLine.Info.html#getFormats--"><code>getFormats()</code></a> ，
|
||
<a href="../../../javax/sound/sampled/AudioFormat.html#matches-javax.sound.sampled.AudioFormat-"><code>AudioFormat.matches(javax.sound.sampled.AudioFormat)</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getMinBufferSize--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getMinBufferSize</h4> <pre>public int getMinBufferSize()</pre>
|
||
<div class="block">
|
||
获取数据线支持的最小缓冲区大小。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
最小缓冲区大小（以字节为单位），或
|
||
<code>AudioSystem.NOT_SPECIFIED</code>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getMaxBufferSize--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getMaxBufferSize</h4> <pre>public int getMaxBufferSize()</pre>
|
||
<div class="block">
|
||
获取数据线支持的最大缓冲区大小。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
最大缓冲区大小（以字节为单位），或
|
||
<code>AudioSystem.NOT_SPECIFIED</code>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="matches-javax.sound.sampled.Line.Info-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>matches</h4> <pre>public boolean matches(<a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a> info)</pre>
|
||
<div class="block">
|
||
<span>确定指定的信息对象是否与此匹配。</span>
|
||
<span>要匹配，必须满足超类匹配要求。</span>
|
||
<span>此外，此对象的最小缓冲区大小必须至少与指定对象的最小缓冲区大小一样大，因此其最大缓冲区大小必须与指定对象的最大缓冲区大小一样大，并且其所有格式必须与对象支持的格式相匹配指定。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/sound/sampled/Line.Info.html#matches-javax.sound.sampled.Line.Info-">matches</a></code>在类别
|
||
<code><a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>info</code> - 正在与此相比较的信息对象
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
<code>true</code>如果此对象与指定的对象匹配，否则为
|
||
<code>false</code> 。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="toString--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>toString</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> toString()</pre>
|
||
<div class="block">
|
||
获取数据行信息的文本描述。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">重写：</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/sound/sampled/Line.Info.html#toString--">toString</a></code>在类别
|
||
<code><a href="../../../javax/sound/sampled/Line.Info.html" title="class in javax.sound.sampled">Line.Info</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
a string description
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |