全体音量を変える
ゲーム中の全効果音の音量はg.game.audio.sound.volume
を、ゲーム中の全 BGM の音量はg.game.audio.sound.music
を利用することによって変更することができます。
凡例
javascript
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 よりも大きい数値を代入した場合エラーとなります。
javascript
// 効果音とBGMを両方ともフルボリュームの1/2に設定する
g.game.audio.sound.volume = 0.5;
g.game.audio.music.volume = 0.5;
"sound"
の音声アセットと "music"
の音声アセットの音量をそれぞれ違う値にすることも可能です。
javascript
// BGMをやや小さめにして効果音がやや目立つように設定する
g.game.audio.sound.volume = 0.5;
g.game.audio.music.volume = 0.2;
g.game.audio.sound.volume
や g.game.audio.music.volume
の値は個別の g.AudioPlayer
の音量とは独立になっていて、実際の音量はこれらの全体音量と、個別の g.AudioPlayer
の音量の積になります。個別の g.AudioPlayer
の音量を設定する方法についてはこちらを参照してください。
javascript
g.game.audio.music.volume = 0.5;
var player = scene.asset.getAudio("/audio/bgm1").play(); // "/audio/bgm1" は BGM の音声アセットとする
player.changeVolume(0.6); // アセット ID "bgm1" の 実際の音量は 0.5 * 0.6 で 0.3 となる
g.game.audio.sound.volume
と g.game.audio.music.volume
は再生中の音声アセットに即反映されるだけではなく、後から再生される音声アセットにも反映されます。
javascript
g.game.audio.music.volume = 1;
var player = scene.asset.getAudio("/audio/bgm1").play();
player.changeVolume(0.6); // この時の アセット ID "bgm1" の 実際の音量は 0.6
g.game.audio.music.volume = 0.5; // この時の アセット ID "bgm1" の 実際の音量は 0.3