Akashic Engine 逆引きリファレンス

効果音・BGM を停止する

音声は g.AudioAsset#stop() メソッドを用いて停止することができます。

凡例

var player = scene.asset.getAudioById("bgm1").play(); // アセット ID "bgm1"の再生と同時にそれを再生しているg.AudioPlayerオブジェクトが返ってくるので取得する
player.stop(); // アセット ID "bgm1" の音声アセットが停止される

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

利用例

次のコンテンツでは、「BGM」の矩形をクリックするとが BGM が再生されて、再生中に「BGM」の矩形を再度クリックすると BGM が停止されます。

詳細

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

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

取得した g.AudioPlayer オブジェクトの g.AudioPlayer#stop() を以下のように実行します。

player.stop(); // アセット ID "bgm1" の音声アセットが停止される

音声アセットの利用に関する詳細は効果音・BGM を再生するの「詳細」セクションを参照してください。

関連情報