Interface Player

package javax.microedition.media

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

필드 요약

• 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 의 상태.

메서드 요약

• 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 를 정지합니다.

필드 상세

UNREALIZED

public static final int UNREALIZED

See Also:

• Constant Field Values

REALIZED

public static final int REALIZED

See Also:

• Constant Field Values

PREFETCHED

public static final int PREFETCHED

See Also:

• Constant Field Values

STARTED

public static final int STARTED

See Also:

• Constant Field Values

CLOSED

public static final int CLOSED

See Also:

• Constant Field Values

TIME_UNKNOWN

public static final long TIME_UNKNOWN

See Also:

• Constant Field Values

realize

public void realize()
             throws MediaException

Throws:

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

prefetch

public void prefetch()
              throws MediaException

Throws:

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

start

public void start()
           throws MediaException

Throws:

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

stop

public void stop()
          throws MediaException

Throws:

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

deallocate

public void deallocate()

Throws:

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

close

public void close()

Player 를 종료하고 자원을 해제합니다. 메소드가 반환되면 Player 는 CLOSED 상태가 되어 더 이상 사용할 수 없습니다. CLOSED 이벤트는 등록된 PlayerListener 에 전달됩니다. 종료된 Player 에서 close 를 호출하면 요청은 무시됩니다.

setMediaTime

public long setMediaTime(long now)
                  throws MediaException

Parameters:

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

Returns:

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

Throws:

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

See Also:

• getMediaTime()

getMediaTime

public long getMediaTime()

Returns:

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

Throws:

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

See Also:

• setMediaTime(long)

getState

public int getState()

Returns:

• Player의 현재 상태

getDuration

public long getDuration()

Returns:

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

Throws:

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

getContentType

public String getContentType()

Returns:

• 이 Player가 재생 중인 내용 유형

Throws:

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

setLoopCount

public void setLoopCount(int count)

Parameters:

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

Throws:

• 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)

메서드 상세

realize

public void realize()
             throws MediaException

Throws:

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

prefetch

public void prefetch()
              throws MediaException

Throws:

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

start

public void start()
           throws MediaException

Throws:

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

stop

public void stop()
          throws MediaException

Throws:

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

deallocate

public void deallocate()

Throws:

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

close

public void close()

Player 를 종료하고 자원을 해제합니다. 메소드가 반환되면 Player 는 CLOSED 상태가 되어 더 이상 사용할 수 없습니다. CLOSED 이벤트는 등록된 PlayerListener 에 전달됩니다. 종료된 Player 에서 close 를 호출하면 요청은 무시됩니다.

setMediaTime

public long setMediaTime(long now)
                  throws MediaException

Parameters:

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

Returns:

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

Throws:

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

See Also:

• getMediaTime()

getMediaTime

public long getMediaTime()

Returns:

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

Throws:

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

See Also:

• setMediaTime(long)

getState

public int getState()

Returns:

• Player의 현재 상태

getDuration

public long getDuration()

Returns:

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

Throws:

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

getContentType

public String getContentType()

Returns:

• 이 Player가 재생 중인 내용 유형

Throws:

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

setLoopCount

public void setLoopCount(int count)

Parameters:

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

Throws:

• 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)