audio_play_sound()

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

audio_play_sound †

サウンドを再生します

構文 †

audio_play_sound(index, priority, loop);

index

サウンドのインデックス番号

priority

優先度（0が最も低い)

loop

ループするかどうか

戻り値 †

Real

サウンド再生番号

説明 †

この関数を使用することでサウンドの再生をすることができます。loopにはサウンドをループ再生するかどうか、priorityには音の優先度を割り当てます。 この優先度は、関数audio_channel_num()で設定された制限を超えているときの処理方法を決定するために使用されています。 優先度の低い音は、優先度の高い音を再生するために停止され、優先順位の値は任意の実数となります。（実数の値は0〜1、または整数値で0〜100で指定が可能です。GameMaker:Studioはそれらに同じ優先順位をつけます）。数値が高いほど再生優先度は高くなります。

なお、この関数の戻り値は再生中の番号を返します。これを変数に格納して使用することで、サウンド関数により一時停止をしたり停止をすることができます。これにより同じサウンドの再生インスタンスが複数ある場合には、audio関数を使用して音の1つのみを操作対象とすることができます。

例 †

if health <= 0
{
  lives -= 1;
  audio_play_sound(snd_PlayerDead, 10, false);
}

healthが0以下になったらlivesを1つ減らし、サウンド"snd_PlayerDead"を再生します