com.docomostar.ui
クラス AudioTrackPresenter

Object
  com.docomostar.ui.AudioPresenter
      com.docomostar.ui.AudioTrackPresenter

すべての実装インタフェース:

MediaPresenter

public class AudioTrackPresenter

extends AudioPresenter

[iアプリオプションAPI]

動画のオーディオトラックを再生するためのオーディオプレゼンタです。 このクラスでは、 動画のオーディオトラックを再生するのに必要ないメソッドの利用は制限されています。 詳細は、各メソッドの説明を参照して下さい。 特に、動画のオーディオトラックは MediaMovie オブジェクトであるため、 setSound(MediaMovie) メソッドにて設定する必要があることに注意して下さい。

AudioPresenter.getAudioTrackPresenter() に書かれているように、 動画のオーディオトラック同士の並列再生は出来ません。

このプレゼンタと AudioPresenter を並列再生しようとした場合は、 このプレゼンタがポート指定がなく AudioPresenter.MAX_PRIORITY が指定されているかのように振る舞います。
ただし、このプレゼンタと AudioPresenter の同時再生をサポートしているかどうかは機種依存です。 サポートしていない場合は、同時再生可能数が 1 であるとみなします。
また、サポートしている場合の同時再生可能数も機種依存です。 このプレゼンタによる再生中においては、 同時再生可能数が AudioPresenter クラスに記述されているミニマムスペック未満となる場合も有り得ます。

導入されたバージョン:

Star-1.0

フィールドの概要

クラス com.docomostar.ui.AudioPresenter から継承したフィールド

ATTR_SYNC_OFF, ATTR_SYNC_ON, AUDIO_COMPLETE, AUDIO_LOOPED, AUDIO_PAUSED, AUDIO_PLAYING, AUDIO_RESTARTED, AUDIO_STOPPED, AUDIO_SYNC, CHANGE_TEMPO, LOOP_COUNT, MAX_OPTION_ATTR, MAX_PRIORITY, MAX_VENDOR_ATTR, MAX_VENDOR_AUDIO_EVENT, MIN_OPTION_ATTR, MIN_PRIORITY, MIN_VENDOR_ATTR, MIN_VENDOR_AUDIO_EVENT, NORM_PRIORITY, PRIORITY, SET_VOLUME, SYNC_MODE, TRANSPOSE_KEY

コンストラクタの概要

protected

AudioTrackPresenter() アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの概要

Audio3D	getAudio3D() このクラスのインスタンスに対して呼び出すことはできません。
int	getCurrentTime() 曲頭からの演奏時間をms単位で返します。
int	getTotalTime() 曲全体の演奏時間をms単位で返します。
void	pause() 動画のオーディオトラックの再生を一時停止します。
void	play() 曲頭から、動画のオーディオトラックの再生を開始します。
void	play(int time) 再生開始位置を指定して、動画のオーディオトラックの再生を開始します。
void	restart() 動画のオーディオトラックの再生を再開します。
void	setAttribute(int attr, int value) 再生方法に関する属性値を設定します。
void	setSound(MediaMovie sound) オーディオトラックのみで構成されたメディアムービーをセットします。
void	setSound(MediaSound sound) このクラスのインスタンスに対して呼び出すことはできません。
void	setSyncEvent(int channel, int key) このクラスのインスタンスに対して呼び出すことはできません。

クラス com.docomostar.ui.AudioPresenter から継承したメソッド

getAudioPresenter, getAudioPresenter, getAudioTrackPresenter, getMediaResource, setMediaListener, stop

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

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

コンストラクタの詳細

AudioTrackPresenter

protected AudioTrackPresenter()

アプリケーションが直接このクラスのインスタンスを生成することはできません。

メソッドの詳細

play

public void play()

曲頭から、動画のオーディオトラックの再生を開始します。

play(0) を呼び出したのと同じ振る舞いをします。

定義:

インタフェース MediaPresenter 内の play

オーバーライド:

クラス AudioPresenter 内の play

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。

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

UIException -
(NO_RESOURCES)
オーディオ再生のためのリソースが確保できない場合に発生します。

UIException -
(ILLEGAL_STATE)
ネイティブ側で再生開始に失敗した場合に発生します。

UIException -
(BUSY_RESOURCE)
音声・テレビ電話通話中に呼び出された場合に発生します。

UIException -
(BUSY_RESOURCE)
PTT 呼通信中の場合に発生します。

play

public void play(int time)

再生開始位置を指定して、動画のオーディオトラックの再生を開始します。 このメソッドが呼ばれた時にオーディオ再生のためのリソース確保を行います。

データを最後まで再生したら自動的に停止します。 再生中に play() メソッドが呼ばれた場合は、 再生を停止して再び先頭から再生を開始します。

リスナが登録されている場合には、このメソッドにより再生が開始された時に、 イベントタイプ AudioPresenter.AUDIO_PLAYING でリスナが起動され、 最後まで再生が完了すると、AudioPresenter.AUDIO_COMPLETE でリスナが起動されます。

一時停止や停止せずに曲頭から再生した場合に、 指定した経過時間がかかるポイントから再生を開始します。
動画のオーディオトラックの再生時間の長さ以上の値を引数 time に指定した時は、 イベントタイプ AudioPresenter.AUDIO_PLAYING でリスナが起動された後、 即座に、AudioPresenter.AUDIO_COMPLETE でリスナが起動されます。

オーバーライド:

クラス AudioPresenter 内の play

パラメータ:

time - 再生を開始する位置を、 動画のオーディオトラックの先頭からのミリ秒で指定します。 0 を指定すると曲頭からの再生となります。

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

IllegalArgumentException -
引数 time に 0 未満の値が指定された場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。

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

UIException -
(NO_RESOURCES)
オーディオ再生のためのリソースが確保できない場合に発生します。

UIException -
(ILLEGAL_STATE)
ネイティブ側で再生開始に失敗した場合に発生します。

UIException -
(BUSY_RESOURCE)
音声・テレビ電話通話中に呼び出された場合に発生します。

UIException -
(BUSY_RESOURCE)
PTT 呼通信中の場合に発生します。

setAttribute

public void setAttribute(int attr,
                         int value)

再生方法に関する属性値を設定します。 動作の詳細は、スーパークラスの同名メソッドの説明を参照して下さい。 ただし、スーパークラスと異なり、属性のサポート状況は以下の通りです。

制御可能なもの:

• AudioPresenter.SET_VOLUME

制御不可能なもの:

• AudioPresenter.CHANGE_TEMPO
• AudioPresenter.PRIORITY
• AudioPresenter.SYNC_MODE
• AudioPresenter.TRANSPOSE_KEY

制御可能かどうか機種依存なもの:

• AudioPresenter.LOOP_COUNT

定義:

インタフェース MediaPresenter 内の setAttribute

オーバーライド:

クラス AudioPresenter 内の setAttribute

パラメータ:

attr - 設定する属性を指定します。

value - 設定する属性の値を指定します。

例外:

IllegalArgumentException -
引数 attr で指定された有効な属性に対して、 引数 value に不正な値が指定された場合に発生します。

setSyncEvent

public void setSyncEvent(int channel,
                         int key)

このクラスのインスタンスに対して呼び出すことはできません。 このメソッドを呼び出すと、 常に UnsupportedOperationException 例外が発生します。

オーバーライド:

クラス AudioPresenter 内の setSyncEvent

パラメータ:

channel - 指定に意味を持ちません。

key - 指定に意味を持ちません。

例外:

UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。

setSound

public void setSound(MediaMovie sound)

オーディオトラックのみで構成されたメディアムービーをセットします。

指定したメディアムービーが以下のような場合には例外 MediaException(UNSUPPORTED_FORMAT) が発生します。

• 動画にオーディオトラック以外が含まれている場合
• 動画のオーディオトラックが再生不可能な場合
• その他、再生が禁止されている場合

パラメータ:

sound - 動画のオーディオトラックを表すメディアムービーを指定します。

例外:

UIException -
(ILLEGAL_STATE)
再生中にこのメソッドを呼び出そうとした場合に発生します。

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

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

MediaException -
(ILLEGAL_STATE)
セットされたメディアムービーが use() されていない場合に発生します。

MediaException -
(UNSUPPORTED_FORMAT)
引数 sound に端末が再生できないようなメディアムービーが指定された場合に発生します。

setSound

public void setSound(MediaSound sound)

このクラスのインスタンスに対して呼び出すことはできません。 このメソッドを呼び出すと、 常に UnsupportedOperationException 例外が発生します。

オーバーライド:

クラス AudioPresenter 内の setSound

パラメータ:

sound - 指定に意味を持ちません。

例外:

UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。

getAudio3D

public Audio3D getAudio3D()

このクラスのインスタンスに対して呼び出すことはできません。 このメソッドを呼び出すと、 常に UnsupportedOperationException 例外が発生します。

オーバーライド:

クラス AudioPresenter 内の getAudio3D

戻り値:

常に例外が発生するため、戻り値が返ることはありません。

例外:

UnsupportedOperationException -
このメソッドが呼ばれた場合に発生します。

pause

public void pause()

動画のオーディオトラックの再生を一時停止します。 データの再生が一時停止された時にリスナが登録されていた場合、 イベントタイプ AudioPresenter.AUDIO_PAUSED でリスナが起動されます。 再生を再開するには restart() メソッドを使用します。

停止している時に pause() メソッドが呼ばれた場合、 何もしません。

オーバーライド:

クラス AudioPresenter 内の pause

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。

restart

public void restart()

動画のオーディオトラックの再生を再開します。 データの再生が再開された時にリスナが登録されていた場合、 イベントタイプ AudioPresenter.AUDIO_RESTARTED でリスナが起動されます。 再生が pause() メソッドによって一時停止されている時以外は何もしません。

停止している時に restart() メソッドが呼ばれた場合、 何もしません。

オーバーライド:

クラス AudioPresenter 内の restart

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。

UIException -
(NO_RESOURCES)
オーディオ再生のためのリソースが確保できない場合に発生します。

UIException -
(ILLEGAL_STATE)
ネイティブ側で再生開始に失敗した場合に発生します。

getCurrentTime

public int getCurrentTime()

曲頭からの演奏時間をms単位で返します。

このメソッドが呼ばれた時点で再生しているポイントの、 動画のオーディオトラックの曲頭からの時間を返します。 すなわち、動画のオーディオトラックを一時停止や停止せずに再生した場合に、 曲の先頭からそのポイントに到達するまでにかかる経過時間を返します。

オーバーライド:

クラス AudioPresenter 内の getCurrentTime

戻り値:

曲頭からの演奏時間を返します。

関連項目:

AudioPresenter.getTotalTime()

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。

getTotalTime

public int getTotalTime()

曲全体の演奏時間をms単位で返します。

動画のオーディオトラックを一時停止や停止せずに再生した場合に、 曲の先頭から曲の末尾に到達するまでにかかる経過時間を返します。

オーバーライド:

クラス AudioPresenter 内の getTotalTime

戻り値:

曲全体の演奏時間を返します。

関連項目:

AudioPresenter.getCurrentTime()

例外:

UIException -
(ILLEGAL_STATE)
動画のオーディオトラックがセットされていない場合に発生します。

MediaException -
(ILLEGAL_STATE)
動画のオーディオトラックが use() されていない場合に発生します。