audio_play_sound_on()

Game Maker Language リファレンス > 組み込み関数 用途別 > サウンド > audio_play_sound_on

audio_play_sound_on †

指定のエミッタを通してサウンドを再生します

構文 †

audio_play_sound_on(emitter, sound, loop, priority);

emitter

エミッタのインデックス番号

sound

サウンド番号

loop

ループフラグ

priority

再生優先度

戻り値 †

Index

サウンド再生番号

説明 †

この関数を使用すると、エミッタを介して任意のサウンドリソースを再生することができます。 エミッタに指定した音量、座標、ピッチや速度によって、最終的に出力されるサウンドが決定されます。 "loop"にはサウンドをループさせるかどうかを指定します。 "priority"はaudio_channel_num()の最大数を超えたサウンドが再生された時に使用されます。優先度が低い音は、優先度が高い音が再生されると停止します。優先度は0〜1の実数、または0〜100の整数値を指定することが可能です。

この関数の戻り値は、一時停止や停止などをするためのサウンド再生番号を返却します。これにより、同じサウンドリソースから複数のサウンドインスタンスが生成されていても、指定のインスタンスのみ操作できるようになります

例 †

if global.SFX
{
  audio_play_sound_on(s_emit, snd_Explode, false, 1);
}

上記コードは、グローバル変数"SFX"が有効であれば、サウンド"snd_Explode"をエミッタ"s_emit"を通して再生を行います