javax.sound.midi
클래스 MidiSystem

java.lang.Object 
  |
  +--javax.sound.midi.MidiSystem

public class MidiSystem

extends Object

MidiSystem 클래스는 신디사이저, 시퀀서, MIDI 입출력 포토등의 디바이스를 포함한 인스톨제 MIDI system resource에의 액세스를 제공합니다. 일반적으로 볼 수 있는 단순한 MIDI 어플리케이션은 1 kr 이상의 MidiSystem 메소드를 호출해, 어느 디바이스가 인스톨 되고 있는지를 인지해, 그 어플리케이션에 필요한 디바이스를 취득하는 것으로부터 시작합니다.

또, 클래스에는 파일, 스트림, 및 표준 MIDI 파일 데이터 또는 사운드 뱅크를 포함한 URL 의 read용 메소드도 있습니다. 지정된 MIDI 파일의 형식을 MidiSystem 에 조회할 수 있습니다.

MidiSystem 를 인스턴스화할 수 없습니다. 메소드는 모두 정적입니다.

메소드의 개요

static MidiDevice	getMidiDevice (MidiDevice.Info info) 요구된 MIDI 디바이스를 취득합니다.
static MidiDevice.Info []	getMidiDeviceInfo () 시스템으로 사용 가능한 전 MIDI 디바이스세트를 나타내는 정보 오브젝트의 배열을 취득합니다.
static MidiFileFormat	getMidiFileFormat (File file) 지정된 File 의 MIDI 파일 형식을 취득합니다.
static MidiFileFormat	getMidiFileFormat (InputStream stream) 지정된 입력 스트림의 데이터의 MIDI 파일 형식을 취득합니다.
static MidiFileFormat	getMidiFileFormat (URL url) 지정된 URL 의 데이터의 MIDI 파일 형식을 취득합니다.
static int[]	getMidiFileTypes () 시스템이 파일 기입 서포트를 제공하는 MIDI 파일 타입세트를 취득합니다.
static int[]	getMidiFileTypes (Sequence sequence) 지정된 순차 순서로부터 시스템이 기입해 가능한 MIDI 파일 타입세트를 취득합니다.
static Receiver	getReceiver () 외부 MIDI 포토 또는 다른 디폴트 소스로부터, MIDI 리시버를 취득합니다.
static Sequence	getSequence (File file) 지정된 File 로부터 MIDI 순차 순서를 취득합니다.
static Sequence	getSequence (InputStream stream) 지정된 입력 스트림으로부터 MIDI 순차 순서를 취득합니다.
static Sequence	getSequence (URL url) 지정된 URL 로부터 MIDI 순차 순서를 취득합니다.
static Sequencer	getSequencer () 디폴트 시퀀서를 취득합니다.
static Soundbank	getSoundbank (File file) 지정된 File 로부터 Soundbank 를 읽어들이는 것에 의해,Soundbank 를 구축합니다.
static Soundbank	getSoundbank (InputStream stream) 지정된 스트림으로부터 MIDI 사운드 뱅크를 읽어들이는 것에 의해, MIDI 사운드 뱅크를 구축합니다.
static Soundbank	getSoundbank (URL url) 지정된 URL 로부터 Soundbank 를 읽어들이는 것에 의해,Soundbank 를 구축합니다.
static Synthesizer	getSynthesizer () 디폴트 신디사이저를 취득합니다.
static Transmitter	getTransmitter () 외부 MIDI 포토 또는 다른 디폴트 소스로부터, MIDI 트랜스미터를 취득합니다.
static boolean	isFileTypeSupported (int fileType) 지정된 MIDI 파일 타입의 파일 기입 서포트를 시스템이 제공하고 있을지 어떨지를 나타냅니다.
static boolean	isFileTypeSupported (int fileType, Sequence sequence) 지정된 파일 타입의 MIDI 파일을, 나타난 순차 순서로부터 기입할 수 있을지 어떨지를 나타냅니다.
static int	write (Sequence in, int type, File out) 제공되는 외부 파일에 나타나는 MIDI 파일 타입을 나타내는 바이트의 스트림을 기입합니다.
static int	write (Sequence in, int fileType, OutputStream out) 제공되는 외부 스트림에 나타나는 MIDI 파일 타입을 나타내는 바이트의 스트림을 기입합니다.

클래스 java.lang. Object 에서 상속받은 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

메소드의 상세

getMidiDeviceInfo

public static MidiDevice.Info [] getMidiDeviceInfo()

시스템으로 사용 가능한 전 MIDI 디바이스세트를 나타내는 정보 오브젝트의 배열을 취득합니다. 돌려주어진 정보 오브젝트를 사용해,getMidiDevice 를 호출해 해당의 디바이스를 취득할 수 있습니다.

반환값:

MidiDevice.Info 오브젝트의 배열로, 인스톨 된 MIDI 디바이스 마다 1 개의 배열이 돌려주어진다. 해당하는 디바이스가 인스톨되어 있지 않은 경우, 길이 0 의 배열이 돌려주어진다

getMidiDevice

public static MidiDevice  getMidiDevice(MidiDevice.Info  info)
                                throws MidiUnavailableException 

요구된 MIDI 디바이스를 취득합니다.

파라미터:

info - 목적의 디바이스를 나타내는 디바이스 정보 오브젝트

반환값:

요구된 디바이스

예외:

MidiUnavailableException - 리소스의 제약을 위해서(때문에), 요구된 디바이스를 사용할 수 없는 경우

IllegalArgumentException - 시스템에 인스톨 된 MIDI 디바이스를 정보 오브젝트가 표시하지 않는 경우

관련 항목:

getMidiDeviceInfo()

getReceiver

public static Receiver  getReceiver()
                            throws MidiUnavailableException 

외부 MIDI 포토 또는 다른 디폴트 소스로부터, MIDI 리시버를 취득합니다.

반환값:

디폴트 MIDI 리시버

예외:

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

getTransmitter

public static Transmitter  getTransmitter()
                                  throws MidiUnavailableException 

외부 MIDI 포토 또는 다른 디폴트 소스로부터, MIDI 트랜스미터를 취득합니다.

반환값:

디폴트 MIDI 트랜스미터

예외:

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

getSynthesizer

public static Synthesizer  getSynthesizer()
                                  throws MidiUnavailableException 

디폴트 신디사이저를 취득합니다.

반환값:

디폴트 신디사이저

예외:

MidiUnavailableException - 리소스의 제약을 위해서(때문에) 그 신디사이저를 사용할 수 없는 경우

getSequencer

public static Sequencer  getSequencer()
                              throws MidiUnavailableException 

디폴트 시퀀서를 취득합니다.

반환값:

디폴트 시퀀서

예외:

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

getSoundbank

public static Soundbank  getSoundbank(InputStream  stream)
                              throws InvalidMidiDataException ,
                                     IOException 

지정된 스트림으로부터 MIDI 사운드 뱅크를 읽어들이는 것에 의해, MIDI 사운드 뱅크를 구축합니다. 스트림은 유효한 MIDI 사운드 뱅크 파일을 나타낼 필요가 있습니다. 일반적으로, MIDI 사운드 뱅크 프로바이더는 그 스트림을 서포트할지 어떨지를 판정하기 전에 데이터를 얼마인가 읽어들일 필요가 있습니다. 이러한 구문 분석에는 스트림을 마크 해, 스트림을 서포트할지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 서포트하지 않는 경우는 스트림의 read 포인터도와의 위치에 되돌린다, 라고 하는 기능이 필요합니다. 입력 스트림이 이것을 서포트하지 않는 경우, 이 메소드는 IOException 를 슬로우 해 실패합니다.

파라미터:

stream - 사운드 뱅크 데이터의 소스

반환값:

사운드 뱅크

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 사운드 뱅크 데이터를 스트림이 가리키지 않는 경우

IOException - 사운드 뱅크를 로드할 때에 입출력 에러가 발생했을 경우

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getSoundbank

public static Soundbank  getSoundbank(URL  url)
                              throws InvalidMidiDataException ,
                                     IOException 

지정된 URL 로부터 Soundbank 를 읽어들이는 것에 의해,Soundbank 를 구축합니다. URL 는 유효한 MIDI 사운드 뱅크 파일을 나타낼 필요가 있습니다.

파라미터:

url - 사운드 뱅크 데이터의 소스

반환값:

사운드 뱅크

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 사운드 뱅크 데이터를 URL 가 가리키지 않는 경우

IOException - 사운드 뱅크를 로드할 때에 입출력 에러가 발생했을 경우

getSoundbank

public static Soundbank  getSoundbank(File  file)
                              throws InvalidMidiDataException ,
                                     IOException 

지정된 File 로부터 Soundbank 를 읽어들이는 것에 의해,Soundbank 를 구축합니다. File 는 유효한 MIDI 사운드 뱅크 파일을 나타낼 필요가 있습니다.

파라미터:

file - 사운드 뱅크 데이터의 소스

반환값:

사운드 뱅크

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 사운드 뱅크 데이터를 File 가 가리키지 않는 경우

IOException - 사운드 뱅크를 로드할 때에 입출력 에러가 발생했을 경우

getMidiFileFormat

public static MidiFileFormat  getMidiFileFormat(InputStream  stream)
                                        throws InvalidMidiDataException ,
                                               IOException 

지정된 입력 스트림의 데이터의 MIDI 파일 형식을 취득합니다. 스트림은 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 메소드 또는 이 메소드가 호출하는 코드, 혹은 그 양쪽 모두, 그 데이터 형식이 서포트될지 어떨지를 판정하기 위해서 스트림으로부터 데이터를 얼마인가 읽어들일 필요가 있습니다. 따라서, 스트림을 마크 해, 데이터가 서포트되는 형식일지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 스트림의 리드 포인터도와의 위치에 되돌리기 위한 구현이 필요합니다. 입력 스트림이 이 일련의 조작을 허가하지 않는 경우, 이 메소드는 IOException 를 슬로우 해 실패합니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 형식을 판별중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

stream - 파일 형식 정보를 추출하는 입력 스트림

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 스트림이 가리키지 않는 경우

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

관련 항목:

getMidiFileFormat(URL) , getMidiFileFormat(File) , InputStream.markSupported() , InputStream.mark(int)

getMidiFileFormat

public static MidiFileFormat  getMidiFileFormat(URL  url)
                                        throws InvalidMidiDataException ,
                                               IOException 

지정된 URL 의 데이터의 MIDI 파일 형식을 취득합니다. URL 는 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 형식을 판별중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

url - 파일 형식 정보를 추출하는 URL

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 URL 가 가리키지 않는 경우

IOException - URL 에 액세스중에 입출력 예외가 발생했을 경우

관련 항목:

getMidiFileFormat(InputStream) , getMidiFileFormat(File)

getMidiFileFormat

public static MidiFileFormat  getMidiFileFormat(File  file)
                                        throws InvalidMidiDataException ,
                                               IOException 

지정된 File 의 MIDI 파일 형식을 취득합니다. File 는 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 형식을 판별중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

file - 파일 형식 정보를 추출하는 File

반환값:

MIDI 파일 형식을 기술하는 MidiFileFormat 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 File 가 가리키지 않는 경우

IOException - 파일에 액세스중에 입출력 예외가 발생했을 경우

관련 항목:

getMidiFileFormat(InputStream) , getMidiFileFormat(URL)

getSequence

public static Sequence  getSequence(InputStream  stream)
                            throws InvalidMidiDataException ,
                                   IOException 

지정된 입력 스트림으로부터 MIDI 순차 순서를 취득합니다. 스트림은 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 메소드 또는 이 메소드가 호출하는 코드, 혹은 그 양쪽 모두, 그 데이터 형식이 서포트될지 어떨지를 판정하기 위해서 스트림으로부터 데이터를 얼마인가 읽어들일 필요가 있습니다. 따라서, 스트림을 마크 해, 데이터가 서포트되는 형식일지 어떨지를 판정하는데 충분한 데이터를 읽어들여, 스트림의 리드 포인터도와의 위치에 되돌리기 위한 구현이 필요합니다. 입력 스트림이 이 일련의 조작을 허가하지 않는 경우, 이 메소드는 IOException 를 슬로우 해 실패합니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 데이터로부터 Sequence 오브젝트를 구축중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

stream - Sequence 를 구축하는 입력 스트림

반환값:

입력 스트림에 포함되는 MIDI 파일 데이터에 근거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 스트림이 가리키지 않는 경우

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

관련 항목:

InputStream.markSupported() , InputStream.mark(int)

getSequence

public static Sequence  getSequence(URL  url)
                            throws InvalidMidiDataException ,
                                   IOException 

지정된 URL 로부터 MIDI 순차 순서를 취득합니다. URL 는 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 데이터로부터 Sequence 오브젝트를 구축중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

url - Sequence 를 구축하는 URL

반환값:

URL 가 가리키는 MIDI 파일 데이터에 의거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 URL 가 가리키지 않는 경우

IOException - URL 에 액세스중에 입출력 예외가 발생했을 경우

getSequence

public static Sequence  getSequence(File  file)
                            throws InvalidMidiDataException ,
                                   IOException 

지정된 File 로부터 MIDI 순차 순서를 취득합니다. File 는 시스템이 인식한 파일 타입에 유효한 MIDI 파일 데이터를 나타낼 필요가 있습니다.

이 조작은 인스톨 된 파일 리더에 의해 구문 분석 할 수 있는 종류의 파일에 한정해 유효합니다. 호환성이 있는 파일 리더가 인스톨되어 있지 않은 경우, 유효한 파일에서도 InvalidMidiDataException 를 슬로우 해 실패할 가능성이 있습니다. 호환성이 있는 파일 리더가 인스톨 되고 있어도, 파일 데이터로부터 Sequence 오브젝트를 구축중에 에러가 발생하면(자), 역시 실패합니다.

파라미터:

file - Sequence 를 구축하는 File

반환값:

파일이 가리키는 MIDI 파일 데이터에 근거하는 Sequence 오브젝트

예외:

InvalidMidiDataException - 시스템이 인식한 유효한 MIDI 파일 데이터를 파일이 가리키지 않는 경우

IOException - 입출력 예외가 발생했을 경우

getMidiFileTypes

public static int[] getMidiFileTypes()

시스템이 파일 기입 서포트를 제공하는 MIDI 파일 타입세트를 취득합니다.

반환값:

파일 타입의 배열. 서포트되고 있는 파일 타입이 없는 경우, 길이 0 의 배열이 돌려주어진다

isFileTypeSupported

public static boolean isFileTypeSupported(int fileType)

지정된 MIDI 파일 타입의 파일 기입 서포트를 시스템이 제공하고 있을지 어떨지를 나타냅니다.

파라미터:

fileType - 기입 기능이 조회되는 파일 타입

반환값:

파일 타입이 서포트되고 있는 경우는 true, 그렇지 않은 경우는 false

getMidiFileTypes

public static int[] getMidiFileTypes(Sequence  sequence)

지정된 순차 순서로부터 시스템이 기입해 가능한 MIDI 파일 타입세트를 취득합니다.

파라미터:

sequence - MIDI 파일 타입의 서포트가 조회되는 순차 순서

반환값:

서포트되는 파일 타입세트. 서포트되고 있는 파일 타입이 없는 경우, 길이 0 의 배열이 돌려주어진다

isFileTypeSupported

public static boolean isFileTypeSupported(int fileType,
                                          Sequence  sequence)

지정된 파일 타입의 MIDI 파일을, 나타난 순차 순서로부터 기입할 수 있을지 어떨지를 나타냅니다.

파라미터:

fileType - 기입 기능이 조회되는 파일 타입

sequence - 파일 기입 서포트가 조회되는 순차 순서

반환값:

파일 타입이 이 순차 순서에 대해서 서포트되고 있는 경우는 true, 그렇지 않은 경우는 false

write

public static int write(Sequence  in,
                        int fileType,
                        OutputStream  out)
                 throws IOException 

제공되는 외부 스트림에 나타나는 MIDI 파일 타입을 나타내는 바이트의 스트림을 기입합니다.

파라미터:

in - 파일에 기입해지는 MIDI 데이터를 포함한 순차 순서

fileType - 출력 스트림에 기입해지는 파일의 파일 타입

out - 파일 데이터가 기입해지는 스트림

반환값:

출력 스트림에 기입해지는 바이트수

예외:

IOException - 입출력 예외가 발생했을 경우

IllegalArgumentException - 시스템이 그 파일 형식을 서포트하고 있지 않는 경우

관련 항목:

isFileTypeSupported(int, Sequence) , getMidiFileTypes(Sequence)

write

public static int write(Sequence  in,
                        int type,
                        File  out)
                 throws IOException 

제공되는 외부 파일에 나타나는 MIDI 파일 타입을 나타내는 바이트의 스트림을 기입합니다.

파라미터:

in - 파일에 기입해지는 MIDI 데이터를 포함한 순차 순서

out - 파일 데이터가 기입해지는 외부 파일

반환값:

파일에 기입해지는 바이트수

예외:

IOException - 입출력 예외가 발생했을 경우

IllegalArgumentException - 시스템이 그 파일 타입을 서포트하고 있지 않는 경우

관련 항목:

isFileTypeSupported(int, Sequence) , getMidiFileTypes(Sequence)