目次 - SDL_mixer - API(機能別) - 音楽 - Mix_HookMusicFinished

Mix_HookMusicFinished

音楽オブジェクトの再生が停止したとき実行されるコールバックを設定する

構文

void Mix_HookMusicFinished(void (SDLCALL *music_finished)(void))

引数

music_finished停止を処理する新しいコールバック関数

詳細

このコールバックは, 現在の音楽再生が完了したとき, またはMix_HaltMusic()を呼んで停止したとき呼ばれる. コールバックは不特定のバックグラウンドスレッドからいつでも呼ばれる可能性があり, ここで行えることには限りがある.

このコールバックで新しい音楽オブジェクトの再生を開始する(または停止した音楽を再び再生する)のは正しい処理で, 再生が正常に完了した音楽を間を空けることなくループさせるために使用できる.

このコールバックでSDL_LockAudio()を呼んではならない. オーディオコールバックの中にあるか, SDL_mixerがコールバックを呼ぶ前にオーディオをロックしている.

NULLポインタの場合, コールバックは無効になる.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_HookMusicFinished