com.jblend.media.hvscript
クラス HVscriptPlayer　＜Phase3＞

java.lang.Object
  |
  +--com.jblend.media.MediaPlayer
        |
        +--com.jblend.media.hvscript.HVscriptPlayer

public class HVscriptPlayer

extends MediaPlayer

HV script 用プレイヤーの機能を提供するクラスです。

HV script プレイヤーを使用する際は、以下の点に注意してください。 ・seek 機能がありません。 ・HV script 再生中に、着信などの理由により Java VM が一時停止しその後 VM の実行が 再開したときでも、HV script のプレイヤーは停止されたまま再開されません。

クラス com.jblend.media.MediaPlayer から継承したフィールド

ERROR, NO_DATA, PAUSED, PLAYING, READY, REAL_HEIGHT, REAL_WIDTH

コンストラクタの概要

HVscriptPlayer()
HV script 用プレイヤーを生成します。

HVscriptPlayer(byte[] data)
HV script 用プレイヤーを生成します。

HVscriptPlayer(HVscriptData data)
HV script 用プレイヤーを生成します。

メソッドの概要

void	addHVscriptPlayerListener(HVscriptPlayerListener l) HV-scriptユーザーイベントを待ち受けるリスナを登録します。
void	addMediaPlayerListener(MediaPlayerListener l) HV-script用プレイヤーの状態変化を知るためのリスナを登録します。
int	getCurrent() 現在の再生位置を返します。
int	getPanpot() 現在のパンポットを返します。
int	getPitch() 現在の再生ピッチ（キー）を返します。
int	getState() プレイヤーの状態を返します。
int	getVolume() 現在の再生音量を返します。
void	pause() 再生を一時停止します。
void	play() 再生します。
void	play(boolean isRepeat) 繰り返し指定つきで再生します。
void	play(int count) 指定された回数だけ繰り返し再生します。
void	registerTone(int userNo, byte[] prm) 指定されたユーザー音色番号に音色パラメータを登録します。
void	registerTones(byte[] prms) ユーザー音色パラメータをまとめて登録します。
void	removeHVscriptPlayerListener(HVscriptPlayerListener l) HV-scriptユーザーイベントを待ち受けるリスナの登録を解除します。
void	removeMediaPlayerListener(MediaPlayerListener l) HV-script用プレイヤーの状態変化を知るためのリスナの登録を解除します。
void	resume() 一時停止中の再生を再開します。
void	setData(HVscriptData data) 再生するデータを設定します。
void	setData(MediaData data) 再生するデータを設定します。
void	setPanpot(int panpot) パンポットを設定します。
void	setPitch(int pitch) 再生ピッチ（キー）を設定します。
void	setTone(boolean isUser, int no) 音色を切り替えます。
void	setVolume(int volume) 再生音量を設定します。
void	stop() 再生を停止します。

クラス com.jblend.media.MediaPlayer から継承したメソッド

addNativeMediaEventDispatcher

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

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

コンストラクタの詳細

HVscriptPlayer

public HVscriptPlayer()

HV script 用プレイヤーを生成します。

例外:

MediaNotSupportedException - 移動機システムが HV script 再生に対応していない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

HVscriptPlayer

public HVscriptPlayer(HVscriptData data)

HV script 用プレイヤーを生成します。

パラメータ:

data - 再生するデータ

例外:

MediaNotSupportedException - 移動機システムが HV script 再生に対応していない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

HVscriptPlayer

public HVscriptPlayer(byte[] data)

HV script 用プレイヤーを生成します。

パラメータ:

data - 再生するデータ

例外:

MediaNotSupportedException - 移動機システムが HV script 再生に対応していない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

メソッドの詳細

setData

public void setData(HVscriptData data)

再生するデータを設定します。

パラメータ:

data - 再生するデータ

例外:

NullPointerException - 引数 data に null が指定された場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.PLAYING または MediaPlayer.PAUSED の場合に発生する

setData

public void setData(MediaData data)

再生するデータを設定します。

オーバーライド:

クラス MediaPlayer 内の setData

パラメータ:

data - 再生するデータ

例外:

NullPointerException - 引数 data に null が指定された場合に発生する

java.lang.IllegalArgumentException - 指定されたデータが HVscriptData ではない場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.PLAYING または MediaPlayer.PAUSED の場合に発生する

getCurrent

public int getCurrent()

現在の再生位置を返します。

戻り値:

int - 再生位置

getVolume

public int getVolume()

現在の再生音量を返します。

戻り値:

int - 音量

setVolume

public void setVolume(int volume)

再生音量を設定します。

パラメータ:

volume - 音量。範囲は 0 〜 127。

例外:

java.lang.IllegalArgumentException - 指定された音量が範囲外の場合に発生する

java.lang.RuntimeException - 移動機システムの HVscript プレイヤーにエラーが生じた場合に発生する

play

public void play()

再生します。

オーバーライド:

クラス MediaPlayer 内の play

例外:

IllegalStateException - プレイヤーの状態が MediaPlayer.READY ではない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

play

public void play(boolean isRepeat)

繰り返し指定つきで再生します。

オーバーライド:

クラス MediaPlayer 内の play

パラメータ:

isRepeat - 繰り返す場合は true、繰り返さない場合は false

例外:

IllegalStateException - プレイヤーの状態が MediaPlayer.READY ではない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

play

public void play(int count)

指定された回数だけ繰り返し再生します。

オーバーライド:

クラス MediaPlayer 内の play

パラメータ:

count - 繰り返し回数。範囲は 1 〜 255。

例外:

java.lang.IllegalArgumentException - 範囲外の繰り返し回数が指定された場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.READY ではない場合に発生する

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

stop

public void stop()

再生を停止します。 次に play() を呼び出した場合、先頭から再生されます。

オーバーライド:

クラス MediaPlayer 内の stop

例外:

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

pause

public void pause()

再生を一時停止します。

オーバーライド:

クラス MediaPlayer 内の pause

例外:

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

resume

public void resume()

一時停止中の再生を再開します。 一時停止している位置から再開します。

オーバーライド:

クラス MediaPlayer 内の resume

例外:

java.lang.RuntimeException - 移動機システムの HV script プレイヤーにエラーが生じた場合に発生する

getState

public int getState()

プレイヤーの状態を返します。

オーバーライド:

クラス MediaPlayer 内の getState

戻り値:

int - 現在の状態として以下のどれかを返す

• MediaPlayer.NO_DATA ： 再生データなし
• MediaPlayer.READY ： 再生可能な状態
• MediaPlayer.PLAYING ： 再生中
• MediaPlayer.PAUSED ： 一時停止中
• MediaPlayer.ERROR ： エラー停止中

addMediaPlayerListener

public void addMediaPlayerListener(MediaPlayerListener l)

HV-script用プレイヤーの状態変化を知るためのリスナを登録します。

オーバーライド:

クラス MediaPlayer 内の addMediaPlayerListener

パラメータ:

l - HV-script用プレイヤーの状態変化を知るためのリスナ

removeMediaPlayerListener

public void removeMediaPlayerListener(MediaPlayerListener l)

HV-script用プレイヤーの状態変化を知るためのリスナの登録を解除します。

オーバーライド:

クラス MediaPlayer 内の removeMediaPlayerListener

パラメータ:

l - HV-script用プレイヤーの状態変化を知るためのリスナ

setTone

public void setTone(boolean isUser,
                    int no)

音色を切り替えます。

パラメータ:

isUser - ユーザー設定音色の場合は true、プリセット音色の場合は false

no - 音色番号

例外:

java.lang.IllegalArgumentException - - 音色番号が設定外の場合、設定に失敗した場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.READY でも MediaPlayer.NO_DATA でもない場合に発生する

setPitch

public void setPitch(int pitch)

再生ピッチ（キー）を設定します。

パラメータ:

pitch - 再生ピッチ（キー）。範囲は -12 〜 12。

例外:

java.lang.IllegalArgumentException - - 設定値が範囲外の場合、設定に失敗した場合に発生する

getPitch

public int getPitch()

現在の再生ピッチ（キー）を返します。

戻り値:

int - 再生ピッチ（キー）

setPanpot

public void setPanpot(int panpot)

パンポットを設定します。 指定されたパンポットが 0 の場合は左端を、64 の場合は中央を、 127 の場合は右端を表します。

パラメータ:

panpot - パンポット。範囲は 0 〜127。

例外:

java.lang.IllegalArgumentException - - 設定値が範囲外の場合、設定に失敗した場合に発生する

getPanpot

public int getPanpot()

現在のパンポットを返します。

戻り値:

int - 現在のパンポット

registerTone

public void registerTone(int userNo,
                         byte[] prm)

指定されたユーザー音色番号に音色パラメータを登録します。 パラメータ配列の書式はヤマハ仕様に準じます。

パラメータ:

userNo - ユーザー音色番号

prm - 音色パラメータ

例外:

java.lang.IllegalArgumentException - 音色番号が範囲外、またはパラメータが異常な場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.NO_DATA でも MediaPlayer.READY でもない場合に発生する

registerTones

public void registerTones(byte[] prms)

ユーザー音色パラメータをまとめて登録します。 パラメータ配列の書式はヤマハ仕様に準じます。

パラメータ:

prms - 音色パラメータ

例外:

java.lang.IllegalArgumentException - パラメータが異常な場合に発生する

IllegalStateException - プレイヤーの状態が MediaPlayer.NO_DATA でも MediaPlayer.READY でもない場合に発生する

addHVscriptPlayerListener

public void addHVscriptPlayerListener(HVscriptPlayerListener l)

HV-scriptユーザーイベントを待ち受けるリスナを登録します。

パラメータ:

l - HV-scriptユーザーイベントを待ち受けるリスナ

removeHVscriptPlayerListener

public void removeHVscriptPlayerListener(HVscriptPlayerListener l)

HV-scriptユーザーイベントを待ち受けるリスナの登録を解除します。

パラメータ:

l - HV-scriptユーザーイベントを待ち受けるリスナ