org.kwis.msp.media
Class Player

java.lang.Object
  |
  +--org.kwis.msp.media.Player

public class Player

extends Object

이 클래스는 매디어를 재생하기 위한 static 메쏘드를 포함하는 클래스입니다.

Method Summary

static boolean	pause(Clip clip) 매체 처리(재생/녹음)를 일시적으로 멈춘다.
static boolean	play(Clip clip, boolean repeat) 클립의 데이타를 재생한다.
static boolean	record(Clip clip) 녹음을 시작한다.
static boolean	resume(Clip clip) 일시 정지한 매체처리(재생/녹음)를 재개한다.
static boolean	stop(Clip clip) 매체처리(재생/녹음)를 종료한다.

Methods inherited from class java.lang.Object

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

Method Detail

pause

public static boolean pause(Clip clip)

매체 처리(재생/녹음)를 일시적으로 멈춘다. 이 함수가 불려 매체처리가 일시 정지하게 되면 클립에 등록한 이벤트 listener함수에 PAUSE 상태가 전달된다. 일시로 멈추어 있거나, 정지되어 있는 처리기에 대해서 이 함수를 다시 부르면, 이 함수는 아무런 역할을 하지 않는다 pause를 지원하지 않는 타입으로 생성된 클립으로 pause을 시도할 경우, MediaUnsupportedException이 발생한다.

Parameters:

clip - 일시 중지시킬 클립

Returns:

ture : 성공
false : 이미 멈추어 있거나, 정지되어 있음

resume

public static boolean resume(Clip clip)

일시 정지한 매체처리(재생/녹음)를 재개한다. 이 함수가 불려 매체처리를 재개하면 클립에 등록한 이벤트 listener함수에 RESUME상태가 전달된다. 매채처리중인 처리기에 대해서 이 함수를 다시 부르면 이 함수는 아무런 역활을 하지 않는다. resume를 지원하지 않는 타입으로 생성된 클립으로 resume을 시도할 경우, MediaUnsupportedException이 발생한다.

Parameters:

clip - 재개시킬 클립

Returns:

ture : 성공
false : 이미 매체처리중

stop

public static boolean stop(Clip clip)

매체처리(재생/녹음)를 종료한다. 이 함수가 불려 매체처리를 종료하면 클립에 등록한 이벤트 listener함수에 STOP상태가 전달된다. 정지되어 있는 처리기에 대해서 이 함수를 다시 부르면, 이 함수는 아무런 역활을 하지 않는다. 녹음/재생중인 clip에 대하여 이 함수를 부를 녹음/재생의 정지자체는 항상 성공한다.(false가 반환되는 경우는 녹음된 데이타의 저장등이 잘못된 경우이다.)

Parameters:

clip - 종료시킬 클립

Returns:

ture : 성공
false : 전달된 clip이 재생/녹화중이 아니거나, 비 정상적으로 정지 되었음

play

public static boolean play(Clip clip,
                           boolean repeat)

클립의 데이타를 재생한다. 이 함수가 불려 매체처리를 시작하면 클립에 등록된 이벤트 listener함수에 START상태가 전달된다. 이미 재생되고 있는 클립이 있어 전달된 클립을 재생할 수 없다면 UnavailableException이 발생한다. 재생중인 클립으로 다시 재생할려고 하면 이 함수는 아무런 역할도 하지 않는다. 클립데이타가 소진되면 이벤트 listener함수에 END_OF_DATA상태가 전달된다. 스트리밍 재생을 하고 싶은 경우에는 클립 데이타가 완전 소진되기 전에, 주기적으로 Clip.putData()로 클립 데이타를 채워주어야 한다.

Parameters:

clip - 재생할 클립

repeat - false이면 1회재생, true는 반복 재생

Returns:

ture : 성공
false : 재생실패

record

public static boolean record(Clip clip)

녹음을 시작한다. 녹음을 지원하지 않는 타입으로 생성된 클립으로 녹음을 시도할 경우, MediaUnsupportedException이 발생한다. 이 함수가 불려 매체처리를 시작하면 클립생성시 등록된 이벤트 listener함수에 RECORD상태가 전달된다. 이미 녹음중인 클립이 있어, 녹음을 할 수 없다면 UnavailableException이 발생한다. 녹음중인 클립으로 다시 녹음할려고 하면 이 함수는 아무런 역할도 하지 않는다. 녹음 중, 클립 내부버퍼가 완전히 차면 이벤트 listener함수에 FULL_OF_DATA상태가 전달된다. 스트리밍 녹음을 하고 싶은 경우에는 클립 내부버퍼가 완전히 차기전에, 주기적으로 Clip.GetData()로 클립 내부버퍼를 비워주어야 한다

Parameters:

clip - 녹음데이타를 저장할 클립

Returns:

ture : 성공
false : 이미 녹음중