Sequence (Java Platform SE 8 )

java.lang.Object
- javax.sound.midi.Sequence

```
public class Sequence
extends Object
```
一个 Sequence是含有音乐信息的数据结构（通常是一个完整的歌曲或乐曲），可以由一个 Sequencer对象扮演。具体而言，该 Sequence包含时间信息和一个或多个轨道。每个 track由一系列的MIDI事件（如附注项，注意取舍，程序的变化，和元事件）。该序列的定时信息指定用于时间戳序列中的事件的单位类型。
一个Sequence可以通过读取文件到一个输入流和调用的方法之一MidiSystem getSequence从MIDI文件创建一个序列，也可以从头开始建立新的Tracks添加到一个空的Sequence，加入MidiEvent对象，这些Tracks。

另请参见：

Sequencer.setSequence(java.io.InputStream stream)， Sequencer.setSequence(Sequence sequence)， Track.add(MidiEvent)， MidiFileFormat

Field Summary

Fields
Modifier and Type	Field and Description
`protected float`	`divisionType` 时序的时序划分类型。
`static float`	`PPQ` 基于节奏的定时类型，该分辨率是表示在脉冲（蜱）每季度票据。
`protected int`	`resolution` 序列的定时分辨率。
`static float`	`SMPTE_24` 基于SMPTE每秒24帧定时型（分辨率是蜱的每帧的表达）。
`static float`	`SMPTE_25` 基于SMPTE每秒25帧定时型（分辨率是蜱的每帧的表达）。
`static float`	`SMPTE_30` 基于SMPTE每秒30帧定时型（分辨率是蜱的每帧的表达）。
`static float`	`SMPTE_30DROP` 基于SMPTE每秒29.97帧定时型（分辨率是蜱的每帧的表达）。
`protected Vector<Track>`	`tracks` 在这个序列的MIDI音轨。

构造方法摘要

构造方法
Constructor and Description
`Sequence(float divisionType, int resolution)` 提出了一种新的指定的时间划分类型和时间分辨率的MIDI序列。
`Sequence(float divisionType, int resolution, int numTracks)` 提出了一种新的指定的时间分型、MIDI序列的时间分辨率和磁道数。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`Track`	`createTrack()` 创建一个新的，最初是空的轨道，作为该序列的一部分。
`boolean`	`deleteTrack(Track track)` 从序列中移除指定的轨道。
`float`	`getDivisionType()` 获取此序列的时序划分类型。
`long`	`getMicrosecondLength()` 获得该序列的持续时间，表示在微秒。
`Patch[]`	`getPatchList()` 获得在此序列中引用的补丁列表。
`int`	`getResolution()` 获取此序列的定时分辨率。
`long`	`getTickLength()` 获得该序列的持续时间，用MIDI蜱。
`Track[]`	`getTracks()` 获取一个包含该序列中所有曲目的数组。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PPQ
```
public static final float PPQ
```
    基于节奏的定时类型，该分辨率是表示在脉冲（蜱）每季度票据。
    
    另请参见：
    
    Sequence(float, int)， Constant Field Values
  - SMPTE_24
```
public static final float SMPTE_24
```
    基于SMPTE每秒24帧定时型（分辨率是蜱的每帧的表达）。
    
    另请参见：
    
    Sequence(float, int)， Constant Field Values
  - SMPTE_25
```
public static final float SMPTE_25
```
    基于SMPTE每秒25帧定时型（分辨率是蜱的每帧的表达）。
    
    另请参见：
    
    Sequence(float, int)， Constant Field Values
  - SMPTE_30DROP
```
public static final float SMPTE_30DROP
```
    基于SMPTE每秒29.97帧定时型（分辨率是蜱的每帧的表达）。
    
    另请参见：
    
    Sequence(float, int)， Constant Field Values
  - SMPTE_30
```
public static final float SMPTE_30
```
    基于SMPTE每秒30帧定时型（分辨率是蜱的每帧的表达）。
    
    另请参见：
    
    Sequence(float, int)， Constant Field Values
  - divisionType
```
protected float divisionType
```
    时序的时序划分类型。
    
    另请参见：
    
    PPQ， SMPTE_24， SMPTE_25， SMPTE_30DROP， SMPTE_30， getDivisionType()
  - resolution
```
protected int resolution
```
    序列的定时分辨率。
    
    另请参见：
    
    getResolution()
  - tracks
```
protected Vector<Track> tracks
```
    在这个序列的MIDI音轨。
    
    另请参见：
    
    getTracks()
- Constructor Detail
  - Sequence
```
public Sequence(float divisionType,
                int resolution)
         throws InvalidMidiDataException
```
    提出了一种新的指定的时间划分类型和时间分辨率的MIDI序列。划分的类型必须是一个公认的MIDI时间类型。基于时间的节奏， divisionType是PPQ（脉冲每季度注）和分辨率是每打指定蜱。对于smtpe定时， divisionType指定每秒的帧数和分辨率是蜱的每帧指定。该序列将不包含初始轨道。轨道可添加或使用 createTrack()和 deleteTrack(javax.sound.midi.Track)序列删除。
    
    参数
    
    divisionType -时分型（PPQ或一个SMPTE类型）
    
    resolution的定时分辨率
    
    异常
    
    InvalidMidiDataException -如果 divisionType无效
    
    另请参见：
    
    PPQ， SMPTE_24， SMPTE_25， SMPTE_30DROP， SMPTE_30， getDivisionType()， getResolution()， getTracks()
  - Sequence
```
public Sequence(float divisionType,
                int resolution,
                int numTracks)
         throws InvalidMidiDataException
```
    提出了一种新的指定的时间分型、MIDI序列的时间分辨率和磁道数。划分的类型必须是一个公认的MIDI时间类型。基于时间的节奏， divisionType是PPQ（脉冲每季度注）和分辨率是每打指定蜱。对于smtpe定时， divisionType指定每秒的帧数和分辨率是蜱的每帧指定。序列将与指定的 numTracks磁道数初始化。这些轨道最初是空的（即它们只包含轨道的元事件结束）。轨道可以检索使用 getTracks()方法编辑。其他曲目可添加或删除现有的轨道，，使用 createTrack()和 deleteTrack(javax.sound.midi.Track)。
    
    参数
    
    divisionType -时分型（PPQ或一个SMPTE类型）
    
    resolution的定时分辨率
    
    numTracks -序列中轨道的初始数量。
    
    异常
    
    InvalidMidiDataException -如果 divisionType无效
    
    另请参见：
    
    PPQ， SMPTE_24， SMPTE_25， SMPTE_30DROP， SMPTE_30， getDivisionType()， getResolution()
- 方法详细信息
  - getDivisionType
```
public float getDivisionType()
```
    获取此序列的时序划分类型。
    
    结果
    
    分型（PPQ或一个SMPTE类型）
    
    另请参见：
    
    PPQ， SMPTE_24， SMPTE_25， SMPTE_30DROP， SMPTE_30， Sequence(float, int)， MidiFileFormat.getDivisionType()
  - getResolution
```
public int getResolution()
```
    获取此序列的定时分辨率。如果序列的分型是PPQ，决议在蜱每打指定。对于smtpe时机，决议在蜱每帧指定。
    
    结果
    
    蜱每拍数（PPQ）或每帧（SMPTE）
    
    另请参见：
    
    getDivisionType()， Sequence(float, int)， MidiFileFormat.getResolution()
  - createTrack
```
public Track createTrack()
```
    创建一个新的，最初是空的轨道，作为该序列的一部分。轨道最初包含轨道的元事件结束。返回新创建的轨道。序列中的所有曲目可以检索使用 getTracks()。轨道可使用 deleteTrack(javax.sound.midi.Track)序列删除。
    
    结果
    
    新创建的轨道
  - deleteTrack
```
public boolean deleteTrack(Track track)
```
    从序列中移除指定的轨道。
    
    参数
    
    track -轨道，去除
    
    结果
    
    true如果在轨道存在的轨道和被删除，否则 false。
    
    另请参见：
    
    createTrack()， getTracks()
  - getTracks
```
public Track[] getTracks()
```
    获取一个包含该序列中所有曲目的数组。如果序列不包含轨道，则返回一个长度为0的数组。
    
    结果
    
    轨道阵列
    
    另请参见：
    
    createTrack()， deleteTrack(javax.sound.midi.Track)
  - getMicrosecondLength
```
public long getMicrosecondLength()
```
    获得该序列的持续时间，表示在微秒。
    
    结果
    
    这个序列的持续时间在微秒。
  - getTickLength
```
public long getTickLength()
```
    获得该序列的持续时间，用MIDI蜱。
    
    结果
    
    该序列的长度在蜱
    
    另请参见：
    
    getMicrosecondLength()
  - getPatchList
```
public Patch[] getPatchList()
```
    获得在此序列中引用的补丁列表。这个补丁列表可用于所需的 Instrument对象加载到 Synthesizer。
    
    结果
    
    对 Patch用这个序列中的对象数组
    
    另请参见：
    
    Synthesizer.loadInstruments(Soundbank, Patch[])

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Sequence

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Field Detail

PPQ

SMPTE_24

SMPTE_25

SMPTE_30DROP

SMPTE_30

divisionType

resolution

tracks

Constructor Detail

Sequence

Sequence

方法详细信息

getDivisionType

getResolution

createTrack

deleteTrack

getTracks

getMicrosecondLength

getTickLength

getPatchList