|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Object | +--com.nttdocomo.ui.Component | +--com.nttdocomo.ui.VisualPresenter
表示可能なメディアデータの再生オブジェクトを定義します。 メディア再生コンポーネントクラスは、 スクリーンに表示するメディアデータを再生するための高レベル API のコンポーネントです。 リスナを登録することによって、表示の状態の通知を受けることができます。
端末で再生できないようなメディアデータをセットした場合の振舞は機種依存で、 端末によっては UIExceptionが発生する場合があります。
属性の設定は、setAttributeメソッドを使用します。 イメージを表示する位置を指定するために IMAGE_XPOS、IMAGE_YPOS 属性を 使用することができます。イメージ上のIMAGE_XPOS, IMAGE_YPOS で指定された位置がプレゼンタの左上角に来るように表示されます。アプリケーションプログラムでは、この値を 変更することでイメージをスクロール表示することができます。
IMAGE_XPOS +---+--------------+ | |<- Image (MediaImage) IMAGE_YPOS + +------------+ | | | Visual | | | | Presenter | | | | | | | +------------+ | | | +------------------+
setDataメソッドと setImage メソッドは、1つのプレゼンタオブジェクトに対して排他的に使用します。
setDataメソッドでデータを設定してからsetImageメソッドでイメージデータを
設定したり、その逆をすることはできません。
同じメソッドを複数回呼出した場合は、最後に設定したデータが有効になります。
[DoJa-3.0]
DoJa-3.0では上記の排他使用の制限はありません。
いずれかのメソッドにより最後に設定されたデータが有効になります。
ミニマムスペック:
AudioPresenter
フィールドの概要 | |
static int |
ATTR_AUDIO_OFF
音声再生の属性値で、音声を再生しないことを表します(=0)。 |
static int |
ATTR_AUDIO_ON
音声再生の属性値で、音声を再生することを表します(=1)。 |
static int |
ATTR_FORCE_INLINE_PLAYER
メディアイメージの再生方法の属性値で、インラインのプレーヤでのみ再生することを表します(=3)。 |
static int |
ATTR_FORCE_NATIVE_PLAYER
メディアイメージの再生方法の属性値で、ネイティブのプレーヤでのみ再生することを表します(=2)。 |
static int |
ATTR_PREFER_INLINE_PLAYER
メディアイメージの再生方法の属性値で、可能であればインラインのプレーヤで再生することを表します(=1)。 |
static int |
ATTR_PREFER_NATIVE_PLAYER
メディアイメージの再生方法の属性値で、可能であればネイティブのプレーヤで再生することを表します(=0)。 |
static int |
AUDIO_MODE
音声付きのメディアイメージの音声を再生するかどうかを属性です(=4)。 |
static int |
IMAGE_XPOS
イメージを表示する位置(X座標)を示す属性です(=1)。 |
static int |
IMAGE_YPOS
イメージを表示する位置(Y座標)を示す属性です(=2)。 |
protected static int |
MAX_VENDOR_ATTR
ベンダ定義属性の種類の最大値(=127)。 |
protected static int |
MAX_VENDOR_VISUAL_EVENT
ベンダ定義のイベントの最大値(=127)。 |
protected static int |
MIN_VENDOR_ATTR
ベンダ定義属性の種類の最少値(=64)。 |
protected static int |
MIN_VENDOR_VISUAL_EVENT
ベンダ定義のイベントの最少値(=64)。 |
static int |
PLAYER_MODE
メディアイメージの再生方法を指定する属性です(=3)。 |
static int |
VISUAL_COMPLETE
再生が終了したことを示すイベントタイプです (=3)。 |
static int |
VISUAL_PLAYING
再生が開始されたことを示すイベントタイプです (=1)。 |
static int |
VISUAL_STOPPED
再生が中断されたことを示すイベントタイプです (=2)。 |
コンストラクタの概要 | |
VisualPresenter()
空のプレゼンタオブジェクトを生成します。 |
メソッドの概要 | |
MediaResource |
getMediaResource()
現在セットされているメディアリソースを取得します。 |
void |
play()
メディアデータの再生を開始します。 |
void |
setAttribute(int attr,
int value)
再生方法に関する属性を設定します。 |
void |
setData(MediaData data)
メディアデータをセットします。 |
void |
setImage(MediaImage image)
メディアイメージをセットします。 |
void |
setMediaListener(MediaListener listener)
リスナを登録します。 |
void |
stop()
メディアデータの再生を停止します。 |
クラス com.nttdocomo.ui.Component から継承したメソッド |
getHeight, getWidth, getX, getY, setBackground, setFont, setForeground, setLocation, setSize, setVisible |
クラス Object から継承したメソッド |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
フィールドの詳細 |
public static final int IMAGE_XPOS
public static final int IMAGE_YPOS
public static final int PLAYER_MODE
ATTR_PREFER_NATIVE_PLAYER
に設定されています。
再生中に設定した場合、属性値は設定されますが、再生中の動画には反映されません。
public static final int ATTR_PREFER_NATIVE_PLAYER
public static final int ATTR_PREFER_INLINE_PLAYER
public static final int ATTR_FORCE_NATIVE_PLAYER
public static final int ATTR_FORCE_INLINE_PLAYER
public static final int AUDIO_MODE
ATTR_AUDIO_ON
に設定されています。
再生中に設定した場合、属性値は設定されますが、再生中の動画には反映されません。
public static final int ATTR_AUDIO_OFF
public static final int ATTR_AUDIO_ON
protected static final int MIN_VENDOR_ATTR
protected static final int MAX_VENDOR_ATTR
public static final int VISUAL_PLAYING
public static final int VISUAL_STOPPED
public static final int VISUAL_COMPLETE
protected static final int MIN_VENDOR_VISUAL_EVENT
protected static final int MAX_VENDOR_VISUAL_EVENT
コンストラクタの詳細 |
public VisualPresenter()
メソッドの詳細 |
public void setImage(MediaImage image)
image
- メディアイメージを指定します。
UIException
- 再生中にこのメソッドを呼び出そうとした場合に発生します。
NullPointerException
- 引数 image に null が指定された場合に発生します。
UIException
- 引数の image にシステムが提供している以外のメディアイメージ
(MediaImage
インタフェースを実装した未知のクラスのオブジェクト)
が渡された場合に発生します(UNSUPPORTED_FORMAT)。
UIException
- 引数 image に useされていないメディアイメージが指定された場合に発生します(ILLEGAL_STATE)。
UIException
-
[DoJa-3.5]
これ以上の数のVisualPresenterに動画を設定できない時に、
引数 image に動画を指定した場合に発生します(BUSY_RESOURCE)。
UIException
- 引数 image に端末で再生できないようなメディアイメージが指定された場合に発生します(UNSUPPORTED_FORMAT)。
public void setData(MediaData data)
MediaPresenter
内の setData
data
- メディアデータを指定します。
UnsupportedOperationException
- 端末がこのメソッドをサポートしていない場合に発生します。
UIException
- 再生中にこのメソッドを呼び出そうとした場合に発生します(ILLEGAL_STATE)。
NullPointerException
- 引数 data に null が指定された場合に発生します。
UIException
- 引数の data にシステムが提供している以外のオブジェクト
(MediaData
インタフェースを実装した未知のクラスのオブジェクト)
が渡された場合に発生します(UNSUPPORTED_FORMAT)。
UIException
- 引数 data に useされていないメディアデータが指定された場合に発生します(ILLEGAL_STATE)。
public MediaResource getMediaResource()
MediaPresenter
内の getMediaResource
public void play()
MediaPresenter
内の play
UIException
- メディアデータがセットされていない場合に発生します(ILLEGAL_STATE)。
UIException
- メディアデータがuse()されていない場合に発生します(ILLEGAL_STATE)。
UIException
-
[DoJa-3.5]
これ以上の数のVisualPresenterで動画再生できない時に、
動画を再生しようとした場合に発生します(BUSY_RESOURCE)。
UIException
-
[DoJa-3.5]
動画全体を画面に表示できなくなる可能性がある場合や、
同一パネルにアニメGIFを再生しているプレゼンタが存在している場合など、
端末の制限により動画が再生できない状況の場合に発生します(ILLEGAL_STATE)。
UIException
- ネイティブ側で再生開始に失敗した場合に発生します(ILLEGAL_STATE)。
UIException
- [DoJa-2.1] 通話中に呼び出された場合に発生します(BUSY_RESOURCE)。
UIException
-
[DoJa-3.5]
マルチタスク機能によってバックグラウンドで動作しているネイティブ機能が未保存のデータを保持している場合に、
ユーザ確認においてユーザが当該データの破棄を拒否すると発生します(BUSY_RESOURCE)。
public void stop()
MediaPresenter
内の stop
UIException
- メディアデータがセットされていない場合に発生します(ILLEGAL_STATE)。
UIException
- メディアデータがuse()されていない場合に発生します(ILLEGAL_STATE)。
public void setAttribute(int attr, int value)
MediaPresenter
内の setAttribute
attr
- 設定する属性の種類を指定します。value
- 設定する属性の値を指定します。
IllegalArgumentException
- [DoJa-2.0] 引数 attr で指定された有効な属性に対して、引数 value に不正な値が指定された場合に発生します。
public void setMediaListener(MediaListener listener)
MediaPresenter
内の setMediaListener
listener
- 登録するリスナを指定します。
|
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
NTT DoCoMo,Inc.
本製品または文書は著作権法により保護されており、その使用、複製、再頒布および逆コンパイルを制限するライセンスのもとにおいて頒布されます。NTTドコモ(その他に許諾者がある場合は当該許諾者も含めて)の書面による事前の許可なく、本製品および関連する文書のいかなる部分も、いかなる方法によっても複製することが禁じられます。フォントを含む第三者のソフトウェアは、著作権法により保護されており、その提供者からライセンスを受けているものです。
Sun、Sun Microsystems、Java、J2MEおよびJ2SEは、米国およびその他の国における米国 Sun Microsystems,Inc.の商標または登録商標です。サンのロゴマークは、米国 Sun Microsystems, Inc.の登録商標です。
「iモード」、「iアプリ/アイアプリ」、「i-αppli」ロゴ、「DoJa」はNTTドコモの商標または登録商標です。