audio_exists()

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

audio_exists †

指定したサウンドが存在するかどうかチェックします

構文 †

audio_exists(index);

index

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

戻り値 †

Boolean

存在すればtrue

説明 †

この関数は指定したサウンドが存在するかどうかを返します。 ただし検索するインデックス番号が初期化以前の場合、この関数は存在しないリソースのインデックス番号を指定するのと同様、エラーとなります。 チェックするサウンドはsound_play_*関数(audio_play_sound()]またはaudio_play_sound_at()の戻り値であるサウンド再生番号、またはサウンドリソースの番号となります

例 †

if audio_exists(global.Music)
{
  audio_stop_sound(global.MusicPlayIndex);
  global.MusicPlay = audio_play_sound(global.Music, true);
}

上記コードは指定のサウンドが存在するかどうかチェックし、存在すればループ再生をします