javax.sound.midi
인터페이스 Sequencer

모든 슈퍼 인터페이스:

MidiDevice

public interface Sequencer

extends MidiDevice

MIDI sequence 를 재생하는 하드웨어 디바이스 또는 소프트웨어 디바이스를,sequencer 라고 말합니다. MIDI 순차 순서에는 표준 MIDI 파일로부터 읽힌 데이터등의, 시각표 나타난 MIDI 데이터의 리스트가 포함됩니다. 대부분의 시퀀서는 순차 순서를 작성해 편집하는 기능도 제공합니다.

Sequencer 인터페이스에는 다음과 같은 기본적인 MIDI 시퀀서 조작이 포함됩니다.

• MIDI 데이터 파일로부터의 순차 순서의 취득
• 재생의 시작과 정지
• 순차 순서상의 임의의 위치에의 이동
• 재생의 템포 (스피드)의 변경
• 내장 시계 또는 수신한 MIDI 메세지에의 재생의 동기화
• 다른 디바이스의 타이밍의 제어

게다가 직접, 또는 Sequencer 를 액세스 할 수 있는 오브젝트를 통해서 간접적으로, 다음의 조작도 서포트됩니다.

• 개개의 MIDI 이벤트 또는 트럭 전체의 추가 또는 삭제에 의한 데이터의 편집
• 순차 순서의 개개의 트럭의 뮤트화 또는 솔로화
• 순차 순서의 재생중에 발생한 메타이벤트 또는 제어 변경 이벤트에 관한 오브젝트의, 청취자에게로의 통지

관련 항목:

Sequencer.SyncMode , addMetaEventListener(javax.sound.midi.MetaEventListener) , ControllerEventListener , Receiver , Transmitter , MidiDevice

중첩된 클래스의 개요

static class

Sequencer.SyncMode SyncMode 오브젝트는 MIDI 시퀀서로 다루어지고 있는 시간을 마스터 또는 슬레이브 디바이스와 동기화하는 방법의 1 개를 표현하고 있습니다.

클래스 javax.sound.midi. MidiDevice 을 상속받은 중첩된 클래스

MidiDevice.Info

메소드의 개요

int[]	addControllerEventListener (ControllerEventListener listener, int[] controllers) 요구된 종류의 제어 변경 이벤트를 시퀀서가 처리할 때에 통지를 받기 위한 콘트롤러 이벤트 청취자를 등록합니다.
boolean	addMetaEventListener (MetaEventListener listener) 메타이벤트가 순차 순서로 발생해 시퀀서에 의해 처리될 때에 통지를 받기 (위해)때문에 메타이벤트리스나를 등록합니다.
Sequencer.SyncMode	getMasterSyncMode () 이 시퀀서의 현재의 마스터 동기 모드를 취득합니다.
Sequencer.SyncMode []	getMasterSyncModes () 이 시퀀서가 서포트하는 마스터 동기 모드세트를 취득합니다.
long	getMicrosecondLength () 현재의 순차 순서의 길이를 마이크로 세컨드 단위로 취득합니다.
long	getMicrosecondPosition () 순차 순서상의 현재의 위치를 마이크로 세컨드 단위로 취득합니다.
Sequence	getSequence () 시퀀서가 현재 조작하고 있는 순차 순서를 취득합니다.
Sequencer.SyncMode	getSlaveSyncMode () 이 시퀀서의 현재의 슬레이브 동기 모드를 취득합니다.
Sequencer.SyncMode []	getSlaveSyncModes () 시퀀서가 서포트하는 슬레이브 동기 모드세트를 취득합니다.
float	getTempoFactor () 시퀀서의 현재의 템포 계수를 돌려줍니다.
float	getTempoInBPM () 1 분 당의 비트로 표시되는 현재의 템포를 취득합니다.
float	getTempoInMPQ () 사분 음표 당의 마이크로 세컨드로 표시되는 현재의 템포를 취득합니다.
long	getTickLength () MIDI 틱으로 표시되는 현재의 순차 순서의 길이를 취득합니다.
long	getTickPosition () 순차 순서의 현재의 위치를 MIDI 틱 단위로 취득합니다 (1 틱의 초단위에서의 듀레이션은 Sequence 에 저장되고 있는 템포와 타이밍 해상도의 양쪽 모두에 의해 정해진다).
boolean	getTrackMute (int track) 트럭의 현재의 뮤트 상태를 취득합니다.
boolean	getTrackSolo (int track) 트럭의 현재의 솔로 상태를 취득합니다.
boolean	isRecording () 시퀀서가 현재 녹음중인가 어떤가를 나타냅니다.
boolean	isRunning () 순차 순서가 현재 실행중인가 어떤가를 나타냅니다.
void	recordDisable (Track track) 지정된 트럭에 대해서, 녹음 불가로 합니다.
void	recordEnable (Track track, int channel) 지정된 트럭에, 특정의 채널로 수신하는 이벤트를 녹음할 준비를 합니다.
int[]	removeControllerEventListener (ControllerEventListener listener, int[] controllers) 1 개이상의 종류의 콘트롤러 이벤트에 대해, 콘트롤러 이벤트 청취자의 처리 대상을 삭제합니다.
void	removeMetaEventListener (MetaEventListener listener) 실제로 청취자가 등록되었을 경우, 이 시퀀서의 등록제청취자의 리스트로부터 지정된 메타이벤트리스나를 삭제합니다.
void	setMasterSyncMode (Sequencer.SyncMode sync) 이 시퀀서가 사용하는 타이밍 정보의 전송원을 설정합니다.
void	setMicrosecondPosition (long microseconds) 순차 순서상의 현재의 위치를 마이크로 세컨드 단위로 설정합니다.
void	setSequence (InputStream stream) 시퀀서가 조작하는 현재의 순차 순서를 설정합니다.
void	setSequence (Sequence sequence) 시퀀서가 조작하는 현재의 순차 순서를 설정합니다.
void	setSlaveSyncMode (Sequencer.SyncMode sync) 시퀀서의 슬레이브 동기 모드를 설정합니다.
void	setTempoFactor (float factor) 지정된 계수에 의해 시퀀서의 실제의 재생 템포를 슬캘링 합니다.
void	setTempoInBPM (float bpm) 템포를 1 분 당의 비트로 설정합니다.
void	setTempoInMPQ (float mpq) 템포를 사분 음표 당의 마이크로 세컨드로 설정합니다.
void	setTickPosition (long tick) 현재의 시퀀서의 위치를 MIDI 틱으로 설정합니다.
void	setTrackMute (int track, boolean mute) 트럭의 뮤트 상태를 설정합니다.
void	setTrackSolo (int track, boolean solo) 트럭의 솔로 상태를 설정합니다.
void	start () 현재 로드 되고 있는 순차 순서의 MIDI 데이터의 재생을 개시합니다.
void	startRecording () MIDI 데이터의 녹음 및 재생을 개시합니다.
void	stop () 액티브의 경우 녹음을 정지해, 현재 로드 되고 있는 순차 순서가 있으면, 그 재생을 정지합니다.
void	stopRecording () 액티브의 경우 녹음을 정지합니다.

인터페이스 javax.sound.midi. MidiDevice 에서 상속받은 메소드

close , getDeviceInfo , getMaxReceivers , getMaxTransmitters , getReceiver , getTransmitter , isOpen , open

메소드의 상세

setSequence

public void setSequence(Sequence  sequence)
                 throws InvalidMidiDataException 

시퀀서가 조작하는 현재의 순차 순서를 설정합니다.

파라미터:

sequence - 로드하는 순차 순서

예외:

InvalidMidiDataException - 순차 순서가 무효인 MIDI 데이터를 포함하고 있는지 또는 순차 순서가 서포트되어 있지 않은 경우

setSequence

public void setSequence(InputStream  stream)
                 throws IOException ,
                        InvalidMidiDataException 

시퀀서가 조작하는 현재의 순차 순서를 설정합니다. 스트림은 MIDI 파일 데이터를 나타낼 필요가 있습니다.

파라미터:

stream - MIDI 파일 데이터를 포함한 스트림

예외:

IOException - 스트림의 read중에 입출력 예외가 발생했을 경우

InvalidMidiDataException - 스트림으로 무효인 데이터가 발생했는지 또는 스트림이 서포트되어 있지 않은 경우

getSequence

public Sequence  getSequence()

시퀀서가 현재 조작하고 있는 순차 순서를 취득합니다.

반환값:

현재의 순차 순서, 또는 순차 순서가 현재 설정되어 있지 않은 경우는 null

start

public void start()

현재 로드 되고 있는 순차 순서의 MIDI 데이터의 재생을 개시합니다.

관련 항목:

start() , stop()

stop

public void stop()

액티브의 경우 녹음을 정지해, 현재 로드 되고 있는 순차 순서가 있으면, 그 재생을 정지합니다.

관련 항목:

start() , isRunning()

isRunning

public boolean isRunning()

순차 순서가 현재 실행중인가 어떤가를 나타냅니다. 디폴트는 false 입니다. start() 또는 startRecording() 가 불려 가면(자), 시퀀서는 실행을 개시합니다. 그 후 순차 순서의 재생이 완료하는지 또는 stop() 가 불려 갈 때까지 isRunning 가 true 를 돌려줍니다.

반환값:

시퀀서가 실행중의 경우는 true, 그렇지 않은 경우는 false

startRecording

public void startRecording()

MIDI 데이터의 녹음 및 재생을 개시합니다. 데이터는 트럭이 사용 가능하게 되어 있는 채널의, 사용 가능한 전트럭에 녹음됩니다. 녹음은 시퀀서의 현재의 위치에서 개시됩니다. 벌써 트렁크에 있는 이벤트는 녹음 세션중에 덧쓰기됩니다. 현재 로드 되고 있는 시퀀서로부터의 이벤트가 있으면, 그 이벤트는 녹음중에 수신한 메세지와 함께 시퀀서의 MIDI OUT 리시버에 전달됩니다.

트럭은 디폴트에서는 녹음 가능하게 되어 있지 않습니다. MIDI 데이터를 녹음하기 위해서는 적어도 1 개의 트럭이 구체적으로 녹음 가능하게 되어 있을 필요가 있습니다.

관련 항목:

startRecording() , recordEnable(javax.sound.midi.Track, int) , recordDisable(javax.sound.midi.Track)

stopRecording

public void stopRecording()

액티브의 경우 녹음을 정지합니다. 현재의 순차 순서의 재생은 계속합니다.

관련 항목:

startRecording() , isRecording()

isRecording

public boolean isRecording()

시퀀서가 현재 녹음중인가 어떤가를 나타냅니다. 디폴트는 false 입니다. 시퀀서는 startRecording() 가 불려 가면(자) 녹음을 개시해, 그 후는 stop() 또는 stopRecording() 가 불려 갈 때까지 true 를 돌려줍니다.

반환값:

시퀀서가 녹음중의 경우는 true, 그렇지 않은 경우는 false

recordEnable

public void recordEnable(Track  track,
                         int channel)

지정된 트럭에, 특정의 채널로 수신하는 이벤트를 녹음할 준비를 합니다. 트럭을 사용 가능하게 해 두면(자), 녹음이 액티브하게 되었을 때에 이벤트를 수신합니다.

파라미터:

track - 이벤트가 녹음되는 트럭

channel - 이벤트가 수신되는 채널. 채널치에 -1 가 지정되고 있는 경우, 트럭은 전채널로부터의 데이터를 수신한다

예외:

IllegalArgumentException - 트럭이 현재의 순차 순서가 일부에서 없는 경우, 슬로우 된다

recordDisable

public void recordDisable(Track  track)

지정된 트럭에 대해서, 녹음 불가로 합니다. 그 이후의 이벤트는 이 트럭에는 녹음되지 않습니다.

파라미터:

track - 녹음을 불가로 하는 트럭, 또는 전트럭을 녹음 불가로 하는 경우는 null

getTempoInBPM

public float getTempoInBPM()

1 분 당의 비트로 표시되는 현재의 템포를 취득합니다. 재생의 실제의 템포는 돌려주어진 값 및 템포 계수로 정해집니다.

반환값:

1 분 당의 비트로 표시되는 현재의 템포

관련 항목:

getTempoFactor() , setTempoInBPM(float) , getTempoInMPQ()

setTempoInBPM

public void setTempoInBPM(float bpm)

템포를 1 분 당의 비트로 설정합니다. 재생의 실제의 템포는 지정된 값 및 템포 계수로 정해집니다.

파라미터:

bpm - 1 분 당의 비트로 표시되는 바람직한 새로운 템포

관련 항목:

getTempoFactor() , setTempoInMPQ(float) , getTempoInBPM()

getTempoInMPQ

public float getTempoInMPQ()

사분 음표 당의 마이크로 세컨드로 표시되는 현재의 템포를 취득합니다. 재생의 실제의 템포는 돌려주어진 값 및 템포 계수로 정해집니다.

반환값:

사분 음표 당의 마이크로 세컨드로 표시되는 현재의 템포

관련 항목:

getTempoFactor() , setTempoInMPQ(float) , getTempoInBPM()

setTempoInMPQ

public void setTempoInMPQ(float mpq)

템포를 사분 음표 당의 마이크로 세컨드로 설정합니다. 재생의 실제의 템포는 지정된 값 및 템포 계수로 정해집니다.

파라미터:

mpq - 사분 음표 당의 마이크로 세컨드로 표시되는 바람직한 새로운 템포

관련 항목:

getTempoFactor() , setTempoInBPM(float) , getTempoInMPQ()

setTempoFactor

public void setTempoFactor(float factor)

지정된 계수에 의해 시퀀서의 실제의 재생 템포를 슬캘링 합니다. 디폴트는 1.0 입니다. 1.0 이라고 하는 값은 통상의 속도 (순차 순서로 지정된 템포)를 나타내, 2.0 은 2 배속 있고 일을 나타냅니다. 템포 계수는 getTempoInMPQ() 및 getTempoInBPM() 에 의해 돌려주어진 값에는 영향을 주지 않습니다. 이러한 값은 슬캘링전의 템포를 나타냅니다.

외부 동기가 사용되고 있는 경우는 템포 계수는 조정할 수 없습니다. 외부 동기가 사용되고 있는 경우,setTempoFactor 는 템포 계수를 항상 1.0 으로 설정합니다.

파라미터:

factor - 요구된 템포 스칼라

관련 항목:

getTempoFactor()

getTempoFactor

public float getTempoFactor()

시퀀서의 현재의 템포 계수를 돌려줍니다. 디폴트는 1.0 입니다.

반환값:

템포 계수

관련 항목:

setTempoFactor(float)

getTickLength

public long getTickLength()

MIDI 틱으로 표시되는 현재의 순차 순서의 길이를 취득합니다.

반환값:

틱 표시에 의한 이 순차 순서의 길이

getTickPosition

public long getTickPosition()

순차 순서의 현재의 위치를 MIDI 틱 단위로 취득합니다 (1 틱의 초단위에서의 듀레이션은 Sequence 에 저장되고 있는 템포와 타이밍 해상도의 양쪽 모두에 의해 정해진다).

반환값:

현재의 틱

관련 항목:

setTickPosition(long)

setTickPosition

public void setTickPosition(long tick)

현재의 시퀀서의 위치를 MIDI 틱으로 설정합니다.

파라미터:

tick - 바람직한 틱의 위치

관련 항목:

getTickPosition()

getMicrosecondLength

public long getMicrosecondLength()

현재의 순차 순서의 길이를 마이크로 세컨드 단위로 취득합니다.

반환값:

마이크로 세컨드 단위에서의 순차 순서의 길이

getMicrosecondPosition

public long getMicrosecondPosition()

순차 순서상의 현재의 위치를 마이크로 세컨드 단위로 취득합니다.

정의:

인터페이스 MidiDevice 내의 getMicrosecondPosition

반환값:

마이크로 세컨드 단위에서의 현재의 위치

관련 항목:

setMicrosecondPosition(long)

setMicrosecondPosition

public void setMicrosecondPosition(long microseconds)

순차 순서상의 현재의 위치를 마이크로 세컨드 단위로 설정합니다.

파라미터:

microseconds - 마이크로 세컨드 단위에서의 바람직한 위치

관련 항목:

getMicrosecondPosition()

setMasterSyncMode

public void setMasterSyncMode(Sequencer.SyncMode  sync)

이 시퀀서가 사용하는 타이밍 정보의 전송원을 설정합니다. 시퀀서는 마스터에 동기화합니다. 마스터는 sync 의 값에 의해 내장 시계, MIDI 클락, 또는 MIDI 타임 코드의 어떤 것인가가 됩니다. sync 인수는 getMasterSyncModes() 에 의해 돌려주어지는 서포트 대상 모드의 1 개인 것이 필요합니다.

파라미터:

sync - 바람직한 마스터 동기 모드

관련 항목:

Sequencer.SyncMode.INTERNAL_CLOCK , Sequencer.SyncMode.MIDI_SYNC , Sequencer.SyncMode.MIDI_TIME_CODE , getMasterSyncMode()

getMasterSyncMode

public Sequencer.SyncMode  getMasterSyncMode()

이 시퀀서의 현재의 마스터 동기 모드를 취득합니다.

반환값:

현재의 마스터 동기 모드

관련 항목:

setMasterSyncMode(Sequencer.SyncMode) , getMasterSyncModes()

getMasterSyncModes

public Sequencer.SyncMode [] getMasterSyncModes()

이 시퀀서가 서포트하는 마스터 동기 모드세트를 취득합니다.

반환값:

사용 가능한 마스터 동기 모드

관련 항목:

Sequencer.SyncMode.INTERNAL_CLOCK , Sequencer.SyncMode.MIDI_SYNC , Sequencer.SyncMode.MIDI_TIME_CODE , getMasterSyncMode() , setMasterSyncMode(Sequencer.SyncMode)

setSlaveSyncMode

public void setSlaveSyncMode(Sequencer.SyncMode  sync)

시퀀서의 슬레이브 동기 모드를 설정합니다. 이것은 시퀀서로부터 리시버에 송신되는 타이밍 정보의 종류를 나타냅니다. sync 인수는 getSlaveSyncModes() 에 의해 돌려주어지는 서포트 대상 모드의 1 개인 것이 필요합니다.

파라미터:

sync - 바람직한 슬레이브 동기 모드

관련 항목:

Sequencer.SyncMode.MIDI_SYNC , Sequencer.SyncMode.MIDI_TIME_CODE , Sequencer.SyncMode.NO_SYNC , getSlaveSyncModes()

getSlaveSyncMode

public Sequencer.SyncMode  getSlaveSyncMode()

이 시퀀서의 현재의 슬레이브 동기 모드를 취득합니다.

반환값:

현재의 슬레이브 동기 모드

관련 항목:

setSlaveSyncMode(Sequencer.SyncMode) , getSlaveSyncModes()

getSlaveSyncModes

public Sequencer.SyncMode [] getSlaveSyncModes()

시퀀서가 서포트하는 슬레이브 동기 모드세트를 취득합니다.

반환값:

사용 가능한 슬레이브 동기 모드

관련 항목:

Sequencer.SyncMode.MIDI_SYNC , Sequencer.SyncMode.MIDI_TIME_CODE , Sequencer.SyncMode.NO_SYNC

setTrackMute

public void setTrackMute(int track,
                         boolean mute)

트럭의 뮤트 상태를 설정합니다. 이 메소드는 다수의 이유에 의해 실패하는 일이 있습니다. 예를 들어, 지정된 트럭 번호가 현재의 순차 순서에 유효하지 않은 혹은 시퀀서가 이 기능을 서포트하고 있지 않는 등입니다. 이 조작이 완료했는지 어떠했는지를 확인할 필요가 있는 어플리케이션의 경우, 이 호출에 이어 getTrackMute(int) 의 호출을 실시합니다.

파라미터:

track - 트럭 번호. 현재의 순차 순서의 트럭은 0 으로부터 순차 순서의 트럭수 빼는 1 의 범위에서 번호 붙이고 되는

mute - 트럭의 새로운 뮤트 상태. true 는 트럭이 뮤트인 것을 의미해,false 는 트럭이 뮤트가 아닌 것을 의미하는

관련 항목:

getSequence()

getTrackMute

public boolean getTrackMute(int track)

트럭의 현재의 뮤트 상태를 취득합니다. 뮤트로 되어 있지 않은 전트럭의 디폴트 뮤트 상태는 false 입니다. 어쨌든, 지정된 트럭이 뮤트로 되어 있지 않은 경우, 이 메소드는 false 를 돌려줍니다. 이것은 시퀀서가 트럭의 뮤트화를 서포트하고 있지 않는 경우, 및 지정된 트럭 인덱스가 유효하지 않은 경우입니다.

파라미터:

track - 트럭 번호. 현재의 순차 순서의 트럭은 0 으로부터 순차 순서의 트럭수 빼는 1 의 범위에서 번호 붙이고 된다

반환값:

뮤트의 경우는 true, 그렇지 않은 경우는 false

setTrackSolo

public void setTrackSolo(int track,
                         boolean solo)

트럭의 솔로 상태를 설정합니다. solo 가 true 의 경우는 이 트럭 및 솔로가 되어 있는 다른 트럭의 소리만이 들립니다. solo 가 false 의 경우는 솔로가 되어 있는 다른 트럭의 소리만이 들립니다만, 솔로가 되어 있는 트럭이 없을 때는 뮤트로 되어 있지 않은 트럭의 소리가 모두 들립니다.

이 메소드는 다수의 이유에 의해 실패하는 일이 있습니다. 예를 들어, 지정된 트럭 번호가 현재의 순차 순서에 유효하지 않은 혹은 시퀀서가 이 기능을 서포트하고 있지 않는 등입니다. 이 조작이 완료했는지 어떠했는지를 확인할 필요가 있는 어플리케이션의 경우, 이 호출에 이어 getTrackSolo(int) 의 호출을 실시합니다.

파라미터:

track - 트럭 번호. 현재의 순차 순서의 트럭은 0 으로부터 순차 순서의 트럭수 빼는 1 의 범위에서 번호 붙이고 되는

solo - 트럭의 새로운 솔로 상태. true 는 트럭이 솔로인 것을 의미해,false 는 트럭이 솔로가 아닌 것을 의미하는

관련 항목:

getSequence()

getTrackSolo

public boolean getTrackSolo(int track)

트럭의 현재의 솔로 상태를 취득합니다. 솔로로 되어 있지 않은 전트럭의 디폴트 뮤트 상태는 false 입니다. 어쨌든, 지정된 트럭이 솔로로 되어 있지 않은 경우, 이 메소드는 false 를 돌려줍니다. 이것은 시퀀서가 트럭의 솔로화를 서포트하고 있지 않는 경우, 및 지정된 트럭 인덱스가 유효하지 않은 경우입니다.

파라미터:

track - 트럭 번호. 현재의 순차 순서의 트럭은 0 으로부터 순차 순서의 트럭수 빼는 1 의 범위에서 번호 붙이고 된다

반환값:

솔로의 경우는 true, 그렇지 않은 경우는 false

addMetaEventListener

public boolean addMetaEventListener(MetaEventListener  listener)

메타이벤트가 순차 순서로 발생해 시퀀서에 의해 처리될 때에 통지를 받기 (위해)때문에 메타이벤트리스나를 등록합니다.

파라미터:

listener - 추가하는 청취자

반환값:

청취자의 추가가 완료했을 경우는 true, 그렇지 않은 경우는 false

관련 항목:

removeMetaEventListener(javax.sound.midi.MetaEventListener) , MetaEventListener , MetaMessage

removeMetaEventListener

public void removeMetaEventListener(MetaEventListener  listener)

실제로 청취자가 등록되었을 경우, 이 시퀀서의 등록제청취자의 리스트로부터 지정된 메타이벤트리스나를 삭제합니다.

파라미터:

listener - 삭제하는 메타이벤트리스나

관련 항목:

addMetaEventListener(javax.sound.midi.MetaEventListener)

addControllerEventListener

public int[] addControllerEventListener(ControllerEventListener  listener,
                                        int[] controllers)

요구된 종류의 제어 변경 이벤트를 시퀀서가 처리할 때에 통지를 받기 위한 콘트롤러 이벤트 청취자를 등록합니다. 종류는 MIDI 콘트롤러 번호의 배열을 포함한 controllers 인수에 의해 지정됩니다 ( 각 번호는 0 에서 127 까지. 다양한 종류의 콘트롤러에 대응하는 번호에 대해서는 「MIDI 1.0 Specification」를 참조).

돌려주어진 배열에는 청취자가 지금 수신하려고 하는 이벤트의 MIDI 콘트롤러 번호를 포함합니다. 시퀀서에 따라서는 콘트롤러 이벤트 통지를 서포트하고 있지 않는 경우가 있어, 그 경우, 배열의 길이는 0 입니다. 다른 시퀀서는 몇개의 콘트롤러의 통지를 서포트합니다만, 전콘트롤러에 대해가 아닙니다. 이 메소드는 반복해 불려 가는 일이 있습니다. 각 회 모두, 돌려주어진 배열은 그 특정의 호출로 요구된 콘트롤러 뿐만이 아니라, 청취자가 통지를 받는 전콘트롤러를 나타냅니다

파라미터:

listener - 등록제청취자의 리스트에 추가하는 콘트롤러 이벤트 청취자

controllers - 변경 통지가 요구되는 MIDI 콘트롤러 번호

반환값:

지정된 청취자에게 향후 변경이 보고되는 전 MIDI 콘트롤러의 번호

관련 항목:

removeControllerEventListener(javax.sound.midi.ControllerEventListener, int[]) , ControllerEventListener

removeControllerEventListener

public int[] removeControllerEventListener(ControllerEventListener  listener,
                                           int[] controllers)

1 kr 이상의 종류의 콘트롤러 이벤트에 대해, 콘트롤러 이벤트 청취자의 처리 대상을 삭제합니다. controllers 인수는 청취자가 향후 변경 통지를 받지 않는 콘트롤러에 대응하는 MIDI 번호의 배열입니다. 등록제청취자의 리스트로부터 이 청취자를 완전하게 삭제하려면 ,controllers 에 null 를 건네줍니다. 되돌려진 배열에는 청취자가 향후 이벤트를 수신하는 MIDI 콘트롤러의 번호를 포함하고 있습니다. 청취자가 어느 콘트롤러의 변경 통지도 수신하지 않는 경우, 배열의 길이는 0 입니다.

파라미터:

listener - 낡은 청취자

controllers - 변경 통지를 취소하는 MIDI 콘트롤러 번호, 또는 전콘트롤러에 대해서 취소하는 경우는 null

반환값:

지정된 청취자에게 향후 변경이 보고되는 전 MIDI 콘트롤러의 번호

관련 항목:

addControllerEventListener(javax.sound.midi.ControllerEventListener, int[])