com.jblend.media.smaf.phrase
クラス PhrasePlayer

java.lang.Object
  |
  +--com.jblend.media.smaf.phrase.PhrasePlayer

public class PhrasePlayer
extends java.lang.Object

PhrasePlayerクラスは、端末の音源内に構成可能な「仮想音源」トラックまたは「オーディオデコーダ」を管理します。Javaアプリケーションの要求に応じてこれらを割り当てたり、また使用済みになったときに開放するための機能を定義します。

PhrasePlayerの生成

PhrasePlayerオブジェクトは、PhrasePlayerのスタティックメソッドgetPlayer()で取得してください。

getTrackCount()メソッドで、使用可能なトラックの数が取得できます。0からgetTrackCount()で取得される数値より1小さい値までが、有効なトラック番号となります。また、getAudioTrackCount()メソッドで、使用可能なオーディオデコーダの数が取得できます。0からgetAudioTrackCount()で取得される数値より1小さい値までが、有効なオーディオデコーダ番号となります。

再生用資源の取得

Javaアプリケーションは、getTrack()メソッドを使用してPhraseTrackオブジェクトを取得する必要があります。getTrack()はトラック番号を明示的に指定するgetTrack(int track)と、PhrasePlayerにトラック番号の割り当てを任せるgetTrack()の2つが用意されています。トラック番号を明示的に指定したときに既にトラックが割り当てられている場合、またPhrasePlayerに割り当てを任せたときに空きトラックが無い場合は例外がスローされます。取得したPhraseTrackオブジェクトで個々のフレーズデータを再生できます。

同様に、オーディオデータを再生するためには、getAudioTrack()、またはgetAudioTrack(int track)メソッドを使用してAudioPhraseTrackオブジェクトを取得する必要があります。getAudioTrack()での例外の発生条件などはgetTrack()の場合と同様です。

PhraseTrack、AudioPhraseTrackの一斉制御

PhrasePlayerクラスでは、すべてのPhraseTrackオブジェクトおよびAudioPhraseTrackオブジェクトが再生しているデータに対して、同時に強制停止、一時停止、または再開したりするメソッドが用意されています。強制停止はkill()メソッド、一時停止はpause()メソッド、再開はresume()メソッドで行います。


フィールドの概要
protected  int audioTrackCount
          最大使用できるオーディオトラック数
protected  int trackCount
          最大使用できるトラック数
 
メソッドの概要
 void disposeAudioTrack(AudioPhraseTrack t)
          使用済みオーディオトラックをプレイヤーに返す。
 void disposePlayer()
          プレイヤーを破棄する。
 void disposeTrack(PhraseTrack t)
          使用済みトラックをプレイヤーに返す。
 AudioPhraseTrack getAudioTrack()
          空いているオーディオトラックを取得する。
 AudioPhraseTrack getAudioTrack(int track)
          指定したオーディオトラックを取得する。
 int getAudioTrackCount()
          オーディオトラックの数を取得する。
static PhrasePlayer getPlayer()
          プレイヤーを取得する。
 PhraseTrack getTrack()
          空いているトラックを取得する。
 PhraseTrack getTrack(int track)
          指定したトラックを取得する。
 int getTrackCount()
          トラックの数を取得する。
 void kill()
          すべてのトラックの再生を強制終了してフレーズ未設定状態にする。
 void pause()
          すべてのトラックの再生を中断する。
 void resume()
          すべてのトラックの再生を再開する。
 
クラス java.lang.Object から継承したメソッド
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

trackCount

protected int trackCount
最大使用できるトラック数

audioTrackCount

protected int audioTrackCount
最大使用できるオーディオトラック数
メソッドの詳細

getPlayer

public static PhrasePlayer getPlayer()
プレイヤーを取得する。
戻り値:
PhrasePlayer - プレイヤー
例外:
java.lang.RuntimeException - Nativeフレーズモードに設定できなかった場合に発生します。

disposePlayer

public void disposePlayer()
プレイヤーを破棄する。

getTrack

public PhraseTrack getTrack()
空いているトラックを取得する。 トラック番号が大きいものから取得される。
戻り値:
PhraseTrack - トラック
例外:
IllegalStateException - 空きトラックがない場合に発生します。

getAudioTrack

public AudioPhraseTrack getAudioTrack()
空いているオーディオトラックを取得する。
戻り値:
AudioPhraseTrack - トラック
例外:
IllegalStateException - 空きトラックがない場合に発生します。

getTrackCount

public int getTrackCount()
トラックの数を取得する。
戻り値:
int - トラック数

getAudioTrackCount

public int getAudioTrackCount()
オーディオトラックの数を取得する。
戻り値:
int - トラック数

getTrack

public PhraseTrack getTrack(int track)
指定したトラックを取得する。
パラメータ:
track - トラック番号
戻り値:
PhraseTrack - トラック
例外:
IllegalStateException - 指定したトラックが使用中の場合に発生します。

getAudioTrack

public AudioPhraseTrack getAudioTrack(int track)
指定したオーディオトラックを取得する。
パラメータ:
track - トラック番号
戻り値:
AudioPhraseTrack - トラック
例外:
IllegalStateException - 指定したトラックが使用中の場合に発生します。

disposeTrack

public void disposeTrack(PhraseTrack t)
使用済みトラックをプレイヤーに返す。
パラメータ:
t - : 使用済みトラック
例外:
NullPointerException - 指定したトラックが null の場合に発生します。

disposeAudioTrack

public void disposeAudioTrack(AudioPhraseTrack t)
使用済みオーディオトラックをプレイヤーに返す。
パラメータ:
t - : 使用済みトラック
例外:
NullPointerException - 指定したトラックが null の場合に発生します。

kill

public void kill()
すべてのトラックの再生を強制終了してフレーズ未設定状態にする。

pause

public void pause()
すべてのトラックの再生を中断する。

resume

public void resume()
すべてのトラックの再生を再開する。