int Mix_PlayChannel(int channel, Mix_Chunk *chunk, int loops)
channel | 新しくチャンクを再生するチャネル |
chunk | 再生する新しいチャンク |
loops | 再生のループ回数. -1のとき無限 |
channelに-1を指定すると, 空いている最初のチャネルで再生する. (そして空いているチャネルがなく再生できなかった場合は-1を戻す.)
チャネルを指定して, かつそのチャネルでチャンクが再生中の場合は, 現在のチャンクは停止され新しいチャンクに置き換えられる.
loopに0以上の数を指定すると, その回数だけ再生する. loopが-1の場合, 「無限」(65000回)再生する.
SDL_mixer 2.6.0以前は, この関数はMix_PlayChannelTimed()の第4引数(ticks)を-1としたマクロだった. この関数は以前と同じ動作をするが, 正式なAPI関数となった. 古いバイナリに新しいSDL_mixerをリンクしても以前と同じようにMix_PlayChannelTimed()が呼ばれるため今まで通り正常に動作する.