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

Mix_PlayMusic

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

構文

int Mix_PlayMusic(Mix_Music *music, int loops)

引数

music新しく再生する音楽オブジェクト
loops再生のループ回数. (0は「1回再生して停止する」を意味する)

戻り値

成功のとき0, エラーのとき-1を戻す.

詳細

この関数は音楽オブジェクトを再生するためのミキシングを準備する.

一度に1つの音楽オブジェクトのみ再生できる. 別の音楽オブジェクトの再生中にこの関数を呼んだ場合, 現在再生中の音楽は停止し, 新しい音楽に置き換えられる.

現在再生中の音楽が(Mix_FadeOutMusic()で)フェードアウト中の場合, この関数はフェードが完了するまでブロックするので注意すること. これを避けるためには, 新しい音楽を開始する前にMix_HaltMusic()を呼ぶこと.

バージョン

SDL_mixer 2.0.0以降

SDL Wikiへのリンク

SDL2_mixer/Mix_PlayMusic