com.docomostar.system
クラス MovieStore

Object
  com.docomostar.system.MovieStore

public final class MovieStore
extends Object

携帯電話のネイティブの動画データ管理機能にアクセスする手段を提供します。 このクラスのインスタンスは、 携帯電話のネイティブの動画データの 1 つのエントリを表します。

このクラスに定義されているクラスメソッドの使い方や、 ネイティブのデータへのアクセス方法に関する規定の大原則については、 com.docomostar.system パッケージの記述を参照して下さい。 ただし、エントリ登録機能 ( addEntry(MediaMovie)) については、下記の点が大原則と異なります。

addEntry によって返されるエントリ ID について:

ImageStore や SoundStore のエントリ ID と必ず重複しません。詳細は addEntry(MediaMovie) を参照してください。

登録する動画データは、MediaManager.getMovie(String), NativeMoviePlayer.getMediaMovie() メソッドなどからメディアムービーとして取得します。

動画データのエントリからは、エントリ ID を取得することが出来るほか、 動画をメディアムービーオブジェクトとして取り出したり、 動画のファイルイメージを取り出すための InputStream を取得することができます。 また、得られたエントリ ID を PhoneTheme.setMovieTheme(int, int)、 PhoneTheme.setImageTheme(int, int)、 PhoneTheme.setSoundTheme(int, int) メソッドの引数に指定することができます。 その時のそれぞれの動作については、各メソッドの説明文を参照してください。

導入されたバージョン:

Star-1.0

メソッドの概要

static int	addEntry(MediaMovie movie) ユーザ操作により動画データを新規登録します。
static MovieStore	getEntry(int id) 動画データのエントリを取得します。
int	getId() 動画データのエントリIDを取得します。
java.io.InputStream	getInputStream() 動画データのエントリのイメージをファイルイメージとして取り出すための 入力ストリームを取得します。
MediaMovie	getMovie() 動画データのエントリをメディアムービーとして取得します。
static MovieStore	selectEntry() ユーザ操作により動画データのエントリを取得します。

クラス Object から継承されたメソッド

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細

selectEntry

public static MovieStore selectEntry()
                              throws InterruptedOperationException

ユーザ操作により動画データのエントリを取得します。

ADF に AccessUserInfo キーの指定が必要です。 上記以外の動作の詳細については、 com.docomostar.system パッケージに記述されている説明を参照してください。

端末によっては、このメソッドをサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。

戻り値:

取得した動画データのエントリを返します。 ユーザが選択操作をキャンセルするとnullを返します。 また、選択可能なエントリが存在しない場合にもnullを返します。

例外:

UnsupportedOperationException -
端末がこのメソッドをサポートしていない場合に発生します。

SecurityException -
ADF にAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 動画データのエントリを取得できない場合に発生します。

MediaException -
(NO_RESOURCES)
リソース不足により動画データを取得できなかった場合に発生します。

InterruptedOperationException -
競合条件などにより、選択操作が異常終了した場合に発生します。

getEntry

public static MovieStore getEntry(int id)
                           throws StoreException

動画データのエントリを取得します。

ADF に AccessUserInfo キーの指定が必要です。 上記以外の動作の詳細については、 com.docomostar.system パッケージに記述されている説明を参照してください。

端末によっては、このメソッドをサポートしていない場合があります。 その場合には、例外 UnsupportedOperationException が発生します。

パラメータ:

id - 取得する動画データのエントリIDを指定します。

戻り値:

取得した動画データのエントリを返します。

例外:

UnsupportedOperationException -
端末がこのメソッドをサポートしていない場合に発生します。

SecurityException -
ADF にAccessUserInfoキーの指定がないアプリケーションが このメソッドを呼び出した場合に発生します。

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 動画データのエントリを取得できない場合に発生します。 以下の場合も含みます。

• UIM 内情報を用いた実行制限がかけられている場合
• 指定された ID の動画が、 このアプリケーション自身が保存したものではなく、 かつ、その動画データに再配布不可識別子が設定されている場合

StoreException -
(NOT_FOUND)
指定された ID の動画エントリが存在しない場合に発生します。

MediaException -
(NO_RESOURCES)
リソース不足により動画データを取得できなかった場合に発生します。

addEntry

public static int addEntry(MediaMovie movie)
                    throws InterruptedOperationException

ユーザ操作により動画データを新規登録します。 引数に指定された動画データが保持している再配布可能かどうかの設定のままで登録されます。

このメソッドにより返されるエントリ ID は、 ImageStore クラスや SoundStore クラスのエントリ ID を取得するメソッドによって返されるエントリ ID とは必ず重複しません。

ADF に AccessUserInfo キーの指定が必要です。 キーの指定がない場合には、例外 SecurityException が発生します。

上記以外の動作の詳細については、 com.docomostar.system パッケージに記述されている説明を参照してください。

データ保存領域の容量を超えているために登録できない場合は、 ユーザが登録操作をキャンセルした場合と同様の値を返します。

パラメータ:

movie - 登録する動画のメディアムービーを指定します。

戻り値:

登録されたエントリのIDを返します。
ユーザが登録操作をキャンセルした場合、-1 を返します。

例外:

NullPointerException -
引数 movie に null が指定された場合に発生します。

MediaException -
(UNSUPPORTED_FORMAT)
引数の movie にシステムが提供している以外の メディアムービー (MediaMovie インタフェースを実装した未知のクラスのオブジェクト) が渡された場合に発生します。

MediaException -
(ILLEGAL_STATE)
指定されているメディアムービーが use 状態でない場合に発生します。

MediaException -
(ILLEGAL_STATE)
指定されているメディアムービーの利用が「一度きり」 である場合に発生します。

SecurityException -
ADF にAccessUserInfoキーの指定がないアプリケーションが呼び出された場合に発生します。

SecurityException -
ロック機能などのネイティブ独自のセキュリティ設定により、 動画データを登録できない場合に発生します。

MediaException -
(UNSUPPORTED_FORMAT)
指定された動画の縦もしくは横のいずれかが、 登録可能な動画サイズよりも大きい場合に発生します。

MediaException -
(UNSUPPORTED_FORMAT)
指定された動画のデータサイズが、 登録可能なデータサイズ(bytes)よりも大きい場合に発生します。

InterruptedOperationException -
競合条件などにより、登録操作が異常終了した場合に発生します。

getId

public int getId()

動画データのエントリIDを取得します。

戻り値:

動画データのエントリIDを返します。

getMovie

public MediaMovie getMovie()

動画データのエントリをメディアムービーとして取得します。

取得されたメディアムービーは、 disposeもuseもされていない状態です。

常に同じメディアムービーオブジェクトを返します。 このため、既にメディアムービーオブジェクトが利用不可状態( unuse() が実行された状態)、 リソース破棄状態(dispose() が実行された状態)である場合は、 同じ状態のメディアムービーオブジェクトが返ります。 dispose() 後にメディアムービーを利用するには、 getEntry(int) または selectEntry() によって画像データのエントリを再取得し、 本メソッドで別のメディアムービーオブジェクトを取得しなければなりません。

戻り値:

メディアムービーを返します。

getInputStream

public java.io.InputStream getInputStream()

動画データのエントリのイメージをファイルイメージとして取り出すための 入力ストリームを取得します。
このメソッドを呼び出すたびに異なる入力ストリームを返します。

戻り値:

動画のファイルイメージを取り出すための入力ストリームを返します。