com.docomostar.media
インタフェース MediaMovie

すべてのスーパーインタフェース:

MediaResource

public interface MediaMovie
extends MediaResource

動画データを定義します。

メディアムービーは MediaManager クラスなどのメソッドを使用して取得します。 実際にどのようなクラスのオブジェクトが返されるかは機種依存です。 メディアムービーは NativeMoviePlayer で再生します。

導入されたバージョン:

Star-1.0

関連項目:

MediaManager, NativeMoviePlayer

フィールドの概要

static String	MP4_AUDIOTRACK 動画データに含まれる、 再生可能な Audio トラックの数を表すプロパティのキーです (= "mp4.audiotrack")。
static String	MP4_TEXTTRACK 動画データに含まれる、 再生可能な Text トラックの数を表すプロパティのキーです (= "mp4.texttrack")。
static String	MP4_VIDEOTRACK 動画データに含まれる、 再生可能な Video トラックの数を表すプロパティのキーです (= "mp4.videotrack")。

メソッドの概要

int	getHeight() 動画の高さを取得します。
int	getWidth() 動画の幅を取得します。
void	use(MediaResource overwritten, boolean useOnce) 一度きりの利用であるかどうかを指定して、 このメディアムービーの使用開始を宣言します。

インタフェース com.docomostar.media.MediaResource から継承されたメソッド

dispose, getProperty, isRedistributable, setProperty, setRedistributable, unuse, use

フィールドの詳細

MP4_VIDEOTRACK

static final String MP4_VIDEOTRACK

動画データに含まれる、 再生可能な Video トラックの数を表すプロパティのキーです (= "mp4.videotrack")。 MediaResource.getProperty(String) メソッドの引数として使用します。

動画データに再生可能な Video トラックが含まれていた場合、 含まれている Video トラックの数を表す文字列 (Integer.parseInt(String) にて変換できる文字列) が返されます。 再生可能な Video トラックが含まれていなかった場合、 "0" が返されます。

関連項目:

定数フィールド値

MP4_AUDIOTRACK

static final String MP4_AUDIOTRACK

動画データに含まれる、 再生可能な Audio トラックの数を表すプロパティのキーです (= "mp4.audiotrack")。 MediaResource.getProperty(String) メソッドの引数として使用します。

動画データに再生可能な Audio トラックが含まれていた場合、 含まれている Audio トラックの数を表す文字列 (Integer.parseInt(String) にて変換できる文字列 ) が返されます。 再生可能な Audio トラックが含まれていなかった場合、 "0" が返されます。

関連項目:

定数フィールド値

MP4_TEXTTRACK

static final String MP4_TEXTTRACK

動画データに含まれる、 再生可能な Text トラックの数を表すプロパティのキーです (= "mp4.texttrack")。 MediaResource.getProperty(String) メソッドの引数として使用します。

動画データに再生可能な Text トラックが含まれていた場合、 含まれている Text トラックの数を表す文字列 (Integer.parseInt(String) にて変換できる文字列 ) が返されます。 再生可能な Text トラックが含まれていなかった場合、 "0" が返されます。

関連項目:

定数フィールド値

メソッドの詳細

use

void use(MediaResource overwritten,
         boolean useOnce)
         throws ConnectionException

一度きりの利用であるかどうかを指定して、 このメディアムービーの使用開始を宣言します。 このメソッドの基本的な動作については、 スーパーインタフェースの説明を参照して下さい。 ただし、引数 overwritten に関するメソッドの振る舞いは、 スーパーインタフェースの説明ではなく、このメソッドの説明が優先されます。

なお、メディアムービーにおいては、 内部データ領域の再利用はサポートしていません。 メディアムービーは内部表現形式に変換しないので、 内部データ領域が存在しないためです。 引数 overwritten に、null でない値を指定した場合には、 null が指定された場合と同等に振る舞います。 引数 overwritten にどのような値が指定されても例外は発生しません。 (このメソッドの呼び出しにより、 引数 overwritten が利用不可状態 (unuse された状態 ) になることもありません。)

定義:

インタフェース MediaResource 内の use

パラメータ:

overwritten - 意味を持ちません。通常は null を指定して下さい。

useOnce - このメディアムービーの利用が「一度きり」の場合には true を、そうでない場合には false を指定します。

例外:

MediaException -
(ILLEGAL_STATE)
既に dispose されているメディアムービーに対して呼び出された場合に発生します。

MediaException -
(ILLEGAL_STATE)
このオブジェクトが、「一度きり」と指定して use され、その後 unuse されていた場合に発生します。

SecurityException -
セキュリティ上の制約に触れた場合に発生します。

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

MediaException -
(UNSUPPORTED_FORMAT)
端末で再生できないようなデータフォーマットの場合に発生します。 データの長さが 0 の場合など、 フォーマットが不正と見なされる場合を含みます。

MediaException -
(NO_RESOURCES)
必要なリソースが確保できなかった場合に発生します。

getWidth

int getWidth()

動画の幅を取得します。

利用可能状態でない場合には 0 が返ります。

戻り値:

動画の幅を返します。

例外:

MediaException -
(ILLEGAL_STATE)
既に dispose されているメディアムービーに対して呼び出された場合に発生します。

getHeight

int getHeight()

動画の高さを取得します。

利用可能状態でない場合には 0 が返ります。

戻り値:

動画の高さを返します。

例外:

MediaException -
(ILLEGAL_STATE)
既に dispose されているメディアムービーに対して呼び出された場合に発生します。