javax.sound.midi
인터페이스 MidiDevice

기존의 서브 인터페이스의 일람:

Sequencer , Synthesizer

public interface MidiDevice

MidiDevice 는 전 MIDI 디바이스의 기본 인터페이스입니다. 공통 디바이스에는 신디사이저, 시퀀서, MIDI 입력 포토, 및 MIDI 출력 포토가 포함됩니다. MidiDevice 는 MIDI 이벤트의 트랜스미터 또는 리시버, 혹은 그 양쪽 모두가 됩니다. 이 때문에,MidiDevice 은 통상,Transmitter 또는 Receiver 인터페이스 (또는 양쪽 모두)를 구현하고 있든가, 혹은 구현하고 있는 오브젝트에 액세스 할 수 있습니다.

MidiDevice 에는 제조자 정보등을 제공하는 MidiDevice.Info 오브젝트가 포함됩니다.

관련 항목:

Synthesizer , Sequencer , MidiChannel.setMono(boolean)

중첩된 클래스의 개요

static class

MidiDevice.Info MidiDevice.Info 오브젝트는 디바이스의 이름, 제작 회사명, 설명 텍스트 등,MidiDevice 에 관련하는 데이터를 포함하고 있습니다.

메소드의 개요

void	close () 디바이스를 닫아 사용하고 있던 system resource를 디바이스가 해방하는 것을 나타냅니다.
MidiDevice.Info	getDeviceInfo () Java 클래스와 이름, 벤더 및 설명등의 Strings 를 포함한, 디바이스에 관한 정보를 취득합니다.
int	getMaxReceivers () 이 MIDI 디바이스로 MIDI 데이터를 수신하는데 사용 가능한 MIDI IN 접속의 최대수를 취득합니다.
int	getMaxTransmitters () 이 MIDI 디바이스로 MIDI 데이터를 전송 하는데 사용 가능한 MIDI OUT 접속의 최대수를 취득합니다.
long	getMicrosecondPosition () 디바이스의 현재의 시각표시를 마이크로 세컨드 단위로 취득합니다.
Receiver	getReceiver () MIDI 디바이스가 MIDI 데이터를 수신하는데 경유하는 MIDI IN 리시버를 취득합니다.
Transmitter	getTransmitter () MIDI 디바이스가 MIDI 데이터를 전송 하는 MIDI OUT 접속을 취득합니다.
boolean	isOpen () 디바이스가 열려 있을지 어떨지를 보고합니다.
void	open () 디바이스를 열어, 필요한 system resource를 디바이스가 획득해 조작 가능하게 되어 있는 것을 나타냅니다.

메소드의 상세

getDeviceInfo

public MidiDevice.Info  getDeviceInfo()

Java 클래스와 이름, 벤더 및 설명등의 Strings 를 포함한, 디바이스에 관한 정보를 취득합니다.

반환값:

디바이스 정보

open

public void open()
          throws MidiUnavailableException 

디바이스를 열어, 필요한 system resource를 디바이스가 획득해 조작 가능하게 되어 있는 것을 나타냅니다.

디바이스에 따라서는 한 번 닫으면(자) 다시 열 수 없는 점에 주의해 주세요. 이러한 디바이스를 재차 열려고 하면(자), 항상 MidiUnavailableException 가 됩니다.

예외:

MidiUnavailableException - 리소스의 제약을 위해서(때문에) 디바이스를 열지 않는 경우에 슬로우 된다

SecurityException - 리소스의 제약을 위해서(때문에) 디바이스를 열지 않는 경우에 슬로우 되는

관련 항목:

close() , isOpen()

close

public void close()

디바이스를 닫아 사용하고 있던 system resource를 디바이스가 해방하는 것을 나타냅니다.

관련 항목:

open() , isOpen()

isOpen

public boolean isOpen()

디바이스가 열려 있을지 어떨지를 보고합니다. 특정의 디바이스를 여는 기구는 서브 인터페이스에 의해, 또는 이 인터페이스를 구현하고 있는 클래스에 의해, 혹은 그 양쪽 모두에 의해 정의됩니다.

반환값:

디바이스가 열려 있는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

close()

getMicrosecondPosition

public long getMicrosecondPosition()

디바이스의 현재의 시각표시를 마이크로 세컨드 단위로 취득합니다. 디바이스가 시각표시를 서포트하고 있는 경우는 디바이스가 열렸을 때에 0 으로부터 카운트하기 시작해 디바이스가 닫혀질 때까지 마이크로 세컨드 단위로 카운트 계속 합니다. 디바이스가 시각표시를 서포트하고 있지 않는 경우는 항상 -1 에 돌아옵니다.

반환값:

마이크로 세컨드 단위에서의 디바이스의 현재의 시각표시, 또는 디바이스가 시각표시를 서포트하고 있지 않는 경우는 -1

getMaxReceivers

public int getMaxReceivers()

이 MIDI 디바이스로 MIDI 데이터를 수신하는데 사용 가능한 MIDI IN 접속의 최대수를 취득합니다.

반환값:

MIDI IN 접속의 최대수

getMaxTransmitters

public int getMaxTransmitters()

이 MIDI 디바이스로 MIDI 데이터를 전송 하는데 사용 가능한 MIDI OUT 접속의 최대수를 취득합니다.

반환값:

MIDI OUT 접속의 최대수

getReceiver

public Receiver  getReceiver()
                     throws MidiUnavailableException 

MIDI 디바이스가 MIDI 데이터를 수신하는데 경유하는 MIDI IN 리시버를 취득합니다. 돌려주어진 리시버는 어플리케이션이 그 리시버의 사용을 끝냈을 때에 닫을 필요가 있습니다.

반환값:

디바이스의 리시버

예외:

MidiUnavailableException - 리소스의 제약을 위해서(때문에) 리시버를 사용할 수 없는 경우는 슬로우 되는

관련 항목:

Receiver.close()

getTransmitter

public Transmitter  getTransmitter()
                           throws MidiUnavailableException 

MIDI 디바이스가 MIDI 데이터를 전송 하는 MIDI OUT 접속을 취득합니다. 돌려주어진 트랜스미터는 어플리케이션이 그 트랜스미터의 사용을 끝냈을 때에 닫을 필요가 있습니다.

반환값:

디바이스의 MIDI OUT 트랜스미터

예외:

MidiUnavailableException - 리소스의 제약을 위해서(때문에) 트랜스미터를 사용할 수 없는 경우에 슬로우 되는

관련 항목:

Transmitter.close()