Package javax.microedition.media

MIDP 2.0 Media API는 Mobile Media API (JSR-135) 사양의 직접 호환 가능한 빌딩 블록입니다.

See:
Description

Interface Summary

Control	Control 객체는 일부 미디어 처리 기능을 제어하는 데 사용합니다.
Controllable	Controllable은 Player와 같은 객체에서 Control을 가져오기 위한 인터페이스를 제공합니다.
Player	Player는 시간 기반 미디어 데이터의 렌더링을 제어합니다.
PlayerListener	PlayerListener는 Player가 생성한 비동기적 이벤트를 수신하기 위한 인터페이스입니다.

Class Summary

Manager

Manager는 멀티미디어를 처리하는 Player와 같은 시스템 종속 자원을 얻기 위한 액세스 포인트입니다.

Exception Summary

MediaException

MediaException은 메소드에 예기치 않은 오류 조건이 있음을 나타냅니다.

Package javax.microedition.media Description

MIDP 2.0 Media API는 Mobile Media API (JSR-135) 사양의 직접 호환 가능한 빌딩 블록입니다. 이 빌딩 블록은 전체 Multimedia API와의 상위 버전 호환성을 유지하면서 해당 사양에 사운드 지원을 포함하려는 J2ME^TM 프로필용으로 사용됩니다. 이러한 사양의 예로는 MIDP 2.0 (JSR-118)이 있습니다. 상호 운영되는 이러한 두 API의 개발로 인해 동일한 API 원리를 사용하는 J2ME^TM 장치 제품군에서 완벽한 사운드와 멀티미디어 내용 작성이 가능합니다.

소개

J2ME^TM 장치는 단순 톤 재생 기능을 가진 휴대폰에서 고급 오디오 및 비디오 렌더링 기능이 있는 PDA 및 웹 태블릿에 이르기까지 다양합니다. 다양한 구성과 멀티미디어 처리 기능을 수용하려면 추상화 수준이 높은 API가 필요합니다. MMAPI Expert Group의 활동 목표는 광범위한 응용 프로그램 영역을 다루는 것이며 그 활동 결과로 만들어진 두 개의 API 집합을 제안합니다.

• Mobile Media API (JSR 135)
• MIDP 2.0 Media API

첫 번째 API는 강력한 모바일 폰, PDA 및 셋톱 박스를 포함하여 고급 사운드 및 멀티미디어 기능이 있는 J2ME^TM 장치를 위한 것입니다. 두 번째 API는 직접 호환되는 Multimedia API의 하위 집합으로 범용 시장 모바일 장치(MIDP 2.0 실행)와 같이 자원이 제약된 장치를 위한 것입니다. 또한 이 하위 집합 API는 사운드 지원을 필요로 하는 다른 J2ME^TM 프로필에 적용될 수 있습니다. 다음은 빌딩 블록 API의 배경 정보와 요구 사항에 대한 보다 자세한 설명입니다.

Media API의 배경 정보

일부 J2ME^TM 장치는 자원이 매우 제약되어 있으므로 일부 휴대폰의 비디오와 같은 모든 멀티미디어 유형을 지원하지 못할 수도 있습니다. 따라서 모든 장치가 사용자 정의 프로토콜과 내용 유형을 지원하는 확장 가능성과 같은 멀티미디어 API의 모든 내용을 지원할 필요는 없습니다.

제시된 빌딩 블록 하위 집합 API는 위의 제약 조건에 부합하도록 설계되었습니다. 이 제시된 빌딩 블록은 MIDP 2.0 Expert Group의 요구 사항을 충족합니다. 이러한 요구 사항은 다음과 같습니다.

• 낮은 풋프린트 오디오 재생
• 알 수 없는 프로토콜 및 내용 형식
• 톤 재생 지원
• 일반 미디어 흐름 제어 지원: 시작, 정지 등
• 미디어별 유형 제어 지원: 볼륨 등
• 기능 쿼리 지원

이 하위 집합은 다음과 같은 면에서 전체 Mobile Media API와 다릅니다.

• 오디오 전용입니다. 또한 비디오나 그래픽 관련 제어를 모두 제외합니다.
• 사용자 정의 DataSources를 통한 사용자 정의 프로토콜을 지원하지 않습니다. javax.microedition.media.protocol 패키지(DataSource)가 제외됩니다.

MIDP 2.0에 사용된 빌딩 블록 하위 집합은 전체 Mobile Media API에 적합한 하위 집합으로 향후 버전과 완전 호환됩니다. 전체 Mobile Media API 기능을 MIDP 2.0에서 사용하려면 해당 API에서 추가 클래스와 메소드를 구현하기만 하면 됩니다.

기본 개념

제시된 오디오 빌딩 블록 시스템은 다음 세 가지 주요 부분으로 구성되어 있습니다.

Manager

Player

Control

Manager는 오디오 자원의 최상위 컨트롤입니다. 응용 프로그램은 Manager를 사용하여 Player를 요청하고 등록 정보, 지원되는 내용 유형 및 지원되는 프로토콜을 쿼리합니다. 관리자는 또한 단순 톤을 재생하는 메소드를 포함하고 있습니다.

Player는 멀티미디어 내용을 재생합니다. 응용 프로그램은 Manager에 로케이터 문자열을 제공하여 Player를 얻습니다.

Control은 Player가 가질 수 있는 서로 다른 제어를 모두 구현하는 데 사용되는 인터페이스입니다. 응용 프로그램은 지원하는 제어의 Player를 쿼리한 다음 VolumeControl과 같은 볼륨을 제어할 특정 Control을 요청할 수 있습니다.

API 세부 정보

createPlayer 메소드는 API의 최상위 시작점입니다.

Player Manager.createPlayer(String url)

url은 데이터의 프로토콜과 내용을 모두 지정합니다.

<protocol>:<content location>

Manager는 URL을 구문 분석하고 내용 유형을 인식하고 데이터 표시를 처리할 Player를 만듭니다. 결과 Player는 응용 프로그램에서 사용할 수 있도록 반환됩니다. createPlayer로 만든 연결은 Generic Connection 프레임워크 규칙과 정책을 따릅니다.

Player는 데이터 흐름과 표시를 제어할 일반적인 메소드를 제공합니다. 예를 들면 다음과 같습니다.

Player.realize() 
Player.prefetch() 
Player.start()

미세한 제어 기능은 API의 중요한 특징 중 하나로 각 Player는 getControls 및 getControl 메소드를 사용하여 유형별로 다른 제어를 제공합니다.

Control[] Player.getControls()
Control Player.getControl(int controlType)

여러 유형의 미디어는 각 해당 Player에서 서로 다른 유형의 제어를 제공하기 때문에 getControls 및 getControl 메소드는 특정 미디어 유형에 고유한 기능을 제공할 수 있습니다.

톤 생성

톤 생성은 게임과 기타 오디오 응용 프로그램에서 매우 중요합니다. 극소형 장치에서는 톤 생성이 유일한 멀티미디어 기능 지원 형식일 수 있으므로 특히 중요합니다. 가장 단순한 형식에서는 톤 생성은 단일 버저나 일부 단순한 모노 톤 생성으로 축소됩니다. Manager 클래스는 이 단일 톤 생성의 단순 형식을 처리할 최상위 메소드를 제공합니다.

Manager.playTone(int note, int duration, int volume)

이 메소드의 구현은 장치의 하드웨어 톤 생성기로 직접 매핑되어 가장 응답이 빠른 사운드 생성을 제공합니다.

또한 API는 톤 시퀀스를 합성하는 특정 유형의 Player를 만드는 방법을 제공합니다.

Player p = Manager.createPlayer(Manager.TONE_DEVICE_LOCATOR)

작성된 Player는 톤 시퀀스 프로그래밍에 사용할 수 있는 특별 유형의 제어인 ToneControl을 제공합니다. 그러면 좀더 강력한 장치에 대해 보다 정교한 응용 프로그램을 작성할 수 있습니다.

사용 시나리오

이 절에서는 네 개의 일반적인 시나리오에서 API가 사용되는 방법을 보여 줍니다.

시나리오 1: 단일 톤 생성

try {
    Manager.playTone(ToneControl.C4, 5000 /* ms */, 100 /* max vol */);
} catch (MediaException e) {}

시나리오 2: 루프를 사용한 단순 미디어 재생

MIDP 2.0에서 wav 형식은 장치가 샘플 오디오를 지원하는 경우에만 필요합니다.

try {
    Player p = Manager.createPlayer("http://webserver/music.wav");
    p.setLoopCount(5);
    p.start();
} catch (IOException ioe) {
} catch (MediaException me) {}

시나리오 3: JAR에 저장된 미디어에서 재생

MIDP 2.0에서 wav 형식은 장치가 샘플 오디오를 지원하는 경우에만 필요합니다.

try {
    InputStream is = getClass().getResourceAsStream("music.wav");
    Player p = Manager.createPlayer(is, "audio/X-wav");
    p.start();
} catch (IOException ioe) {
} catch (MediaException me) {}

시나리오 4: 톤 시퀀스 생성

/**
 * "Mary Had A Little Lamb" has "ABAC" structure.
 * Use block to repeat "A" section.
 */
byte tempo = 30; // set tempo to 120 bpm
byte d = 8;      // eighth-note

byte C4 = ToneControl.C4;;
byte D4 = (byte)(C4 + 2); // a whole step
byte E4 = (byte)(C4 + 4); // a major third
byte G4 = (byte)(C4 + 7); // a fifth
byte rest = ToneControl.SILENCE; // rest

byte[] mySequence = {
    ToneControl.VERSION, 1,   // version 1
    ToneControl.TEMPO, tempo, // set tempo
    ToneControl.BLOCK_START, 0,   // start define "A" section
    E4,d, D4,d, C4,d, E4,d,       // content of "A" section
    E4,d, E4,d, E4,d, rest,d,
    ToneControl.BLOCK_END, 0,     // end define "A" section
    ToneControl.PLAY_BLOCK, 0,    // play "A" section
    D4,d, D4,d, D4,d, rest,d,     // play "B" section
    E4,d, G4,d, G4,d, rest,d,
    ToneControl.PLAY_BLOCK, 0,    // repeat "A" section
    D4,d, D4,d, E4,d, D4,d, C4,d  // play "C" section
};

try {
    Player p = Manager.createPlayer(Manager.TONE_DEVICE_LOCATOR);
    p.realize();
    ToneControl c = (ToneControl)p.getControl("ToneControl");
    c.setSequence(mySequence);
    p.start();
} catch (IOException ioe) {
} catch (MediaException me) {}

Since:

MIDP 2.0