com.nttdocomo.ui
クラス MediaManager

Object
  |
  +--com.nttdocomo.ui.MediaManager

public final class MediaManager
extends Object

メディアリソースデータの管理オブジェクトを定義します。
リソースの取得と利用時の振舞は以下のようになります。

ミニマムスペック:

関連項目:
MediaResource, MediaData, MediaImage, MediaSound, MediaPresenter, AudioPresenter, VisualPresenter

メソッドの概要
static MediaData getData(byte[] data)
           バイト配列を指定してメディアデータオブジェクトを取り出します。
static MediaData getData(java.io.InputStream in)
           ストリームを指定してメディアデータオブジェクトを取り出します。
static MediaData getData(String location)
          場所を指定してメディアデータオブジェクトを取り出します。
static MediaImage getImage(byte[] data)
           バイト配列を指定してメディアイメージオブジェクトを取り出します。
static MediaImage getImage(java.io.InputStream in)
           ストリームを指定してメディアイメージオブジェクトを取り出します。
static MediaImage getImage(String location)
          場所を指定してメディアイメージオブジェクトを取り出します。
static MediaSound getSound(byte[] data)
           バイト配列を指定してメディアサウンドオブジェクトを取り出します。
static MediaSound getSound(java.io.InputStream in)
           ストリームを指定してメディアサウンドオブジェクトを取り出します。
static MediaSound getSound(String location)
          場所を指定してメディアサウンドオブジェクトを取り出します。
static MediaImage getStreamingImage(String location, String type)
           ストリーミング再生用として場所と MIME Type を指定してメディアイメージオブジェクトを取り出します。
 
クラス Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getData

public static final MediaData getData(String location)
場所を指定してメディアデータオブジェクトを取り出します。 location指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

端末によってはサポートされない場合があります。 サポートされない場合、戻り値はnullとなります。

パラメータ:
location - 場所を指定します。
戻り値:
メディアデータオブジェクトを返します。
例外:
NullPointerException - 引数 location が null の場合に発生します。
IllegalArgumentException - 引数 location に不正な場所が指定された場合に発生します。
SecurityException - セキュリティ上の制約に触れた場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)

getImage

public static final MediaImage getImage(String location)
場所を指定してメディアイメージオブジェクトを取り出します。 location指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

パラメータ:
location - 場所を指定します。
戻り値:
メディアイメージオブジェクトを返します。
例外:
NullPointerException - 引数 location が null の場合に発生します。
IllegalArgumentException - 引数 location に不正な場所が指定された場合に発生します。
SecurityException - セキュリティ上の制約に触れた場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)

getSound

public static final MediaSound getSound(String location)
場所を指定してメディアサウンドオブジェクトを取り出します。 location指定のフォーマット形式が正しくない場合 、引数指定誤りになります。

パラメータ:
location - 場所を指定します。
戻り値:
メディアサウンドオブジェクトを返します。
例外:
NullPointerException - 引数 location が null の場合に発生します。
IllegalArgumentException - 引数 location に不正な場所が指定された場合に発生します。
SecurityException - セキュリティ上の制約に触れた場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)

getStreamingImage

public static final MediaImage getStreamingImage(String location,
                                                 String type)

ストリーミング再生用として場所と MIME Type を指定してメディアイメージオブジェクトを取り出します。 location指定のフォーマット形式が正しくない場合 、 引数指定誤りになります。
このメソッドでは、MIME Type の Type が "image" および "video" のものをサポートしています。 Subtype としてどのようなコンテンツをサポートしているかは機種依存です。

Type として "image" が指定された場合は、 getImage(String) を呼び出した場合と同様に通常のメディアイメージオブジェクトを返します。
Type として "video" が指定された場合は、 ストリーミング再生用のメディアイメージオブジェクトを返します。 ストリーミング再生用のメディアイメージオブジェクトに対してメディアリソースの使用開始を宣言した場合にどのような処理が行われるかは機種依存です。 使用開始を宣言した後に VisualPresenter コンポーネントにセットして再生を開始すると、 メディアイメージをロードしながらストリーミング再生を開始します。 なお、使用開始の宣言時あるいは再生開始後にストリーミング再生ができないようなメディアイメージであることが判明した場合は、 メディアイメージのロードが完了してから通常の再生を開始します。

パラメータ:
location - 場所を指定します。
type - MIME Type を指定します。
戻り値:
ストリーミング再生用のメディアイメージオブジェクトを返します。
例外:
NullPointerException - 引数 location または type が null の場合に発生します。
UIException - 引数 type にサポートしていない MIME Type が指定された場合に発生します(UNSUPPORTED_FORMAT)。
IllegalArgumentException - 引数 location に不正な場所が指定された場合に発生します。
SecurityException - セキュリティ上の制約に触れた場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.5

getData

public static final MediaData getData(java.io.InputStream in)
ストリームを指定してメディアデータオブジェクトを取り出します。 ストリームからは、メディアデータのファイルイメージを取り出せる必要があります。

端末によってはサポートされない場合があります。 サポートされない場合、戻り値はnullとなります。

パラメータ:
in - 入力ストリームを指定します。
戻り値:
メディアデータオブジェクトを返します。
例外:
NullPointerException - 引数 in が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0

getImage

public static final MediaImage getImage(java.io.InputStream in)
ストリームを指定してメディアイメージオブジェクトを取り出します。 ストリームからは、メディアイメージのファイルイメージを取り出せる必要があります。

パラメータ:
in - 入力ストリームを指定します。
戻り値:
メディアイメージオブジェクトを返します。
例外:
NullPointerException - 引数 in が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0

getSound

public static final MediaSound getSound(java.io.InputStream in)
ストリームを指定してメディアサウンドオブジェクトを取り出します。 ストリームからは、メディアサウンドのファイルイメージを取り出せる必要があります。

パラメータ:
in - 入力ストリームを指定します。
戻り値:
メディアサウンドオブジェクトを返します。
例外:
NullPointerException - 引数 in が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0

getData

public static final MediaData getData(byte[] data)
バイト配列を指定してメディアデータオブジェクトを取り出します。 バイト配列には、メディアデータのファイルイメージが格納されている必要があります。

端末によってはサポートされない場合があります。 サポートされない場合、戻り値はnullとなります。

パラメータ:
data - 入力バイト配列を指定します。
戻り値:
メディアデータオブジェクトを返します。
例外:
NullPointerException - 引数 data が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0

getImage

public static final MediaImage getImage(byte[] data)
バイト配列を指定してメディアイメージオブジェクトを取り出します。 バイト配列には、メディアイメージのファイルイメージが格納されている必要があります。

パラメータ:
data - 入力バイト配列を指定します。
戻り値:
メディアイメージオブジェクトを返します。
例外:
NullPointerException - 引数 data が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0

getSound

public static final MediaSound getSound(byte[] data)
バイト配列を指定してメディアサウンドオブジェクトを取り出します。 バイト配列には、メディアサウンドのファイルイメージが格納されている必要があります。

パラメータ:
data - 入力バイト配列を指定します。
戻り値:
メディアサウンドオブジェクトを返します。
例外:
NullPointerException - 引数 data が null の場合に発生します。
UIException - システムリソースの不足などでオブジェクトが生成できなかった場合に発生します(NO_RESOURCES)。
導入されたバージョン:
DoJa-3.0


NTT DoCoMo,Inc.

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

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

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