mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-03 23:32:47 +08:00
395 lines
17 KiB
HTML
395 lines
17 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
javax.sound.midi
|
||
</div>
|
||
<h2 class="title" title="Class MetaMessage">Class MetaMessage</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/midi/MidiMessage.html" title="class in javax.sound.midi">javax.sound.midi.MidiMessage</a></li>
|
||
<li>
|
||
<ul class="inheritance">
|
||
<li>javax.sound.midi.MetaMessage</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/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public class <span class="typeNameLabel">MetaMessage</span>
|
||
extends <a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></pre>
|
||
<div class="block">
|
||
<span>A <code>MetaMessage</code>是一个<code><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi"><code>MidiMessage</code></a></code> ， <code><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi"><code>MidiMessage</code></a></code>器没有意义，但可以存储在MIDI文件中并由音序器程序解释。</span>
|
||
<span>（参见<code>MidiMessage</code>类描述中的<code>MidiMessage</code> ）。标准MIDI文件规范定义了各种类型的元事件，如序列号，歌词，提示点和设置速度。</span>
|
||
<span>还有诸如歌词，版权，速度指示，时间和键签名，标记等信息的元事件。有关更多信息，请参阅标准MIDI文件1.0规范，它是Complete MIDI 1.0详细规范的一部分，由“ MIDI制造商协会（ <a href="http://www.midi.org">http://www.midi.org</a> ）。</span>
|
||
<p> <span>当数据正被使用MIDI线协议传送的，一<code><a href="../../../javax/sound/midi/ShortMessage.html" title="class in javax.sound.midi"><code>ShortMessage</code></a></code>与状态值<code>0xFF</code>表示系统重置消息。</span> <span>在MIDI文件中，相同的状态值表示一个<code>MetaMessage</code> 。</span> <span>元消息的类型通过状态字节<code>0xFF</code>之后的第一个字节<code>0xFF</code> 。</span> <span>随后的字节是数据字节。</span> <span>与系统专用信息，有数据字节的任意数量，这取决于类型<code>MetaMessage</code> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/sound/midi/MetaEventListener.html" title="javax.sound.midi中的接口"><code>MetaEventListener</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>static int</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#META">META</a></span></code>
|
||
<div class="block">
|
||
<code>MetaMessage</code> （0xFF或255）的状态字节，用于MIDI文件。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="fields.inherited.from.class.javax.sound.midi.MidiMessage">
|
||
<!-- --> </a> <h3>Fields inherited from class javax.sound.midi.<a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></h3> <code><a href="../../../javax/sound/midi/MidiMessage.html#data">data</a>, <a href="../../../javax/sound/midi/MidiMessage.html#length">length</a></code></li>
|
||
</ul> </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="colFirst" scope="col">Modifier</th>
|
||
<th class="colLast" scope="col">Constructor and Description</th>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code> </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#MetaMessage--">MetaMessage</a></span>()</code>
|
||
<div class="block">
|
||
构建新的
|
||
<code>MetaMessage</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor">
|
||
<td class="colFirst"><code>protected </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#MetaMessage-byte:A-">MetaMessage</a></span>(byte[] data)</code>
|
||
<div class="block">
|
||
构造一个新的
|
||
<code>MetaMessage</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor">
|
||
<td class="colFirst"><code> </code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#MetaMessage-int-byte:A-int-">MetaMessage</a></span>(int type, byte[] data, int length)</code>
|
||
<div class="block">
|
||
构造一个新的
|
||
<code>MetaMessage</code>并设置消息参数。
|
||
</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="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#clone--">clone</a></span>()</code>
|
||
<div class="block">
|
||
创建与该对象相同的类和新内容相同的新对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>byte[]</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#getData--">getData</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/midi/MetaMessage.html#getType--">getType</a></span>()</code>
|
||
<div class="block">
|
||
获得
|
||
<code>MetaMessage</code>的类型。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/MetaMessage.html#setMessage-int-byte:A-int-">setMessage</a></span>(int type, byte[] data, int length)</code>
|
||
<div class="block">
|
||
设置MetaMessage的消息
|
||
<code>MetaMessage</code> 。
|
||
</div> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="methods.inherited.from.class.javax.sound.midi.MidiMessage">
|
||
<!-- --> </a> <h3>Methods inherited from class javax.sound.midi.<a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></h3> <code><a href="../../../javax/sound/midi/MidiMessage.html#getLength--">getLength</a>, <a href="../../../javax/sound/midi/MidiMessage.html#getMessage--">getMessage</a>, <a href="../../../javax/sound/midi/MidiMessage.html#getStatus--">getStatus</a>, <a href="../../../javax/sound/midi/MidiMessage.html#setMessage-byte:A-int-">setMessage</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#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="META">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>META</h4> <pre>public static final int META</pre>
|
||
<div class="block">
|
||
<span><code>MetaMessage</code> （0xFF或255）的状态字节，用于MIDI文件。</span>
|
||
<span>它具有与SYSTEM_RESET相同的值，用于实时“MIDI线”协议。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a> ，
|
||
<a href="../../../constant-values.html#javax.sound.midi.MetaMessage.META">Constant Field Values</a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="MetaMessage--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>MetaMessage</h4> <pre>public MetaMessage()</pre>
|
||
<div class="block">
|
||
<span>构建新的<code>MetaMessage</code> 。</span>
|
||
<span>消息的内容不在这里设置;</span>
|
||
<span>使用<a href="../../../javax/sound/midi/MetaMessage.html#setMessage-int-byte:A-int-"><code>setMessage</code>随后</a>进行设置。</span>
|
||
</div> </li>
|
||
</ul> <a name="MetaMessage-int-byte:A-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>MetaMessage</h4> <pre>public MetaMessage(int type,
|
||
byte[] data,
|
||
int length)
|
||
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
|
||
<div class="block">
|
||
<span>构造一个新的<code>MetaMessage</code>并设置消息参数。</span>
|
||
<span>可以使用<code>setMessage</code>方法更改消息的内容。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>type</code> - 元消息类型（必须小于128）
|
||
</dd>
|
||
<dd>
|
||
<code>data</code> - MIDI信息中的数据字节
|
||
</dd>
|
||
<dd>
|
||
<span><code>length</code> - <code>data</code>字节数组中的字节数;</span>
|
||
<span>它应该是非负的，小于等于<code>data.length</code></span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果参数值未指定有效的MIDI元消息
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.7
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/midi/MetaMessage.html#setMessage-int-byte:A-int-"><code>setMessage(int, byte[], int)</code></a> ，
|
||
<a href="../../../javax/sound/midi/MetaMessage.html#getType--"><code>getType()</code></a> ，
|
||
<a href="../../../javax/sound/midi/MetaMessage.html#getData--"><code>getData()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="MetaMessage-byte:A-">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>MetaMessage</h4> <pre>protected MetaMessage(byte[] data)</pre>
|
||
<div class="block">
|
||
构建新的
|
||
<code>MetaMessage</code> 。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<span><code>data</code> - 包含完整消息的字节数组。</span>
|
||
<span>可以使用<code>setMessage</code>方法更改消息数据。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/midi/MetaMessage.html#setMessage-int-byte:A-int-"><code>setMessage(int, byte[], int)</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="setMessage-int-byte:A-int-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setMessage</h4> <pre>public void setMessage(int type,
|
||
byte[] data,
|
||
int length)
|
||
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
|
||
<div class="block">
|
||
<span>设置MetaMessage的消息<code>MetaMessage</code> 。</span>
|
||
<span>由于元消息仅允许一个状态字节值<code>0xFF</code> ，因此不需要在此处指定。</span>
|
||
<span>致电<code><a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>getStatus</code></a></code>返回<code>0xFF</code>为所有元消息。</span>
|
||
<p> <span><code>type</code>参数应该是<code>type</code>的状态字节后面的字节的<code>MetaMessage</code> 。</span> <span>该<code>data</code>参数应包含的所有后续字节<code>MetaMessage</code> 。</span> <span>换句话说，指定的类型的字节<code>MetaMessage</code>不被认为是一个数据字节。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>type</code> - 元消息类型（必须小于128）
|
||
</dd>
|
||
<dd>
|
||
<code>data</code> - MIDI信息中的数据字节
|
||
</dd>
|
||
<dd>
|
||
<code>length</code> -
|
||
<code>data</code>字节数组中的字节数
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果参数值没有指定有效的MIDI元消息
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getType--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getType</h4> <pre>public int getType()</pre>
|
||
<div class="block">
|
||
获得
|
||
<code>MetaMessage</code>的类型。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
一个代表
|
||
<code>MetaMessage</code>类型的整数
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getData--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getData</h4> <pre>public byte[] getData()</pre>
|
||
<div class="block">
|
||
<span>获取元消息的数据副本。</span>
|
||
<span>返回的字节数组不包括状态字节或消息长度数据。</span>
|
||
<span>元消息的数据长度是数组的长度。</span>
|
||
<span>请注意，整个消息的长度包括状态字节和元消息类型字节，因此可能比返回的数组长。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
数组包含元消息数据。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<a href="../../../javax/sound/midi/MidiMessage.html#getLength--"><code>MidiMessage.getLength()</code></a>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="clone--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>clone</h4> <pre>public <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
|
||
<div class="block">
|
||
创建与该对象相同的类和新内容相同的新对象。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/sound/midi/MidiMessage.html#clone--">clone</a></code>在类别
|
||
<code><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
这个实例的一个克隆
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../java/lang/Cloneable.html" title="java.lang中的接口"><code>Cloneable</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |