Akashic Engine 逆引きリファレンス

効果音・BGM の音量を変える

g.AudioPlayer#changeVolume() メソッドを用いて特定の音声アセットの音量を変えることができます。

凡例

var player = scene.asset.getAudioById("bgm1").play(); // アセット ID "bgm1"の再生と同時にそれを再生しているg.AudioPlayerオブジェクトが返ってくるので取得する
player.changeVolume(0.5); // アセット ID "bgm1"の再生音量がフルボリュームの1/2の大きさに変わる

特定の音声アセットの音量を変える場合は、 g.AudioAsset#play() で返ってきた g.AudioPlayer オブジェクトの g.AudioPlayer#changeVolume() を実行します。 g.AudioAsset#play() についてはこちらを参照してください。

利用例

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

詳細

特定の音声アセットの音量を変えるためには、その音声アセットを再生している g.AudioPlayer オブジェクトを取得する必要があります。このオブジェクトは g.AudioAsset#play() から取得できます。

var bgm = scene.asset.getAudioById("bgm1"); // アセット ID "bgm1" が音声アセットとする
var player = bgm.play();

取得した g.AudioPlayer オブジェクトの g.AudioPlayer#changeVolume() を実行します。 このメソッドに渡せる引数は 0 以上 1 以下の数値のみです。1 に近づくほど音量が大きくなり、0 で無音になります。この範囲から外れる数値を渡した場合の動作は不定です。

player.changeVolume(0.5); // アセット ID "bgm1" の再生音量がフルボリュームの 1/2 の大きさに変わる

g.AudioPlayer オブジェクトは play() の呼び出しの度に新たに作られます。同じ音量で再生したい場合は、 play() の度に音量を設定し直す必要がある点に注意してください。

関連情報