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() を使います。

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

関連項目:

Display#setCurrent()

hide

public void hide()

推奨されていません。 Display.setCurrent() を使います。

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

関連項目:

Display#setCurrent()