概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

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) [iアプリオプションAPI]
          動画データのエントリを取得します。
 int getId() [iアプリオプションAPI]
          動画データのエントリIDを取得します。
 java.io.InputStream getInputStream() [iアプリオプションAPI]
          動画データのエントリのイメージをファイルイメージとして取り出すための 入力ストリームを取得します。
 MediaMovie getMovie() [iアプリオプションAPI]
          動画データのエントリをメディアムービーとして取得します。
static MovieStore selectEntry() [iアプリオプションAPI]
          ユーザ操作により動画データのエントリを取得します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

selectEntry

public static MovieStore selectEntry()
                              throws InterruptedOperationException [iアプリオプションAPI]
ユーザ操作により動画データのエントリを取得します。

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 [iアプリオプションAPI]
動画データのエントリを取得します。

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() [iアプリオプションAPI]
動画データのエントリIDを取得します。

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

getMovie

public MediaMovie getMovie() [iアプリオプションAPI]
動画データのエントリをメディアムービーとして取得します。

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

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

戻り値:
メディアムービーを返します。

getInputStream

public java.io.InputStream getInputStream() [iアプリオプションAPI]
動画データのエントリのイメージをファイルイメージとして取り出すための 入力ストリームを取得します。
このメソッドを呼び出すたびに異なる入力ストリームを返します。

戻り値:
動画のファイルイメージを取り出すための入力ストリームを返します。
概要  パッケージ   クラス  階層ツリー  非推奨 API  索引  ヘルプ 
 前のクラス   次のクラス フレームあり    フレームなし    
概要:  入れ子 | フィールド | コンストラクタ | メソッド 詳細:  フィールド | コンストラクタ | メソッド

NTT DOCOMO,INC.

本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ（その他に許諾者がある場合は当該許諾者も含めて）の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。

Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。

FeliCaは、ソニー株式会社が開発した非接触ICカードの技術方式です。FeliCaは、ソニー株式会社の登録商標です。

「ｉモード」、「ｉアプリ／アイアプリ」、「ｉ-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。

その他記載された会社名、製品名などは該当する各社の商標または登録商標です。