目次 - SDL_mixer - API(機能別) - チャネル - Mix_PlayChannelTimed

Mix_PlayChannelTimed

指定のチャネルのチャンクを時間を指定して再生する

構文

int Mix_PlayChannelTimed(int channel, Mix_Chunk *chunk, int loops)

引数

channel新しくチャンクを再生するチャネル
chunk再生する新しいチャンク
loops再生のループ回数. -1のとき無限
tickチャンクのミリ秒の最大再生時間

戻り値

指定のチャネルで再生した回数を戻す. 再生されなかったとき-1を戻す.

詳細

channelに-1を指定すると, 空いている最初のチャネルで再生する. (そして空いているチャネルがなく再生できなかった場合は-1を戻す.)

チャネルを指定して, かつそのチャネルでチャンクが再生中の場合は, 現在のチャンクは停止され新しいチャンクに置き換えられる.

loopに0以上の数を指定すると, その回数だけ再生する. loopが-1の場合, 「無限」(65000回)再生する.

ticksにはチャンクの停止までの最大再生時間を指定する. チャンクの全時間をミックスしたい場合は-1を指定すること.

この関数はticksで設定した時間ブロックされないので注意すること. チャンクの停止までの時間を設定して, ミキサーの後の管理のために時間を記録し, すぐに復帰する.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_PlayChannelTimed