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

408 lines
22 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 FormatConversionProvider">Class FormatConversionProvider</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.FormatConversionProvider</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">FormatConversionProvider</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>格式转换提供者将一种或多种输入格式的格式转换服务提供给一种或多种输出格式。</span>
<span>转换器包括对音频数据进行编码和/或解码的编解码器以及代码转换器等。格式转换器提供用于确定支持哪些转换的方法以及用于获得可读取转换数据的音频流。</span>
<p> <span>源格式表示将被转换的传入音频数据的格式。</span> </p>
<p> <span>目标格式表示已处理转换的音频数据的格式。</span> <span>这是可以从<code>getAudioInputStream</code>之一返回的流中读取的数据格式。</span> </p>
</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/FormatConversionProvider.html#FormatConversionProvider--">FormatConversionProvider</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>
<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>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/FormatConversionProvider.html#getAudioInputStream-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioInputStream-">getAudioInputStream</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding, <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> sourceStream)</code>
<div class="block">
从给定的音频输入流中获取具有指定编码的音频输入流。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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/FormatConversionProvider.html#getAudioInputStream-javax.sound.sampled.AudioFormat-javax.sound.sampled.AudioInputStream-">getAudioInputStream</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> targetFormat, <a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> sourceStream)</code>
<div class="block">
从给定的音频输入流中获取具有指定格式的音频输入流。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#getSourceEncodings--">getSourceEncodings</a></span>()</code>
<div class="block">
获取由该提供商提供格式转换服务的源格式编码集合。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#getTargetEncodings--">getTargetEncodings</a></span>()</code>
<div class="block">
获取此提供商提供格式转换服务的一组目标格式编码。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#getTargetEncodings-javax.sound.sampled.AudioFormat-">getTargetEncodings</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</code>
<div class="block">
获取格式转换器支持的一组目标格式编码,给定特定的源格式。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <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/spi/FormatConversionProvider.html#getTargetFormats-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioFormat-">getTargetFormats</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding, <a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</code>
<div class="block">
使用格式转换器支持的编码获取目标格式集合如果此源格式不支持具有指定编码的目标格式则返回长度为0的数组。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#isConversionSupported-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioFormat-">isConversionSupported</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding, <a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</code>
<div class="block">
指示格式转换器是否支持从特定格式转换为特定编码。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#isConversionSupported-javax.sound.sampled.AudioFormat-javax.sound.sampled.AudioFormat-">isConversionSupported</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> targetFormat, <a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</code>
<div class="block">
指示格式转换器是否支持从另一种格式转换为一种特定格式。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#isSourceEncodingSupported-javax.sound.sampled.AudioFormat.Encoding-">isSourceEncodingSupported</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> sourceEncoding)</code>
<div class="block">
指示格式转换器是否支持从指定的源格式编码转换。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/sampled/spi/FormatConversionProvider.html#isTargetEncodingSupported-javax.sound.sampled.AudioFormat.Encoding-">isTargetEncodingSupported</a></span>(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding)</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">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="FormatConversionProvider--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>FormatConversionProvider</h4> <pre>public FormatConversionProvider()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getSourceEncodings--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceEncodings</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[] getSourceEncodings()</pre>
<div class="block">
获取由该提供商提供格式转换服务的源格式编码集合。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>数组源码格式编码。</span>
<span>如果由于某种原因提供者不提供任何转换服务则返回长度为0的数组。</span>
</dd>
</dl> </li>
</ul> <a name="getTargetEncodings--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTargetEncodings</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[] getTargetEncodings()</pre>
<div class="block">
获取此提供商提供格式转换服务的一组目标格式编码。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>数组目标格式编码。</span>
<span>如果由于某种原因提供者不提供任何转换服务则返回长度为0的数组。</span>
</dd>
</dl> </li>
</ul> <a name="isSourceEncodingSupported-javax.sound.sampled.AudioFormat.Encoding-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isSourceEncodingSupported</h4> <pre>public boolean isSourceEncodingSupported(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> sourceEncoding)</pre>
<div class="block">
指示格式转换器是否支持从指定的源格式编码转换。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceEncoding</code> - 查询支持的源格式编码
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果支持编码,否则
<code>false</code>
</dd>
</dl> </li>
</ul> <a name="isTargetEncodingSupported-javax.sound.sampled.AudioFormat.Encoding-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isTargetEncodingSupported</h4> <pre>public boolean isTargetEncodingSupported(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding)</pre>
<div class="block">
指示格式转换器是否支持转换为指定的目标格式编码。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetEncoding</code> - 查询支持的目标格式编码
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果支持编码,否则
<code>false</code>
</dd>
</dl> </li>
</ul> <a name="getTargetEncodings-javax.sound.sampled.AudioFormat-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTargetEncodings</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a>[] getTargetEncodings(<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</pre>
<div class="block">
<span>获取格式转换器支持的一组目标格式编码,给定特定的源格式。</span>
<span>如果此源格式不支持目标格式编码则返回长度为0的数组。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceFormat</code> - 传入数据的格式
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
支持的目标格式编码数组。
</dd>
</dl> </li>
</ul> <a name="isConversionSupported-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioFormat-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isConversionSupported</h4> <pre>public boolean isConversionSupported(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding,
<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</pre>
<div class="block">
指示格式转换器是否支持从特定格式转换为特定编码。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetEncoding</code> - 输出数据的期望编码
</dd>
<dd>
<code>sourceFormat</code> - 输入数据的格式
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果转换支持,否则
<code>false</code>
</dd>
</dl> </li>
</ul> <a name="getTargetFormats-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioFormat-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTargetFormats</h4> <pre>public abstract <a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a>[] getTargetFormats(<a href="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding,
<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</pre>
<div class="block">
使用格式转换器支持的编码获取目标格式集合如果此源格式不支持具有指定编码的目标格式则返回长度为0的数组。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetEncoding</code> - 处理后流的所需编码
</dd>
<dd>
<code>sourceFormat</code> - 输入数据的格式
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
支持的目标格式数组。
</dd>
</dl> </li>
</ul> <a name="isConversionSupported-javax.sound.sampled.AudioFormat-javax.sound.sampled.AudioFormat-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isConversionSupported</h4> <pre>public boolean isConversionSupported(<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> targetFormat,
<a href="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> sourceFormat)</pre>
<div class="block">
指示格式转换器是否支持从另一种格式转换为一种特定格式。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetFormat</code> - 输出数据的所需格式
</dd>
<dd>
<code>sourceFormat</code> - 输入数据的格式
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果转换支持,否则
<code>false</code>
</dd>
</dl> </li>
</ul> <a name="getAudioInputStream-javax.sound.sampled.AudioFormat.Encoding-javax.sound.sampled.AudioInputStream-">
<!-- --> </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="../../../../javax/sound/sampled/AudioFormat.Encoding.html" title="class in javax.sound.sampled">AudioFormat.Encoding</a> targetEncoding,
<a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> sourceStream)</pre>
<div class="block">
从给定的音频输入流中获取具有指定编码的音频输入流。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetEncoding</code> - 处理后流的所需编码
</dd>
<dd>
<code>sourceStream</code> - 应从中读取要处理的数据的流
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可以读取具有指定目标编码的处理数据的流
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果不支持提供的格式组合。
</dd>
</dl> </li>
</ul> <a name="getAudioInputStream-javax.sound.sampled.AudioFormat-javax.sound.sampled.AudioInputStream-">
<!-- --> </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="../../../../javax/sound/sampled/AudioFormat.html" title="class in javax.sound.sampled">AudioFormat</a> targetFormat,
<a href="../../../../javax/sound/sampled/AudioInputStream.html" title="class in javax.sound.sampled">AudioInputStream</a> sourceStream)</pre>
<div class="block">
从给定的音频输入流中获取具有指定格式的音频输入流。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>targetFormat</code> - 处理后的流的期望数据格式
</dd>
<dd>
<code>sourceStream</code> - 应从中读取要处理的数据的流
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可以读取具有指定格式的处理数据的流
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果不支持格式组合。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>