com.kddi.media
インタフェース MediaPlayerInterface　＜Phase1/一部Phase2＞

既知の実装クラスの一覧:

MediaPlayerBox, MediaPlayer

public interface MediaPlayerInterface

メディアプレイヤーのためのインタフェースです。

メソッドの概要

void	addMediaEventListener(MediaEventListener l) メディアの状態変化を通知するlistenerを登録します。
int	getAttribute(int attr) メディアの属性の値を返します。
int	getPitch() 現在の再生ピッチ（キー）を返します。
MediaResource	getResource() 対応付けられているメディアリソースを返します。
int	getTempo() 現在の再生速度を返します。
int	getVolume() 現在の再生音量を返します。
void	hide() 推奨されていません。 Display.setCurrent() を使用してください。
void	pause() メディア再生を一時停止します。
void	play() メディアを再生します。
void	play(int count) 繰り返しメディアを再生します。
void	removeMediaEventListener(MediaEventListener l) メディアの状態変化を通知するlistenerを削除します。
void	resume() メディア再生を再開します。
void	setAttribute(int attr, int value) メディアの属性の値を設定します。
void	setPitch(int pitch) 再生ピッチ（キー）を設定します。
void	setResource(MediaResource resource) メディアリソースを対応付けます。
void	setTempo(int tempo) 再生速度を設定します。
void	setVolume(int volume) 再生音量を設定します。
void	show() 推奨されていません。 Display.setCurrent() を使用してください。
void	stop() メディア再生を終了します。
void	unsetResource(MediaResource resource) メディアリソースの対応付けをはずします。

メソッドの詳細

setResource

public void setResource(MediaResource resource)

メディアリソースを対応付けます。

パラメータ:

resource - 対応付けるメディアリソース

例外:

IllegalStateException - すでにメディアリソースが対応付けられている状態で呼び出されたときに発生する

unsetResource

public void unsetResource(MediaResource resource)

メディアリソースの対応付けをはずします。

パラメータ:

resource - 対応付けをはずすメディアリソース

getResource

public MediaResource getResource()

対応付けられているメディアリソースを返します。

戻り値:

対応付けられているメディアリソース

addMediaEventListener

public void addMediaEventListener(MediaEventListener l)

メディアの状態変化を通知するlistenerを登録します。

パラメータ:

l - 登録する MediaEventListener

removeMediaEventListener

public void removeMediaEventListener(MediaEventListener l)

メディアの状態変化を通知するlistenerを削除します。

パラメータ:

l - 削除する MediaEventListener

play

public void play()

メディアを再生します。

play　＜Phase2＞

public void play(int count)

繰り返しメディアを再生します。

パラメータ:

count - 再生繰返し回数

stop

public void stop()

メディア再生を終了します。

pause

public void pause()

メディア再生を一時停止します。

resume

public void resume()

メディア再生を再開します。

setVolume

public void setVolume(int volume)

再生音量を設定します。

メディアの再生音量を 0 〜 100 の範囲で設定します。 0 が無音を表し、1 から 100 に向かって大きくなります。 指定した値が 0 以下の場合は 0 に、100 以上の場合は 100 になります。

移動機の実装により、段階ごとに丸める場合があります。

パラメータ:

volume - 再生音量

getVolume

public int getVolume()

現在の再生音量を返します。

メディアの再生音量を 0 〜 100 の範囲で返します。 0 が無音を表し、1 から 100 に向かって大きくなります。

戻り値:

再生音量

setPitch

public void setPitch(int pitch)

再生ピッチ（キー）を設定します。

メディアの再生キーを -6 〜 +6 の範囲で設定します。 0 を標準のキーとして、-1 から -6 に向けて半音階ずつ下がり、+1 から +6 に向けて半音階ずつ上がります。 指定した値が -6 以下の場合は -6 に、6 以上の場合は 6 になります。

パラメータ:

pitch - 再生ピッチ（キー）

getPitch

public int getPitch()

現在の再生ピッチ（キー）を返します。

メディアの再生キーを -6 〜 +6 の範囲で返します。 0 を標準のキーとして、-1 から -6 に向けて半音階ずつ下がり、+1 から +6 に向けて半音階ずつ上がります。

戻り値:

再生ピッチ（キー）

setTempo

public void setTempo(int tempo)

再生速度を設定します。

メディアの再生速度を、標準速度を 100 としたパーセンテージで設定します。 85 〜 115 程度が実用的な範囲です。 指定した値が 85 以下の場合は 85 に、115 以上の場合は 115 になります。

パラメータ:

tempo - 再生速度

getTempo

public int getTempo()

現在の再生速度を返します。

メディアの再生速度を、標準速度を 100 としたパーセンテージで返します。

戻り値:

再生速度。標準速度を 100 としたパーセンテージ。

setAttribute

public void setAttribute(int attr,
                         int value)

メディアの属性の値を設定します。（将来拡張用）

パラメータ:

attr - 設定する属性

value - 設定する値

getAttribute

public int getAttribute(int attr)

メディアの属性の値を返します。（将来拡張用）

パラメータ:

attr - 取得する属性

戻り値:

属性の値

show

public void show()

推奨されていません。 Display.setCurrent() を使用してください。

メディアプレイヤーを表示します。

hide

public void hide()

推奨されていません。 Display.setCurrent() を使用してください。

メディアプレイヤーを非表示にします。