com.jblend.media.smaf
クラス SmafPlayer　＜Phase2.5＞

java.lang.Object
  |
  +--com.jblend.media.MediaPlayer
        |
        +--com.jblend.media.smaf.SmafPlayer

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

MediaImageOperator

public class SmafPlayer

extends MediaPlayer

implements MediaImageOperator

SMAF形式のメディアを再生するためのクラスです。

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

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

コンストラクタの概要

SmafPlayer()
SmafPlayer コンストラクタです。

SmafPlayer(byte[] data)
SmafPlayerコンストラクタです。

SmafPlayer(SmafData data)
SmafPlayerコンストラクタです。

メソッドの概要

void	addMediaPlayerListener(MediaPlayerListener l) MediaPlayerListenerを登録します。
void	addSmafPlayerListener(SmafPlayerListener l) SmafPlayerListenerを登録します。
int	getCurrent() 現在の再生位置を返します。
int	getHeight() プレイヤーの高さを返します。
int	getMediaHeight() メディアの描画高さを返します。
int	getMediaWidth() メディアの描画幅を返します。
int	getOriginX() 画像切り出し開始点の X 座標値を返します。
int	getOriginY() 画像切り出し開始点の Y 座標値を返します。
int	getPlayEnd() 再生区間の最後を返します。
int	getState() プレイヤーの状態を返します。
int	getTranspose() 現在の音高シフト量を返します。
int	getVolume() 現在の再生音量を返します。
int	getWidth() プレイヤーの幅を返します。
int	getX() プレイヤーの表示 X 座標値を返します。
int	getY() プレイヤーの表示 Y 座標値を返します。
void	pause() 一時停止します。
void	play() 再生します。
void	play(boolean isRepeat) 繰り返し指定つきで再生します。
void	play(int count) 繰り返し再生します。
void	removeMediaPlayerListener(MediaPlayerListener l) MediaPlayerListenerの登録を解除します。
void	removeSmafPlayerListener(SmafPlayerListener l) SmafPlayerListenerの登録を解除します。
void	resume() 再開します。
void	seek(int time) 再生位置を移動します。
void	setBounds(int x, int y, int width, int height) プレイヤーの表示位置を設定します。
void	setData(MediaData data) データを設定します。
void	setData(SmafData data) 再生するデータを設定します。
void	setOrigin(int offset_x, int offset_y) 画像切り出し開始点を設定します。
void	setPlayEnd(int pos) 再生終了時刻を設定します。
void	setTranspose(int shift) 再生音高をシフトします。
void	setVolume(int volume) 再生音量を設定します。
void	stop() 停止します。

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

addNativeMediaEventDispatcher

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

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

コンストラクタの詳細

SmafPlayer

public SmafPlayer()

SmafPlayer コンストラクタです。
デフォルトのサイズは 0,0 になります。

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

SmafPlayer

public SmafPlayer(SmafData data)

SmafPlayerコンストラクタです。
デフォルトのサイズはデータのサイズになります。

パラメータ:

data - 再生するデータ

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

SmafPlayer

public SmafPlayer(byte[] data)

SmafPlayerコンストラクタです。
デフォルトのサイズはデータのサイズになります。

パラメータ:

data - 再生するデータ

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

メソッドの詳細

setData

public void setData(SmafData data)

再生するデータを設定します。
表示サイズは変わりません。

パラメータ:

data - 新しいデータ

例外:

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

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

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

setData

public void setData(MediaData data)

データを設定します。

オーバーライド:

クラス MediaPlayer 内の setData

パラメータ:

data - 再生するデータ

例外:

NullPointerException - dataがnullの場合に発生する

java.lang.IllegalArgumentException - データがSmafDataではない場合に発生する

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

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

getCurrent

public int getCurrent()

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

戻り値:

int - 再生位置

例外:

IllegalStateException - データが未設定の場合に発生する

seek

public void seek(int time)

再生位置を移動します。
テンポ変更のない元データの絶対時刻を指定してください。

パラメータ:

time - 時刻(単位はミリ秒)

例外:

IllegalStateException - データが再生待機中ではない場合に発生するす。

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

setTranspose

public void setTranspose(int shift)

再生音高をシフトします。
単位は半音で、設定範囲は-12 - +12。

パラメータ:

value - シフト量

例外:

java.lang.IllegalArgumentException - 設定可能な範囲を超えている場合に発生する

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

getTranspose

public int getTranspose()

現在の音高シフト量を返します。

戻り値:

int - 現在のシフト量

getVolume

public int getVolume()

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

戻り値:

int - 音量

setVolume

public void setVolume(int volume)

再生音量を設定します。

パラメータ:

volume - 新しい音量(0 - 127)

例外:

java.lang.IllegalArgumentException - 値が有効な範囲を超えている場合に発生する

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

setPlayEnd

public void setPlayEnd(int pos)

再生終了時刻を設定します。
負の値もしくは再生時間よりも大きな値を指定されたときは最後が指定されたことにします。

パラメータ:

pos - 終了位置（単位はミリ秒）

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

getPlayEnd

public int getPlayEnd()

再生区間の最後を返します。

戻り値:

int 再生終了位置（単位はミリ秒）。-1 のときは最後。

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)

プレイヤーの表示位置を設定します。
デフォルトでは( 0, 0 )となっています。
画像つき SMAF の場合、プレイヤーのサイズは画面サイズとなります。 ただし、( 0, 0 )が指定されている場合には描画されません。

定義:

インタフェース MediaImageOperator 内の setBounds

パラメータ:

x - X 座標値

y - Y 座標値

width - 幅（無効）

height - 高さ（無効）

例外:

java.lang.IllegalArgumentException - 幅、高さが負の場合に発生する

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

addSmafPlayerListener

public void addSmafPlayerListener(SmafPlayerListener l)

SmafPlayerListenerを登録します。

パラメータ:

l - SmafPlayerListener

removeSmafPlayerListener

public void removeSmafPlayerListener(SmafPlayerListener l)

SmafPlayerListenerの登録を解除します。

パラメータ:

l - SmafPlayerListener

getX

public int getX()

プレイヤーの表示 X 座標値を返します。

定義:

インタフェース MediaImageOperator 内の getX

戻り値:

int - 表示 X 座標値

getY

public int getY()

プレイヤーの表示 Y 座標値を返します。

定義:

インタフェース MediaImageOperator 内の getY

戻り値:

int - 表示 Y 座標値

getWidth

public int getWidth()

プレイヤーの幅を返します。
データが設定されていない状態では 0 を返します。

定義:

インタフェース MediaImageOperator 内の getWidth

戻り値:

int - プレイヤーの幅

getHeight

public int getHeight()

プレイヤーの高さを返します。
データが設定されていない状態では 0 を返します。

定義:

インタフェース MediaImageOperator 内の getHeight

戻り値:

int - プレイヤーの高さ

getOriginX

public int getOriginX()

画像切り出し開始点の X 座標値を返します。

定義:

インタフェース MediaImageOperator 内の getOriginX

戻り値:

int - X軸方向のオフセット値

getOriginY

public int getOriginY()

画像切り出し開始点の Y 座標値を返します。

定義:

インタフェース MediaImageOperator 内の getOriginY

戻り値:

int - Y軸方向のオフセット値

setOrigin

public void setOrigin(int offset_x,
                      int offset_y)

画像切り出し開始点を設定します。

定義:

インタフェース MediaImageOperator 内の setOrigin

パラメータ:

offset_x - X 軸方向のオフセット値

offset_y - Y 軸方向のオフセット値

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

getMediaWidth

public int getMediaWidth()

メディアの描画幅を返します。

定義:

インタフェース MediaImageOperator 内の getMediaWidth

戻り値:

int - 描画幅

例外:

IllegalStateException - データが未設定の場合に発生する

getMediaHeight

public int getMediaHeight()

メディアの描画高さを返します。

定義:

インタフェース MediaImageOperator 内の getMediaHeight

戻り値:

int - 描画高さ

例外:

IllegalStateException - データが未設定の場合に発生する

play

public void play()

再生します。

オーバーライド:

クラス MediaPlayer 内の play

例外:

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

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

play

public void play(boolean isRepeat)

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

オーバーライド:

クラス MediaPlayer 内の play

パラメータ:

isRepeat - 繰り返しの有無

例外:

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

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

play

public void play(int count)

繰り返し再生します。

オーバーライド:

クラス MediaPlayer 内の play

パラメータ:

count - 繰り返し回数(1 - 255)

例外:

java.lang.IllegalArgumentException - 再生回数が有効範囲を超えた場合に発生する

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

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

stop

public void stop()

停止します。
次にplayした場合、先頭から再生されます。

オーバーライド:

クラス MediaPlayer 内の stop

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

pause

public void pause()

一時停止します。

オーバーライド:

クラス MediaPlayer 内の pause

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生する

resume

public void resume()

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

オーバーライド:

クラス MediaPlayer 内の resume

例外:

java.lang.RuntimeException - ネイティブ SMAF プレイヤーにエラーが発生した場合に発生します。

getState

public int getState()

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

オーバーライド:

クラス MediaPlayer 内の getState

戻り値:

int - 現在の状態

addMediaPlayerListener

public void addMediaPlayerListener(MediaPlayerListener l)

MediaPlayerListenerを登録します。

オーバーライド:

クラス MediaPlayer 内の addMediaPlayerListener

パラメータ:

l - MediaPlayerListener

removeMediaPlayerListener

public void removeMediaPlayerListener(MediaPlayerListener l)

MediaPlayerListenerの登録を解除します。

オーバーライド:

クラス MediaPlayer 内の removeMediaPlayerListener

パラメータ:

l - MediaPlayerListener