uTools-Manuals/docs/java/javax/sound/midi/Soundbank.html

<div class="header">
<div class="subTitle">
     javax.sound.midi 
   </div>
<h2 class="title" title="Interface Soundbank">Interface Soundbank</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public interface <span class="typeNameLabel">Soundbank</span></pre>
<div class="block">
<span>A <code>Soundbank</code>包含一组<code>Instruments</code> ，可以加载到<code>Synthesizer</code> 。</span>
<span>请注意，Java Sound <code>Soundbank</code>与MIDI bank不同。</span>
<span>MIDI允许多达16383个银行，每个银行最多包含128个工具（有时也称为程序，补丁或音色）。</span>
<span>但是， <code>Soundbank</code>可以包含16383次128个乐器，因为Soundbank中的<code>Soundbank</code>由MIDI程序号和MIDI存储体号（通过<code>Patch</code>对象）进行<code>Patch</code> 。</span>
<span>因此，一个<code>Soundbank</code>可以被认为是一个集合的MIDI银行。</span>
<p> <span><code>Soundbank</code>包括返回方法<code>String</code>包含音库的名称，制造商，版本号和描述对象。</span> <span>这些字符串的精确内容和格式留给了实现者。</span> </p>
<p> <span>不同的合成器使用各种合成技术。</span> <span>一个常见的是波形合成，其中一段录制的声音被播放，通常是循环和音调变化。</span> <span>可下载声音（DLS）格式使用录音的段，头空间引擎也是如此。</span> <span><code>Soundbanks</code>和<code>Instruments</code>基于波形合成（或存储声音记录的其他用途）应通常实现<code>getResources()</code>方法来提供对这些记录段的访问。</span> <span>然而，这是可选的;</span> <span>如果合成技术不使用采样声音（FM综合和物理建模是这种技术的例子），则该方法可以返回零长度数组，或者如果它不是但实现者选择不使样本可访问的话。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/sound/midi/Synthesizer.html#getDefaultSoundbank--"><code>Synthesizer.getDefaultSoundbank()</code></a> ， <a href="../../../javax/sound/midi/Synthesizer.html#isSoundbankSupported-javax.sound.midi.Soundbank-"><code>Synthesizer.isSoundbankSupported(javax.sound.midi.Soundbank)</code></a> ， <a href="../../../javax/sound/midi/Synthesizer.html#loadInstruments-javax.sound.midi.Soundbank-javax.sound.midi.Patch:A-"><code>Synthesizer.loadInstruments(Soundbank, Patch[])</code></a> ， <a href="../../../javax/sound/midi/Patch.html" title="javax.sound.midi中的类"><code>Patch</code></a> ， <a href="../../../javax/sound/midi/Instrument.html" title="javax.sound.midi中的类"><code>Instrument</code></a> ， <a href="../../../javax/sound/midi/SoundbankResource.html" title="javax.sound.midi中的类"><code>SoundbankResource</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ========== 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><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/midi/Soundbank.html#getDescription--">getDescription</a></span>()</code>
<div class="block">
              获取声音库的文字描述，适合显示。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/sound/midi/Instrument.html" title="class in javax.sound.midi">Instrument</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/Soundbank.html#getInstrument-javax.sound.midi.Patch-">getInstrument</a></span>(<a href="../../../javax/sound/midi/Patch.html" title="class in javax.sound.midi">Patch</a> patch)</code>
<div class="block">
              获取一个 
             <code>Instrument</code>从给定 
             <code>Patch</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../javax/sound/midi/Instrument.html" title="class in javax.sound.midi">Instrument</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/Soundbank.html#getInstruments--">getInstruments</a></span>()</code>
<div class="block">
              获取这个声音库中包含的乐器列表。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<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/midi/Soundbank.html#getName--">getName</a></span>()</code>
<div class="block">
              获取声音库的名称。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../javax/sound/midi/SoundbankResource.html" title="class in javax.sound.midi">SoundbankResource</a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/Soundbank.html#getResources--">getResources</a></span>()</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/midi/Soundbank.html#getVendor--">getVendor</a></span>()</code>
<div class="block">
              获得一个 
             <code>string</code>命名提供声音库的公司 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<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/midi/Soundbank.html#getVersion--">getVersion</a></span>()</code>
<div class="block">
              获取声音库的版本字符串。 
            </div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getName</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getName()</pre>
<div class="block">
            获取声音库的名称。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>命名声音库 
           </dd>
</dl> </li>
</ul> <a name="getVersion--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVersion</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getVersion()</pre>
<div class="block">
            获取声音库的版本字符串。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code> ，表示声音银行的版本 
           </dd>
</dl> </li>
</ul> <a name="getVendor--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVendor</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getVendor()</pre>
<div class="block">
            获得一个 
           <code>string</code>命名提供声银行的公司 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             供应商字符串 
           </dd>
</dl> </li>
</ul> <a name="getDescription--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDescription</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getDescription()</pre>
<div class="block">
            获取声音库的文字描述，适合显示。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>String</code>声音库的String 
           </dd>
</dl> </li>
</ul> <a name="getResources--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getResources</h4> <pre><a href="../../../javax/sound/midi/SoundbankResource.html" title="class in javax.sound.midi">SoundbankResource</a>[] getResources()</pre>
<div class="block">
            提取声音库中包含的非仪器资源列表。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<span>一系列资源，不包括文书。</span>
<span>如果声音库不包含资源（仪器除外），则返回长度为0的数组。</span>
</dd>
</dl> </li>
</ul> <a name="getInstruments--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getInstruments</h4> <pre><a href="../../../javax/sound/midi/Instrument.html" title="class in javax.sound.midi">Instrument</a>[] getInstruments()</pre>
<div class="block">
            获取这个声音库中包含的乐器列表。 
          </div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>Instruments</code>一个数组在这个 
            <code>SoundBank</code>如果声音库不包含乐器，返回一个长度为0的数组。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/Synthesizer.html#getLoadedInstruments--"><code>Synthesizer.getLoadedInstruments()</code></a> ， 
            <a href="../../../javax/sound/midi/Soundbank.html#getInstrument-javax.sound.midi.Patch-"><code>getInstrument(Patch)</code></a>
</dd>
</dl> </li>
</ul> <a name="getInstrument-javax.sound.midi.Patch-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getInstrument</h4> <pre><a href="../../../javax/sound/midi/Instrument.html" title="class in javax.sound.midi">Instrument</a> getInstrument(<a href="../../../javax/sound/midi/Patch.html" title="class in javax.sound.midi">Patch</a> patch)</pre>
<div class="block">
            获取一个 
           <code>Instrument</code>从给定 
           <code>Patch</code> 。 
          </div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>patch</code> - 一个 
            <code>Patch</code>对象，指定银行索引和程序更改号 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             所请求的乐器，或 
            <code>null</code>如果音库不包含仪器 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/Soundbank.html#getInstruments--"><code>getInstruments()</code></a> ， 
            <a href="../../../javax/sound/midi/Synthesizer.html#loadInstruments-javax.sound.midi.Soundbank-javax.sound.midi.Patch:A-"><code>Synthesizer.loadInstruments(Soundbank, Patch[])</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>