Menu

© 2025 ういやまラボ

BLOGTOOLSPRODUCTNOTES
    リストに戻る
    JAEN
    日本語English

    【Godot】Godotオーディオ管理の基礎: AudioStreamPlayerとAudio Busを使いこなす

    作成: 2025-12-10

    AudioStreamPlayerとAudio Busの使い方を解説。BGM/SE管理と音量制御のベストプラクティス。

    概要

    ゲーム開発において、サウンドはプレイヤーの体験を大きく左右する重要な要素です。しかし、Godot EngineでBGMや効果音（SE）を鳴らし始めたものの、「音が途中で途切れる」「音量バランスの調整が面倒」「エフェクトをかけたいけどどうすればいい？」といった壁にぶつかる初心者は少なくありません。

    この記事では、Godotのオーディオ管理の核となる AudioStreamPlayer ノードと、プロフェッショナルなサウンドミキシングを可能にする Audio Bus（オーディオバス） の基本的な使い方から、初心者が陥りがちなミスを避けるためのベストプラクティスまでを、具体的なコード例と共に徹底的に解説します。

    • BGMとSEを適切に分離し、多重再生による音の途切れを防ぐ。
    • ゲーム全体、または特定の種類の音（BGM、SEなど）の音量を一括で制御する。
    • Audio Busを活用して、サウンドにリバーブなどのエフェクトを適用する。

    Godotにおけるオーディオ制御

    Godotで音を扱う上で、まず理解すべきは以下の3つの要素です。

    AudioStreamPlayerノード

    AudioStreamPlayerは、Godotで音を再生するためのノードです。このノード自体は音源ではなく、音を鳴らす「スピーカー」のような役割を果たします。

    ノード名主な用途特徴
    AudioStreamPlayerBGMやUI音など、空間的な位置を持たない音音源の位置（パン）は考慮されない
    AudioStreamPlayer2D2Dゲームの効果音など、位置を持つ音プレイヤーからの距離や位置に応じて音量やパンが変化
    AudioStreamPlayer3D3Dゲームの効果音など、位置を持つ音3D空間での減衰やドップラー効果などを考慮

    これらのノードのインスペクタにある Stream プロパティに、インポートした音声ファイル（AudioStreamリソース）を設定することで、再生準備が完了します。

    Audio Bus（オーディオバス）

    Audio Busは、再生される音の「通り道」であり、ミキシングコンソールのようなものです。全てのAudioStreamPlayerノードは、どのAudio Busを通して音を出すかを指定できます。

    • Master Bus: 全ての音が最終的に通る、全体の音量を制御するバスです。
    • カスタムバス: BGM、SE、ボイスなど、音の種類ごとに作成するバスです。

    Audio Busの主な役割は以下の通りです。

    1. 音量の一括制御: バス単位で音量を調整することで、BGM全体の音量、SE全体の音量を簡単に変更できます。
    2. エフェクトの適用: バスにリバーブやディレイなどのエフェクト（AudioEffect）を追加し、そのバスを通る全ての音に一括で適用できます。

    Audio Busの設定は、エディタ下部のパネルにある 「オーディオ」 タブで行います。

    よくあるつまずきポイント

    初心者がオーディオ管理でつまずきやすい、代表的な2つのポイントとその解決策を紹介します。

    効果音（SE）の多重再生問題

    問題: 攻撃音やジャンプ音などの効果音を鳴らすために、シーンに配置した一つのAudioStreamPlayerノードを使い回してplay()を呼び出すと、前の音が途中で途切れてしまいます。

    # 間違いやすいコード例
# $SFXPlayerはシーンに一つだけ配置されているAudioStreamPlayer
func _on_button_pressed():
    $SFXPlayer.play() # 既に再生中の場合、最初から再生し直され、音が途切れる

    解決策: 効果音は、再生ごとに新しいノードを作成するか、複数のノードをプールして使い回すのがベストプラクティスです。最も簡単なのは、再生後にノードを自動で削除する方法です。

    # ベストプラクティス1: ノードをインスタンス化して再生後削除
# sfx_streamはインポートしたAudioStreamリソース
func play_sfx(sfx_stream: AudioStream):
    var player = AudioStreamPlayer.new()
    player.stream = sfx_stream
    player.bus = "SFX" # 効果音用バスに流す（Audio Bus設定と連動）
    add_child(player)
    player.play()
    # 再生が終了したらノードを自動で削除する
    player.finished.connect(player.queue_free)

# 使い方
# preload("res://assets/sfx/attack.ogg")などでリソースを取得
var attack_sfx = preload("res://assets/sfx/attack.ogg")
play_sfx(attack_sfx)

    2D/3Dゲームの場合: 上記の例では位置を持たないAudioStreamPlayerを使用しています。音の発生源に位置を持たせたい場合は、AudioStreamPlayer2DまたはAudioStreamPlayer3Dを使用し、global_positionを設定してください。

    パフォーマンスについて: この方法は小規模〜中規模のゲームであれば十分実用的です。ごく大量のSEが同時に鳴るようなゲーム（マシンガンの連射など毎秒数十回以上）では、AudioStreamPlayerをあらかじめ複数用意しておき、プールして使い回す方式（オブジェクトプール）を検討してもよいでしょう。

    Audio Busの概念の無視と煩雑な音量調整

    問題: BGMもSEも全てMaster Busに接続したまま、それぞれの音量をスクリプトで個別に調整しようとすると、コードが複雑になり、ゲーム全体の音量バランスの調整が困難になります。

    解決策: 音の種類ごとにAudio Busを分けることで、ミキシングが劇的に簡単になります。

    • BGM用のバス（例: BGM）
    • 効果音用のバス（例: SFX）
    • ボイス用のバス（例: Voice）

    このようにバスを分けることで、例えば「設定画面でSEの音量だけを下げたい」といった要求に、スクリプトからバスの音量を変更するだけで簡単に対応できます。

    ベストプラクティスと実践例

    ここでは、Audio Busを使った実践的な音量制御の方法と、ノードの適切な設定を解説します。

    Audio Busのセットアップ

    1. 「オーディオ」タブを開く: Godotエディタ下部のパネルにある「オーディオ」タブをクリックします。
    2. 新しいバスの作成: Masterバスの右側にある「+」ボタンをクリックし、「BGM」と「SFX」という名前の新しいバスを作成します。
    3. バスの接続: 新しく作成したバスは、デフォルトでMasterバスに接続されています。この接続構造は、音の信号が流れる経路を示しています。

    エディタ操作のイメージ:

    Bus NameVolume (dB)EffectsSend To
    Master0.0(None)(Output)
    BGM0.0(None)Master
    SFX0.0(None)Master

    AudioStreamPlayerとバスの関連付け

    シーンに配置したAudioStreamPlayerノードのインスペクタで、**Bus**プロパティを適切なバスに設定します。

    • BGM用のAudioStreamPlayer → Busを BGM に設定
    • SE用のAudioStreamPlayer → Busを SFX に設定

    GDScriptによる音量制御

    Audio Busの音量は、AudioServerクラスを使ってスクリプトから制御できます。音量はデシベル（dB）で指定しますが、スライダーなどで扱いやすいように線形値（0.0〜1.0）からデシベル値に変換します。Godotには組み込みのlinear_to_db()関数が用意されているため、これを活用します。

    # AudioBusの音量を制御するスクリプト例
extends Node

# AudioServerからバスのインデックスを取得（@onreadyで初期化時に取得）
@onready var BGM_BUS_INDEX = AudioServer.get_bus_index("BGM")
@onready var SFX_BUS_INDEX = AudioServer.get_bus_index("SFX")

# BGMの音量を設定する (0.0〜1.0)
func set_bgm_volume(volume: float):
    # Godot組み込みのlinear_to_db()で変換
    AudioServer.set_bus_volume_db(BGM_BUS_INDEX, linear_to_db(volume))

# SFXの音量を設定する (0.0〜1.0)
func set_sfx_volume(volume: float):
    AudioServer.set_bus_volume_db(SFX_BUS_INDEX, linear_to_db(volume))

# 使い方:
# set_bgm_volume(0.5) # BGMの音量を半分に
# set_sfx_volume(1.0) # SFXの音量を最大に

    補足: linear_to_db()はGodot 4の組み込みグローバル関数です。逆変換にはdb_to_linear()を使用します。

    ※ AudioServer.get_bus_index("BGM") は、指定した名前のバスが見つからない場合 -1 を返します。
    タイプミスなどで -1 のまま set_bus_volume_db() を呼ぶと警告が出るので、必要であれば初期化時に if BGM_BUS_INDEX == -1: push_error("BGM バスが見つかりません") のようにチェックしておくと安心です。

    このコードをシングルトン（AutoLoad）として登録しておけば、ゲームのどこからでも簡単に音量設定を操作できるようになります。

    Audio Busへのエフェクト適用

    Audio Busには、リバーブ、ディレイ、コンプレッサーなどのエフェクトを追加できます。

    「空間の広さを表現したいときはリバーブ、迫力を出したいときはコンプレッサー」など、やりたい表現から逆算してエフェクトを選ぶと設計しやすくなります。

    1. 「オーディオ」タブでSFXバスを選択します。
    2. バスの右側にある「+ Add Effect」をクリックし、例えばAudioEffectReverbを選択します。
    3. エフェクトのパラメータ（例: Room Size、Damp）を調整することで、そのバスを通る全ての効果音にリバーブがかかるようになります。

    これにより、個々のSEノードにエフェクトを設定する手間がなくなり、統一感のあるサウンドデザインを実現できます。

    まとめ

    Godotのオーディオ管理は、AudioStreamPlayerとAudio Busの2つの主要な概念を理解することで、初心者でもプロフェッショナルなレベルに引き上げることができます。

    概念役割ベストプラクティス
    AudioStreamPlayer音を鳴らすノード（スピーカー）SEはインスタンス化して再生後削除するか、プールで管理する。BGMはシーンに固定配置し、autoplay やループ再生を有効にする。
    Audio Bus音の通り道（ミキシングコンソール）BGM、SE、ボイスなど音の種類ごとにバスを分け、バス単位で音量・ミュート・エフェクトを管理する。

    次に学ぶべきステップとしては、以下のトピックがおすすめです。

    1. AudioStreamPlayer2D/3Dの詳細: 空間的な音の減衰やパンニングをより深く理解する。
    2. AudioServerの高度な機能: バスレイアウトの保存・読み込みや、より複雑なミキシング制御に挑戦する。

    これらの知識を活かして、あなたのゲームに命を吹き込む素晴らしいサウンドデザインを実現してください。