javax.microedition.media
Interface Player

All Superinterfaces:

Controllable

public interface Player

extends Controllable

Player는 시간 기반 미디어 데이터의 렌더링을 제어합니다. 또한 Player의 수명 주기를 관리하고 재생 과정을 제어하고 표시 구성 요소를 얻기 위한 메소드를 제공합니다.

단순 재생

Player는 Manager 중 하나의 createPlayer 메소드에서 만들 수 있습니다. Player를 만든 후 start를 호출하면 가능한 빨리 재생을 시작합니다. 이 메소드는 재생이 시작되면 반환됩니다. 재생은 백그라운드에서 계속되며 미디어 끝에 도달하면 자동 정지합니다.

단순 재생 예를 참조하십시오.

Player 수명 주기

Player에는 UNREALIZED, REALIZED, PREFETCHED, STARTED, CLOSED 등 다섯 가지 상태가 있습니다.

이러한 수명 주기 상태의 목적은 시간을 많이 소비할 가능성이 있는 작업을 프로그램적으로 제어하기 위한 것입니다. 예를 들어, Player가 처음 구성되면 UNREALIZED 상태에 있습니다. UNREALIZED에서 REALIZED로 전환되면 Player는 작동하는 데 필요한 모든 자원을 찾기 위해 필요한 통신을 수행합니다(예: 서버나 파일 시스템과 통신). realize 메소드를 사용하면 응용 프로그램은 이처럼 시간을 많이 소비할 가능성이 있는 작업을 적절한 시간에 시작할 수 있습니다.

일반적으로 Player는 UNREALIZED 상태에서 REALIZED 상태로 이동한 다음 PREFETCHED 상태로 이동하고 마지막으로 STARTED 상태가 됩니다.

Player는 미디어 끝에 도달하거나 stop 메소드가 호출된 경우에 정지합니다. 이런 경우 Player는 STARTED 상태에서 PREFETCHED 상태로 돌아갑니다. 그러면 다시 주기를 반복할 준비가 됩니다.

Player를 사용하려면 이러한 수명 주기 상태 간의 이동을 관리하고 Player의 상태 전환 메소드를 사용해 상태를 이동하기 위한 매개 변수를 설정해야 합니다.

Player 상태

이 절에서는 각 Player의 상태 의미를 설명합니다.

UNREALIZED 상태

Player는 UNREALIZED 상태에서 시작합니다. 인식되지 않은 Player는 작동하는 데 필요한 모든 자원을 획득하기 위한 충분한 정보가 없습니다.

다음 메소드는 Player가 UNREALIZED 상태에 있는 경우에는 사용해서는 안 됩니다.

• getContentType
• setMediaTime
• getControls
• getControl

IllegalStateException이 발생합니다.

realize 메소드는 Player를 UNREALIZED 상태에서 REALIZED 상태로 전환합니다.

REALIZED 상태

Player는 미디어 자원을 획득하는 데 필요한 정보를 얻은 경우에는 REALIZED 상태에 있습니다. Player를 인식하는 과정은 자원과 시간이 많이 소비되는 과정일 수 있습니다. Player는 서버와 통신하고 파일을 읽거나 객체 집합과 상호 작용해야 합니다.

인식된 Player는 더 이상 자원을 획득할 필요가 없으나 오디오 장치와 같은 희귀한 시스템 자원의 독점 사용을 의미하는 자원을 제외한 모든 자원을 획득했을 수 있습니다.

일반적으로 Player는 UNREALIZED 상태에서 REALIZED 상태로 이동합니다. Player에서 realize를 호출한 후에 UNREALIZED 상태로 되돌리는 유일한 방법은 realize가 완료되기 전에 deallocate를 호출하는 것입니다. Player가 일단 REALIZED 상태에 도달하면 UNREALIZED 상태로 되돌릴 수 없으며 네 가지 상태 즉, REALIZED, PREFETCHED, STARTED 또는 CLOSED 상태 중 하나에 있게 됩니다.

PREFETCHED 상태

Player는 일단 인식된 후에도 시작할 준비가 되기 전에 시간을 소비하는 작업을 수없이 수행해야 합니다. 예를 들어, 희귀 자원이나 독점 자원을 획득하고 미디어 데이터로 버퍼를 채우거나 다른 시작 프로세스를 수행해야 할 수 있습니다. Player에서 prefetch를 호출하면 이러한 작업을 수행합니다.

Player가 PREFETCHED 상태에 있게 되면 시작할 수 있습니다. 프리패치는 Player의 시작 대기 시간을 가능한 최소값으로 줄여 줍니다.

시작된 Player가 정지하면 PREFETCHED 상태로 되돌아갑니다.

STARTED 상태

일단 프리패치되면 Player는 start 메소드를 호출하여 STARTED 상태에 들어갈 수 있습니다. STARTED 상태의 Player는 Player가 실행 중이며 데이터를 처리하는 중임을 의미합니다. Player는 stop 메소드가 호출되었거나 미디어 끝에 도달하여 정지되면 PREFETCHED 상태로 되돌아갑니다.

Player는 PREFETCHED에서 STARTED 상태로 이동할 때 STARTED 이벤트를 게시합니다. STARTED 상태에서 PREFETCHED 상태로 이동할 때에는 정지된 이유에 따라 STOPPED 또는 END_OF_MEDIA 이벤트를 게시합니다.

다음 메소드는 Player가 STARTED 상태에 있을 때에는 사용해서는 안 됩니다.

• setLoopCount

IllegalStateException이 발생합니다.

CLOSED 상태

Player에서 close를 호출하면 CLOSED 상태가 됩니다. CLOSED 상태의 Player는 대부분의 자원을 해제했으므로 이를 다시 사용하면 안 됩니다.

Player의 다섯 가지 상태와 상태 전환 메소드가 다음 다이어그램에 요약되어 있습니다

Player 이벤트

Player 이벤트는 Player의 상태 변경에 대한 정보와 Player의 Control에서 제공하는 다른 관련 정보를 비동기적으로 전달합니다.

이벤트를 수신하려면 객체는 PlayerListener 인터페이스를 구현하고 addPlayerListener 메소드를 사용하여 Player의 이벤트에 관심이 있음을 나타내야 합니다. 모든 Player 이벤트는 등록된 각 수신기에 게시됩니다.

이벤트를 나타내는 동작이 발생하도록 이벤트를 전달해야 합니다. 예를 들어, Player가 매우 짧은 미디어 파일을 재생하여 시작 직후에 정지하면 STARTED 이벤트가 항상 END_OF_MEDIA 이벤트보다 먼저 발생해야 합니다.

ERROR 이벤트는 복구 불가능한 오류가 발생하면 언제든지 전송할 수 있습니다. 이런 경우 Player는 CLOSED 상태가 됩니다.

Player 이벤트 기법은 확장 가능하며 일부 Player는 여기에 설명되지 않은 이벤트를 정의하기도 합니다. 미리 정의된 플레이어 이벤트 목록은 PlayerListener 인터페이스를 확인하십시오.

Player가 사용하는 자원 관리

prefetch 메소드는 오디오 장치와 같은 희귀 자원이나 독점 자원을 획득하는 데 사용됩니다. 반대로 deallocate 메소드는 희귀 자원이나 독점 자원을 해제하는 데 사용됩니다. 응용 프로그램은 이러한 두 개의 메소드를 사용하여 Player의 자원을 프로그램적으로 관리할 수 있습니다.

예를 들어, 독점적 오디오 장치의 구현에서 여러 Player의 오디오를 교대로 재생하기 위해 응용 프로그램은 개별 Player를 선택적으로 할당 취소하고 프리패치할 수 있습니다.

Player의 컨트롤

Player는 일부 유형별로 다른 Control 인터페이스를 통해 추가 제어를 제공하는 Controllable을 구현합니다. getControl 및 getControls는 Player가 UNREALIZED 또는 CLOSED 상태에 있을 때에는 호출할 수 없습니다. IllegalStateException이 발생합니다.

단순 재생 예

 try {
     Player p = Manager.createPlayer(Manager.TONE_DEVICE_LOCATOR);
     p.start();
 } catch (MediaException me) {}
 } catch (IOException ioe) {
 }

Field Summary

static int	CLOSED Player가 종료되었음을 나타내는 Player의 상태.
static int	PREFETCHED 재생하는 데 필요한 모든 자원을 획득했음을 나타내는 Player의 상태.
static int	REALIZED 작동하는 데 필요한 정보를 획득했지만 자원은 획득하지 않았음을 나타내는 Player의 상태.
static int	STARTED Player가 이미 시작되었음을 나타내는 Player의 상태.
static long	TIME_UNKNOWN 요청된 시간을 알 수 없음을 나타내는 반환 값.
static int	UNREALIZED 작동하는 데 필요한 정보와 자원을 획득하지 않았음을 나타내는 Player의 상태.

Method Summary

void	addPlayerListener(PlayerListener playerListener) 이 플레이어에 플레이어 수신기를 추가합니다.
void	close() Player를 종료하고 자원을 해제합니다.
void	deallocate() Player에서 획득한 오디오 장치와 같은 희귀 자원이나 독점 자원을 해제합니다.
String	getContentType() 이 Player로 재생 중인 미디어의 내용 유형을 가져옵니다.
long	getDuration() 미디어의 재생 시간을 가져옵니다.
long	getMediaTime() 이 Player의 현재 미디어 시간을 가져옵니다.
int	getState() 이 Player의 현재 상태를 가져옵니다.
void	prefetch() 희귀 자원이나 독점 자원을 획득하고 시작 대기 시간을 줄이는 데 필요한 만큼의 데이터를 처리합니다.
void	realize() 희귀 자원이나 독점 자원을 획득하지 않고 Player의 일부를 구성합니다.
void	removePlayerListener(PlayerListener playerListener) 이 플레이어의 플레이어 수신기를 제거합니다.
void	setLoopCount(int count) Player가 내용을 루프 및 재생할 횟수를 설정합니다.
long	setMediaTime(long now) Player의 미디어 시간을 설정합니다.
void	start() 가능한 빨리 Player를 시작합니다.
void	stop() Player를 정지합니다.

Methods inherited from interface javax.microedition.media.Controllable

getControl, getControls

Field Detail

UNREALIZED

public static final int UNREALIZED

작동하는 데 필요한 정보와 자원을 획득하지 않았음을 나타내는 Player의 상태.

UNREALIZED에 100 값이 지정됩니다.

See Also:

Constant Field Values

REALIZED

public static final int REALIZED

작동하는 데 필요한 정보를 획득했지만 자원은 획득하지 않았음을 나타내는 Player의 상태.

REALIZED에 200 값이 지정됩니다.

See Also:

Constant Field Values

PREFETCHED

public static final int PREFETCHED

재생하는 데 필요한 모든 자원을 획득했음을 나타내는 Player의 상태.

PREFETCHED에 300 값이 지정됩니다.

See Also:

Constant Field Values

STARTED

public static final int STARTED

Player가 이미 시작되었음을 나타내는 Player의 상태.

STARTED에 400 값이 지정됩니다.

See Also:

Constant Field Values

CLOSED

public static final int CLOSED

Player가 종료되었음을 나타내는 Player의 상태.

CLOSED에 0 값이 지정됩니다.

See Also:

Constant Field Values

TIME_UNKNOWN

public static final long TIME_UNKNOWN

요청된 시간을 알 수 없음을 나타내는 반환 값.

TIME_UNKNOWN에 -1 값이 지정됩니다.

See Also:

Constant Field Values

Method Detail

realize

public void realize()
             throws MediaException

희귀 자원이나 독점 자원을 획득하지 않고 Player의 일부를 구성합니다. 여기에는 미디어 데이터 검사가 포함되며 완료하는 데 시간이 소요될 수 있습니다.

realize가 완료되면 Player는 REALIZED 상태가 됩니다.

Player가 REALIZED, PREFETCHTED 또는 STARTED 상태에 있을 때 realize를 호출하면 요청은 무시됩니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

MediaException - Player를 인식할 수 없을 때 발생합니다.

SecurityException - 호출자에게 Player를 인식하기 위한 보안 권한이 없는 경우 발생합니다.

prefetch

public void prefetch()
              throws MediaException

희귀 자원이나 독점 자원을 획득하고 시작 대기 시간을 줄이는 데 필요한 만큼의 데이터를 처리합니다.

prefetch를 완료하면 Player는 PREFETCHED 상태가 됩니다.

Player가 UNREALIZED 상태에 있을 때 prefetch를 호출하면 암시적으로 realize를 호출합니다.

Player가 이미 PREFETCHED 상태에 있을 때 prefetch를 호출하는 경우에도 Player는 시작 대기 시간을 줄이는 데 필요한 데이터를 처리할 수 있습니다. 이러한 특성을 통해 시작 대기 시간을 최소로 유지할 수 있습니다.

Player가 STARTED 상태에 있을 때 prefetch를 호출하면 요청은 무시됩니다.

Player가 필요한 모든 자원을 얻을 수 없는 경우 MediaException이 발생합니다. 이런 경우 Player를 시작할 수 없습니다. 그러나 나중에 다른 Player나 응용 프로그램이 필요한 자원을 해제하면 prefetch를 다시 호출할 수 있습니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

MediaException - Player를 프리패치할 수 없는 경우 발생합니다.

SecurityException - 호출자에게 Player를 프리패치할 보안 권한이 없는 경우 발생합니다.

start

public void start()
           throws MediaException

가능한 빨리 Player를 시작합니다. stop을 호출하여 Player가 이미 정지된 경우 이전에 정지한 위치에서 재생을 다시 시작합니다. Player가 미디어 끝에 도달한 경우 start를 호출하면 미디어의 시작부터 자동으로 재생을 시작합니다.

start가 반환될 때 Player는 시작되어 있어야 하고 STARTED 이벤트는 등록된 PlayerListener로 전달됩니다. 그러나 Player가 반드시 STARTED 상태에 있지는 않습니다. Player는 미디어의 재생 시간이 0이거나 매우 짧은 경우 이미 정지되었을 수 있습니다(PREFETCHED 상태).

Player가 UNREALIZED 또는 REALIZED 상태에 있을 때 start를 호출하면 암시적으로 prefetch를 호출합니다.

Player가 STARTED 상태에 있을 때 start를 호출하면 요청은 무시됩니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

MediaException - Player를 시작할 수 없는 경우 발생합니다.

SecurityException - 호출자에게 Player를 시작할 보안 권한이 없는 경우 발생합니다.

stop

public void stop()
          throws MediaException

Player를 정지합니다. 현재 미디어 시간에서 재생을 일시 정지합니다.

stop이 반환될 때 Player는 PREFETCHED 상태가 됩니다. STOPPED 이벤트는 등록된 PlayerListener에 전달됩니다.

정지된 Player에서 stop을 호출하면 요청은 무시됩니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

MediaException - Player를 정지할 수 없는 경우 발생합니다.

deallocate

public void deallocate()

Player에서 획득한 오디오 장치와 같은 희귀 자원이나 독점 자원을 해제합니다.

deallocate가 반환되면 Player는 UNREALIZED 또는 REALIZED 상태가 됩니다.

Player가 인식하는 동안 realize 호출에서 블록된 경우 deallocate를 호출하면 realize 호출을 블록 해제하고 Player를 UNREALIZED 상태로 되돌립니다. 그렇지 않은 경우 deallocate를 호출하면 Player를 REALIZED 상태로 되돌립니다.

Player가 UNREALIZED 또는 REALIZED 상태에 있을 때 deallocate를 호출하면 요청은 무시됩니다.

deallocate를 호출할 때 Player가 STARTED의 상태에 있으면 deallocate는 Player에서 암시적으로 stop을 호출합니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

close

public void close()

Player를 종료하고 자원을 해제합니다.

메소드가 반환되면 Player는 CLOSED 상태가 되어 더 이상 사용할 수 없습니다. CLOSED 이벤트는 등록된 PlayerListener에 전달됩니다.

종료된 Player에서 close를 호출하면 요청은 무시됩니다.

setMediaTime

public long setMediaTime(long now)
                  throws MediaException

Player의 미디어 시간을 설정합니다.

일부 미디어 유형의 경우 미디어 시간이 그다지 정확하지 않을 수 있습니다. 반환된 값은 설정된 실제 미디어 시간을 나타냅니다.

미디어 시간을 음수 값으로 설정하면 실제적으로는 미디어 시간이 0으로 설정됩니다. 미디어 시간을 미디어 재생 시간 범위를 초과하여 설정하면 시간은 미디어의 끝까지 설정됩니다.

미디어 시간 설정을 지원할 수 없는 미디어 유형도 있을 수 있습니다. 이런 경우에 setMediaTime을 호출하면 MediaException이 발생합니다.

Parameters:

now - 밀리초 단위로 된 새 미디어 시간

Returns:

밀리초 단위로 설정된 실제 미디어 시간

Throws:

IllegalStateException - Player가 UNREALIZED 또는 CLOSED 상태인 경우 발생합니다.

MediaException - 미디어 시간을 설정할 수 없는 경우 발생합니다.

See Also:

getMediaTime()

getMediaTime

public long getMediaTime()

이 Player의 현재 미디어 시간을 가져옵니다. 미디어 시간을 결정할 수 없는 경우 getMediaTime은 TIME_UNKNOWN을 반환합니다.

Returns:

밀리초로 된 현재 미디어 시간 또는 TIME_UNKNOWN

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

See Also:

setMediaTime(long)

getState

public int getState()

이 Player의 현재 상태를 가져옵니다. 가능한 상태는 UNREALIZED, REALIZED, PREFETCHED, STARTED 또는 CLOSED입니다.

Returns:

Player의 현재 상태

getDuration

public long getDuration()

미디어의 재생 시간을 가져옵니다. 반환된 값은 미디어를 기본 속도로 재생할 때의 재생 시간입니다.
Player가 라이브 미디어를 재생하는 경우처럼 재생 시간을 결정할 수 없는 경우 getDuration은 TIME_UNKNOWN을 반환합니다.

Returns:

밀리초 단위로 된 재생 시간이나 TIME_UNKNOWN

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

getContentType

public String getContentType()

이 Player로 재생 중인 미디어의 내용 유형을 가져옵니다.

반환된 내용 유형의 구문은 내용 유형을 참조하십시오.

Returns:

이 Player가 재생 중인 내용 유형

Throws:

IllegalStateException - Player가 UNREALIZED 또는 CLOSED 상태인 경우 발생합니다.

setLoopCount

public void setLoopCount(int count)

Player가 내용을 루프 및 재생할 횟수를 설정합니다.

기본적으로 루프 수는 1입니다. 즉, 일단 시작되면 Player는 현재 미디어 시간부터 미디어의 끝까지 한 번 재생을 시작합니다.

루프 수가 N으로 설정되고, 여기서 N이 1보다 큰 경우 Player를 시작하면 현재 미디어 시간부터 미디어 끝까지 내용 재생을 시작합니다. 그런 다음 내용의 시작(미디어 시간 0) 부분으로 다시 돌아와 미디어의 끝까지 재생합니다. 처음으로 돌아와 미디어의 끝까지 재생할 횟수는 N-1입니다.

루프 수를 0으로 설정하는 것은 유효하지 않습니다. IllegalArgumentException이 발생합니다.

루프 수를 -1로 설정하면 내용을 무기한으로 루프 및 재생합니다.

미리 설정된 루프 수에 도달하기 전에 stop이 호출되어 Player가 정지된 경우 start를 다시 호출하면 정지된 위치에서 미리 설정된 루프 수에 도달할 때까지 재생을 다시 시작합니다.

Player가 미디어 끝에 도달할 때마다 END_OF_MEDIA 이벤트가 게시됩니다. Player가 루프 수에 도달하지 않았기 때문에 처음으로 돌아가 다시 재생을 시작하면 STARTED 이벤트가 게시됩니다.

Parameters:

count - 내용을 재생할 횟수를 나타냅니다. 1이 기본값입니다. 0은 유효하지 않습니다. -1은 무기한으로 루프함을 나타냅니다.

Throws:

IllegalArgumentException - 주어진 수가 유효하지 않은 경우 발생합니다.

IllegalStateException - Player가 STARTED 또는 CLOSED 상태인 경우 발생합니다.

addPlayerListener

public void addPlayerListener(PlayerListener playerListener)

이 플레이어에 플레이어 수신기를 추가합니다.

Parameters:

playerListener - 추가할 수신기. null이 사용되면 요청은 무시됩니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

See Also:

removePlayerListener(javax.microedition.media.PlayerListener)

removePlayerListener

public void removePlayerListener(PlayerListener playerListener)

이 플레이어의 플레이어 수신기를 제거합니다.

Parameters:

playerListener - 제거할 수신기. null이 사용되거나 주어진 playerListener가 이 Player의 수신기가 아닌 경우 요청은 무시됩니다.

Throws:

IllegalStateException - Player가 CLOSED 상태인 경우 발생합니다.

See Also:

addPlayerListener(javax.microedition.media.PlayerListener)