com.kddi.media
クラス MediaPlayer [Phase1〜(一部Phase2〜)]

java.lang.Object
  |
  +--com.kddi.media.MediaPlayer
すべての実装インタフェース:
MediaPlayerInterface
直系の既知のサブクラス:
CMXPlayer, QcelpPlayer, SMAFPlayer

public abstract class MediaPlayer
extends java.lang.Object
implements MediaPlayerInterface

メディアプレイヤーのためのベースクラス。

このクラスでは、メディアプレイヤーのデフォルトの振る舞い(何もしない)を定義しています。 各メディアタイプごとに必要な動作は、サブクラスで実装してください。

サブクラス化にあたっては、以下の作業が必要になります。


内部クラスの概要
protected  class MediaPlayer.EventWatcher
          移動機システムからのイベントを監視するクラス。
protected  class MediaPlayer.MediaPlayerEvent
          メディアプレイヤーのイベントをカプセル化したクラス。
 
フィールドの概要
protected  MediaPlayerBox _box
          関連付けられている MediaPlayerBox オブジェクト。
protected  int _id
          メディアプレイヤーの識別子。
protected  MediaEventListener _listener
          メディアイベントリスナー。
protected  int _pitch
          再生ピッチ。
protected  MediaResource _resource
          関連付けられているメディアリソース。
protected  int _tempo
          再生速度。
protected  int _volume
          再生音量。
protected static int INVALID_PLAYER
          無効なプレイヤーインスタンスを示す定数。
 
コンストラクタの概要
protected MediaPlayer(MediaResource resource, MediaPlayerBox box)
          コンストラクタ。
 
メソッドの概要
 void addMediaEventListener(MediaEventListener l)
          メディアの状態変化を通知する listener を登録する。
static boolean canPlay(java.lang.String dataType)
          メディアタイプを再生可能かどうか調べる。
protected abstract  void dispose()
          メディアプレイヤーの破棄。
protected abstract  boolean disposePlayer()
          メディアプレイヤーの破棄。
 int getAttribute(int attr)
          メディアの属性を取得する。
 int getPitch()
          現在の再生ピッチ(キー)を取得する。
 MediaResource getResource()
          対応付けられているメディアリソースを取得する。
 int getTempo()
          現在の再生速度を取得する。
 int getVolume()
          現在の再生音量を取得する。
 void hide()
          メディアプレイヤーを非表示にする。
protected  void notifyEvent(MediaPlayer player, int type, int option)
          メディアイベントの通知。
protected  void paint(javax.microedition.lcdui.Graphics g)
          メディアプレイヤーの描画。
 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()
          メディアプレイヤーを表示する。
 void stop()
          メディアを停止する。
 void unsetResource(MediaResource resource)
          メディアリソースの対応付けをはずす。
protected  void validateId()
          プレイヤー ID の検証。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

INVALID_PLAYER

protected static final int INVALID_PLAYER
無効なプレイヤーインスタンスを示す定数。

_id

protected int _id
メディアプレイヤーの識別子。

_resource

protected MediaResource _resource
関連付けられているメディアリソース。

_listener

protected MediaEventListener _listener
メディアイベントリスナー。

_volume

protected int _volume
再生音量。

_tempo

protected int _tempo
再生速度。

_pitch

protected int _pitch
再生ピッチ。

_box

protected MediaPlayerBox _box
関連付けられている MediaPlayerBox オブジェクト。
コンストラクタの詳細

MediaPlayer

protected MediaPlayer(MediaResource resource,
                      MediaPlayerBox box)
コンストラクタ。
パラメータ:
resource - 対応付けるメディアリソース。
box - このインスタンスを生成する MediaPlayerBox オブジェクト。
例外:
IllegalStateException - すでに破棄されたメディアリソースが指定されたときに送出。
メソッドの詳細

setResource

public void setResource(MediaResource resource)
メディアリソースを対応付ける。
定義:
インタフェース MediaPlayerInterface 内の setResource
パラメータ:
resource - 対応付けるメディアリソース。
例外:
IllegalStateException - すでにメディアリソースが対応付けられている状態で呼び出されたときに送出。

unsetResource

public void unsetResource(MediaResource resource)
メディアリソースの対応付けをはずす。
定義:
インタフェース MediaPlayerInterface 内の unsetResource
パラメータ:
resource - 対応付けをはずすメディアリソース。

getResource

public MediaResource getResource()
対応付けられているメディアリソースを取得する。
定義:
インタフェース MediaPlayerInterface 内の getResource
戻り値:
対応付けられているメディアリソース。

addMediaEventListener

public void addMediaEventListener(MediaEventListener l)
メディアの状態変化を通知する listener を登録する。
定義:
インタフェース MediaPlayerInterface 内の addMediaEventListener
パラメータ:
l - MediaEventListener インターフェイスを実装したインスタンス。

removeMediaEventListener

public void removeMediaEventListener(MediaEventListener l)
メディアの状態変化を通知するlistenerを削除する。
定義:
インタフェース MediaPlayerInterface 内の removeMediaEventListener
パラメータ:
l - MediaEventListener インターフェイスを実装したインスタンス。

play

public void play()
メディアを再生する。
定義:
インタフェース MediaPlayerInterface 内の play

play [Phase2〜]

public void play(int count)
メディアを再生する。
定義:
インタフェース MediaPlayerInterface 内の play
パラメータ:
count - 再生繰返し回数。

stop

public void stop()
メディアを停止する。
定義:
インタフェース MediaPlayerInterface 内の stop

pause

public void pause()
メディアを一時停止する。
定義:
インタフェース MediaPlayerInterface 内の pause

resume

public void resume()
メディアの一時停止を解除する。
定義:
インタフェース MediaPlayerInterface 内の resume

setAttribute

public void setAttribute(int attr,
                         int value)
メディアの属性を設定する。(将来拡張用)
定義:
インタフェース MediaPlayerInterface 内の setAttribute
パラメータ:
attr - 設定する属性。
value - 設定する値。

getAttribute

public int getAttribute(int attr)
メディアの属性を取得する。(将来拡張用)
定義:
インタフェース MediaPlayerInterface 内の pause

resume

public void resume()
繝。繝