com.nttdocomo.ui
インタフェース MediaResource

既知のサブインタフェースの一覧:

MediaData, MediaImage, MediaSound

public interface MediaResource

メディアリソースデータを定義します。このメディアリソースインタフェースは、 メディアデータクラスが 必ず実装しなければならないインタフェースを定めます。 メディアリソースは、使用する前に use() で使用開始を宣言し、使用した後に unuse() で使用終了を 宣言しなければなりません。 また、もはやメディアリソースを使用しない場合は dispose() で破棄しな ければなりません。なお、dispose メソッドを呼び出した後にそのオブジェクトに対してdispose()以外の 何らかのメソッドを呼び出した場合UIException が投げられます。

関連項目:

MediaManager

メソッドの概要

void	dispose() メディアリソースを破棄します。
void	unuse() メディアリソースの使用終了を宣言します。
void	use() メディアリソースの使用開始を宣言します。

メソッドの詳細

use

public void use()
         throws ConnectionException,
                UIException

メディアリソースの使用開始を宣言します。このメソッドが発行されると、実際にメディアリソー スがロードされ、内部表現形式に変換されます。

例外:

ConnectionException - ネットワーク通信などで例外が発生したときに 投げられます。 ネットワークサービスがないか圏外の場合、ステータスには OUT_OF_SERVICE が設定されています。 タイムアウトの場合には、TIMEOUT が設定さ れています。

UIException - 必要なリソースが確保できなかった場合あるいはデータが使用 できない場 合に投げられます。また、このメソッドをよびだしてはいけない状態のときに 呼び出した場合 も投げられます。とりうるステータスは、以下のとおりです。

• BUSY_RESOURCE
  リソースが確保できなかった場合
• UNSUPPORTED_FORMAT
  端末がサポートしていないフォーマットだった場合
• ILLEGAL_STATE
  dispose()を呼んだあとに、use()が呼ばれた場合。
• SecurityException
  セキュリティ上の制約に触れた場合に発生します。

unuse

public void unuse()

メディアリソースの使用終了を宣言します。メディアリソースをメディアプレゼンタで再生してい る最中にこのメソッドを呼び出した場合は利用不可状態となります。

例外:

UIException - dispose()メソッドを呼び出した後に、このメソッドを使用しようとした場合に、投 げられます。ステータスは、ILLEGAL_STATE です。

dispose

public void dispose()

メディアリソースを破棄します。メディアリソースをメディアプレゼンタで再生している最中にこ のメソッドを呼び出してはいけません。この場合はリソース破棄状態となります。 dispose() を 呼び出した後にそのオブジェクトに対してdispose()以外の何らかのメソッドを呼び出した場合、 UIException が投げられます。

関連項目:

use(), unuse()