Akashic Engine 逆引きリファレンス

全体音量を変える

ゲーム中の全効果音の音量はg.game.audio.sound.volume を、ゲーム中の全 BGM の音量はg.game.audio.sound.music を利用することによって変更することができます。

凡例

var volume = 0.5;
g.game.audio.sound.volume = volume; // ゲーム中の全効果音の音量をフルボリュームの1/2にする
g.game.audio.music.volume = volume; // ゲーム中の全BGMの音量をフルボリュームの1/2にする

利用例

次のコンテンツでは、右のバーを上下に動かすことによって BGM と効果音の音量を変えることができます。

詳細

g.game.audio.sound.volume を変更することで効果音の音声アセットの音量が、g.game.audio.music.volume を変更することで BGM の音声アセットの音量が変更されます。volume に代入できる値は 0 以上 1 以下の数値のみです。1 に近づくほど音量が大きくなり、0 で無音になります。 0 未満、または 1 よりも大きい数値を代入した場合エラーとなります。

// 効果音とBGMを両方ともフルボリュームの1/2に設定する
g.game.audio.sound.volume = 0.5;
g.game.audio.music.volume = 0.5;

"sound" の音声アセットと "music" の音声アセットの音量をそれぞれ違う値にすることも可能です。

// BGMをやや小さめにして効果音がやや目立つように設定する
g.game.audio.sound.volume = 0.5;
g.game.audio.music.volume = 0.2;

g.game.audio.sound.volumeg.game.audio.music.volume の値は個別の g.AudioPlayer の音量とは独立になっていて、実際の音量はこれらの全体音量と、個別の g.AudioPlayer の音量の積になります。個別の g.AudioPlayer の音量を設定する方法についてはこちらを参照してください。

g.game.audio.music.volume = 0.5;
var player = scene.asset.getAudioById("bgm1").play(); // アセット ID "bgm1" は BGM の音声アセットとする
player.changeVolume(0.6); // アセット ID "bgm1" の 実際の音量は 0.5 * 0.6 で 0.3 となる

g.game.audio.sound.volumeg.game.audio.music.volume は再生中の音声アセットに即反映されるだけではなく、後から再生される音声アセットにも反映されます。

g.game.audio.music.volume = 1;
var player = scene.asset.getAudioById("bgm1").play();
player.changeVolume(0.6); // この時の アセット ID "bgm1" の 実際の音量は 0.6
g.game.audio.music.volume = 0.5; // この時の アセット ID "bgm1" の 実際の音量は 0.3

関連情報