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

Mix_PlayChannel

指定のチャネルのチャンクを再生する

構文

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

引数

channel新しくチャンクを再生するチャネル
chunk再生する新しいチャンク
loops再生のループ回数. -1のとき無限

戻り値

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

詳細

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

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

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

SDL_mixer 2.6.0以前は, この関数はMix_PlayChannelTimed()の第4引数(ticks)を-1としたマクロだった. この関数は以前と同じ動作をするが, 正式なAPI関数となった. 古いバイナリに新しいSDL_mixerをリンクしても以前と同じようにMix_PlayChannelTimed()が呼ばれるため今まで通り正常に動作する.

バージョン

SDL_mixer 2.6.0以降 (マクロ版は2.0.0以降)

SDL Wikiへのリンク

SDL2_mixer/Mix_PlayChannel