mmpp.media.phrase
Class PhraseTrack

java.lang.Object
  |
  +--mmpp.media.phrase.PhraseTrack

public class PhraseTrack

extends java.lang.Object

Field Summary

static int	DEFAULT_PANPOT Panpot의 초기값이다. 64이다.
static int	DEFAULT_VOLUME 볼륨의 초기값이다. 100이다.
static int	ENDING 상태값 재생끝 (4를 사용한다.)
static int	MASTER MASTER임을 나타낸다. (
static int	NO_DATA 상태값 재생 데이타 없음 (1을 사용한다.)
static int	PAUSE 상태값 일시정지 (5를 사용한다.)
static int	PLAY 상태값 재생중 (3를 사용한다.)
static int	READY 상태값 재생 가능 (2을 사용한다.)
static int	SLAVE SLAVE임을 나타낸다. (

Method Summary

int	getIsMaster() 마스터 여부를 얻는다.
PhraseTrack	getMaster() Master Track을 얻는다.
boolean	getMute() 음소거 여부를 얻는다.
int	getNumber() 트랙의 번호를 얻는다.
int	getPanpot() 소리의 균형도를 얻는다.
PhraseData	getPhraseData() PhraseData를 얻는다.
int	getPlayingTime() 연주 시간을 얻는다.
int	getPosition() 현재 연주 위치를 얻는다.(
int	getState() 현재 트랙의 상태를 얻는다.
int	getVolume() 소리의 볼륨을 설정한다.
void	pause() 현재 상태가 PLAY이며 MASTER인 경우에만 일시정지한다.
void	play() 1회 연주한다.
void	play(int loop) 현재 상태가 READY이며 MASTER인 경우에만 재생한다.
void	removePhraseData() PhraseData를 제거한다. slave가 있으면 slave의 데이타도 자동으로 제거된다.
void	resume() 현재 상태가 PAUSE이며 MASTER인 경우에만 일시정지 상태를 해제한다.
void	seek(int pos) 현재 상태가 READY이며 MASTER인 경우에만 시작 위치를 바꾼다.
void	setMaster(PhraseTrack master) 트랙을 master 트랙의 slave로 설정한다.
void	setMute(boolean mute) 음소거 여부를 설정한다.
void	setPanpot(int panpot) 소리의 균형도를 설정한다.
void	setPhraseData(PhraseData data) 트랙에 프레이즈 데이타를 설정한다.
void	setPhraseTrackListener(PhraseTrackListener listener) PhraseTrackListener 를 설정한다. 재생끝, 반복재생끝 발생시 PhraseTrackListener의 eventNotify 메소드를 호출한다.
void	setVolume(int volume) 소리의 볼륨을 설정한다.
void	stop() 현재 상태가 PLAY 또는 PAUSE이며 MASTER인 경우에만 재생을 멈춘다.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PANPOT

public static final int DEFAULT_PANPOT

Panpot의 초기값이다. 64이다.

DEFAULT_VOLUME

public static final int DEFAULT_VOLUME

볼륨의 초기값이다. 100이다.

NO_DATA

public static final int NO_DATA

상태값 재생 데이타 없음 (1을 사용한다.)

READY

public static final int READY

상태값 재생 가능 (2을 사용한다.)

PLAY

public static final int PLAY

상태값 재생중 (3를 사용한다.)

ENDING

public static final int ENDING

상태값 재생끝 (4를 사용한다.)

PAUSE

public static final int PAUSE

상태값 일시정지 (5를 사용한다.)

MASTER

public static final int MASTER

MASTER임을 나타낸다. (0을 사용한다.)

SLAVE

public static final int SLAVE

SLAVE임을 나타낸다. (1을 사용한다.)

Method Detail

setPhraseData

public void setPhraseData(PhraseData data)

트랙에 프레이즈 데이타를 설정한다.

Parameters:

phraseData - Phrase Data

Throws:

java.lang.NullPointerException - 데이타가 null인 경우

java.lang.IllegalArgumentException - 데이타 포멧을 지원하지 않을 경우

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getPhraseData

public PhraseData getPhraseData()

PhraseData를 얻는다.

Returns:

PhraseData

removePhraseData

public void removePhraseData()

PhraseData를 제거한다. slave가 있으면 slave의 데이타도 자동으로 제거된다.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

setMaster

public void setMaster(PhraseTrack master)

트랙을 master 트랙의 slave로 설정한다.
master가 null이면 slave상태를 해제한다. 다른 track에 의해서 Master로 세팅되어 있는 track은 slave가 될 수 없다. (자바에서 막을 필요가??.. 어짜피 native에러)

Parameters:

master - Master 트랙

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getMaster

public PhraseTrack getMaster()

Master Track을 얻는다.

Returns:

PhraseTrack Master 트랙.

setPhraseTrackListener

public void setPhraseTrackListener(PhraseTrackListener listener)

PhraseTrackListener 를 설정한다.
재생끝, 반복재생끝 발생시 PhraseTrackListener의 eventNotify 메소드를 호출한다.

Parameters:

listener - PhraseTrackListener를 implements한 객체

getNumber

public int getNumber()

트랙의 번호를 얻는다.
트랙번호는 PhrasePlayer에서 트랙을 구분하는 유일한 값이다.

getPanpot

public int getPanpot()

소리의 균형도를 얻는다.

Returns:

소리의 균형도 값.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

setPanpot

public void setPanpot(int panpot)

소리의 균형도를 설정한다.
0:좌 64:중앙 127:우

Parameters:

panpot - : 소리의 균형도

Throws:

java.lang.IllegalArgumentException - panpot값이 잘못되었을 경우

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getVolume

public int getVolume()

소리의 볼륨을 설정한다.
0부터 127까지의 값

Parameters:

panpot - : 소리의 균형도

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

setVolume

public void setVolume(int volume)

소리의 볼륨을 설정한다.

Parameters:

volume - : 볼륨값(-1, 0 to 127) -1은 default값을 의미한다.

Throws:

java.lang.IllegalArgumentException - volume값이 잘못되었을 경우

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getMute

public boolean getMute()

음소거 여부를 얻는다.

Returns:

true : 음소거상태(볼륨:0) false : 음소거상태 아님.

setMute

public void setMute(boolean mute)

음소거 여부를 설정한다.

Parameters:

mute - : true 이면 음소거 false이면 DEFAULT_VOLUME 값으로 설정.

getState

public int getState()

현재 트랙의 상태를 얻는다.

Returns:

NO_DATA, READY, PLAY, ENDING, PAUSE 값중 하나이다.

play

public void play(int loop)

현재 상태가 READY이며 MASTER인 경우에만 재생한다. 그 이외의 경우는 무시된다.

Parameters:

loop - : 반복횟수(0부터 255까지 가능하며 0일 경우 무한반복을 나타낸다)

Throws:

IlligamArgumentException - : loop를 잘못 설정한 경우

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

play

public void play()
          throws java.lang.RuntimeException,
                 java.lang.IllegalArgumentException

1회 연주한다.

pause

public void pause()

현재 상태가 PLAY이며 MASTER인 경우에만 일시정지한다. 그 이외의 경우는 무시된다.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

resume

public void resume()

현재 상태가 PAUSE이며 MASTER인 경우에만 일시정지 상태를 해제한다. 그 이외의 경우는 무시된다.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

stop

public void stop()

현재 상태가 PLAY 또는 PAUSE이며 MASTER인 경우에만 재생을 멈춘다. 그 이외의 경우는 무시된다.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getPlayingTime

public int getPlayingTime()

연주 시간을 얻는다. 현재 상태가 NO_DATA가 아닐 경우 연주 시간을 얻는다. (단위 : ms)

Returns:

전체 연주 시간

getPosition

public int getPosition()

현재 연주 위치를 얻는다.(시간 단위); 현재 상태가 READY또는 PAUSE일때 play 위치를 얻는다.
시간 단위(ms)이다.

Returns:

연주 위치

seek

public void seek(int pos)

현재 상태가 READY이며 MASTER인 경우에만 시작 위치를 바꾼다. 그 이외의 경우는 무시된다.

Throws:

java.lang.RuntimeException - Native 에서 에러가 발생할 경우

getIsMaster

public int getIsMaster()

마스터 여부를 얻는다.

Returns:

0 : master, 1 : slave