|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. （日本語版） |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
public interface PlayerListener
PlayerListener は Player で発生した非同期イベントを受け取るためのインタフェースです。
アプリケーションは、このインタフェースを実装して Player の addPlayerListener メソッドでその実装に登録することができます。
多くの一般的な Player イベントが、このインタフェースで定義されています。
イベント・タイプは、異なる実装が新しいイベント・タイプを加えることによって、専用イベントを導入するときの拡張性を確保するために文字列で定義します。
名前の衝突を避けるため、専用イベントは"逆ドメイン名"規則に沿って命名すべきです。
例えば、（"mycompany.com"というドメインを所有する）"mycompany"という会社は"com.mycompany.myEvent"などのような文字列を持つ専用イベント名を命名すべきです。
専用イベントを期待するアプリケーションは、異なる実装を横断しては適切に機能しないかもしれません。
それらを実装しない環境でも動作するようにそれらのイベントを使用するアプリケーションは、String.equals() を使用してイベントをチェックすべきです。
playerUpdate における標準イベントを捕捉するための記述例
if (eventType == PlayerListener.STARTED) {...}playerUpdate における専用イベントを捕捉するための記述例
if (eventType.equals("com.company.myEvent")) {...}
Player| フィールドの概要 | |
|---|---|
static String |
CLOSED
Player が閉じられたときに通知します。 |
static String |
DEVICE_AVAILABLE
システムか別の高優先度アプリケーションが現在 Player に利用可能な排他的なデバイスを開放したときに通知します。 |
static String |
DEVICE_UNAVAILABLE
システムか別の高優先度アプリケーションが以前に一時的に利用可能だった排他的なデバイスを制御するときに通知します。 |
static String |
DURATION_UPDATED
Player の継続時間が更新されたときに通知されます。 |
static String |
END_OF_MEDIA
Player がメディアの終端に到達して停止するときに通知されます。 |
static String |
ERROR
エラーが発生したときに通知します。 |
static String |
STARTED
Player が開始するときに通知されます。 |
static String |
STOPPED
stop メソッドが呼び出された結果として Player が停止するときに通知されます。 |
static String |
VOLUME_CHANGED
オーディオ・デバイスの音量を変更するときに通知します。 |
| メソッドの概要 | |
|---|---|
void |
playerUpdate(Player player,
String event,
Object eventData)
このメソッドは Player でイベントが発生したとき、登録されたリスナーにイベントを提供するために呼ばれます。 |
| フィールドの詳細 |
|---|
static final String STARTED
Player が開始するときに通知されます。
このイベントが受け取られるとき、eventData パラメータは Player が開始されるメディア時間を意味する Long オブジェクトになります。
STARTED には値として"started"が割り当てられます。
static final String STOPPED
stop メソッドが呼び出された結果として Player が停止するときに通知されます。
このイベントが受け取られるとき、eventData パラメータは Player が停止したメディア時間を意味する Long オブジェクトになります。
STOPPED には値として"stopped"が割り当てられます。
static final String END_OF_MEDIA
Player がメディアの終端に到達して停止するときに通知されます。
このイベントが受け取られるとき、eventData パラメータは Player がメディアの終端に到達して停止したメディア時間を意味する Long オブジェクトになります。
END_OF_MEDIA には値として"endOfMedia"が割り当てられます。
static final String DURATION_UPDATED
Player の継続時間が更新されたときに通知されます。
これは予め継続時間を提供することができないいくつかのメディア・タイプのために発生します。
メディアがしばらく再生された後にそれが判明する ――― 例えば、継続時間情報を含むキーフレームに達したときです;
または、それがメディアの終端に達したときです。
このイベントが受け取られるとき、eventData パラメータはメディアの継続時間を意味する Long オブジェクトになります。
DURATION_UPDATED には値として"durationUpdated"が割り当てられます。
static final String DEVICE_UNAVAILABLE
システムか別の高優先度アプリケーションが以前に一時的に利用可能だった排他的なデバイスを制御するときに通知します。
このイベントが受け取られるとき、Player は REALIZED 状態にあります。
デバイスが再び利用可能になったときには DEVICE_AVAILABLE イベント、または二度とデバイスが利用可能にならない場合には ERROR イベントのどちらかがこのイベントの後に続かなければなりません。
eventData パラメータにはデバイスの名前を意味する String になります。
DEVICE_UNAVAILABLE には値として"deviceUnavailable"が割り当てられます。
static final String DEVICE_AVAILABLE
システムか別の高優先度アプリケーションが現在 Player に利用可能な排他的なデバイスを開放したときに通知します。
このイベントが受け取られるとき、Player は REALIZED 状態にあります。
アプリケーションは prefetch または start メソッドによってデバイスを確保することができます。
DEVICE_UNAVAILABLE イベントはこのイベントより先に通知しなければなりません。
DEVICE_AVAILABLE には値として"deviceAvailable"が割り当てられます。
static final String VOLUME_CHANGED
オーディオ・デバイスの音量を変更するときに通知します。
このイベントが受けられるとき、eventData パラメータは VolumeControl オブジェクトになります。
VolumeControl から新しい音量について問い合わせを行うことができます。
VOLUME_CHANGED には値として"volumeChanged"が割り当てられます。
static final String ERROR
エラーが発生したときに通知します。
このイベントが通知されるとき、eventData パラメータはエラーメッセージを意味する String オブジェクトになります。
ERROR には値として"error"が割り当てられます。
static final String CLOSED
Player が閉じられたときに通知します。
このイベントが通知されるとき、eventData パラメータは null です。
CLOSED には値として"closed"が割り当てられます。
| メソッドの詳細 |
|---|
void playerUpdate(Player player,
String event,
Object eventData)
このメソッドは Player でイベントが発生したとき、登録されたリスナーにイベントを提供するために呼ばれます。
player - イベントを通知した Player が渡されます。event - イベントによって生成された定義済みの列挙された型が渡されます。eventData - イベントに関連するデータが渡されます。
|
Unofficial "CLDC 1.1 + MIDP 2.0" API Reference. （日本語版） |
|||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | |||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | |||||||||
| 公式仕様書原文の著作権表記等（※）： Mobile Information Device Profile Specification ("Specification") Version: 2.0 Status: FCS Release: November 5, 2002 Copyright 2002 Sun Microsystems, Inc. and Motorola, Inc. All rights reserved. | ※ただしこの API リファレンスは英語仕様を一語一句正確に翻訳したものではなく、一度私が英語の仕様原文を読んだ上で元の意味と構造をなるべく保つように書き起こしたものです。このため一部は完全に異なる説明となっています。また CLDC 1.1 部分は同仕様の範囲外であるため、まったく参考とはしていません。 ※仕様書のライセンス上、問題は無いと考えておりますが、万が一問題があるとお考えの関係者の方がいらっしゃいましたらメールにて連絡をいただけると幸いに存じます（第一言語に日本語、第二言語に英語を希望しますが、返信は基本的に日本語で行います）。 |