サウンド キューのリファレンス

Unreal Engine では、サウンド キュー はノード グラフ内に複雑なサウンド デザイン タスクをカプセル化するオーディオ アセットです。サウンド キューを利用すると、オーディオ デザイナーは、サウンドノードを配置および変更して複雑で興味深いオーディオ出力を作成することにより、自由にサウンド エフェクトのデザインの一部を動的に変更できるようになります。

サウンド キュー エディタでは、サウンドノードのタイプのリストが [Palette (パレット)] パネル内に表示されます。[Viewport (ビューポート)] パネルでノードを選択すると、[Details (詳細)] パネルにノードのプロパティが表示されます。

Sound Cues の操作の詳細については、「サウンド キュー エディタ」および「サウンド キュー エディタの UI」を参照してください。

名前付きパラメータ

一部のサウンド ノードでは、新しいパラメータ名を入力してパラメータを宣言できます。ノードにパラメータ名を入力すると、その名前を使用してパラメータが作成されます。

パラメータには任意の名前を付けることができます。ただし、Audio コンポーネント関数 を使用してパラメータの値を設定する場合、その In Name フィールドは指定したパラメータ名と正確に一致sさせる必要があります。

サウンド キュー内から名前付きパラメータの値を設定することはできません。推奨するワークフローは次のとおりです。

• サウンドノードを追加する。
• ノードの [Parameter Name] フィールドに名前を入力する。
• ブループリント内から、またはコード内で、適切な Set [Name] Parameter 関数を使用して関連する Audio コンポーネント関数を呼び出す。
• 同じ名前を [In Name] パラメータに追加する。これにより、サウンド キューが想定どおりに応答します。

次の表に、名前付きパラメータを使用できるノードと、対応するパラメータ設定関数を示します。

Output ノード

Output ノードはすべてのサウンド キューに必要です。これは、ノードグラフのオーディオ信号パスのエンドポイントとして機能します。Output ノードのプロパティは相対的であり、サウンド キューに含まれるすべてのオーディオ出力に影響します。

Attenuation ノード

Attenuation ノードはリスナーからのサウンド ソースの距離に基づいてサウンドのボリュームを制御します。

Attenuation Settings (減衰設定) は、既存の Sound Attenuation アセットに設定することも、[Override Attenuation] 設定を有効にしてノードのプロパティで手動で指定することもできます。

減衰の概要とその機能については、「サウンドの減衰」ドキュメントを確認してください。

ステレオ ファイルは、左右のチャンネルで均等に再生され、Radius min 値と Radius Max 値の間でボリュームがフェードするように減衰します。ただし、空間化はされません。

Attenuation ノードを含まないサウンド キューはローカライズされず、一貫してサウンド キューのボリューム設定値で再生されます。

Branch ノード

Branch ノードは「True」、「False」または「Parameter Unset」の Boolean パラメータの値に基づいて入力ノードを選択します。

Parameter Unset は、名前付きパラメータの値が設定されていないときに再生される出力となります。たとえば、パラメータが Branch ノードで「Name」という名前で保存されているのにユーザーが SetBooleanParam(Name, [true or false]) を呼び出していない場合、サウンド キューは True または False ピンの代わりに Parameter Unset 入力ピンを使用します。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

Concatenator ノード

Concatenator ノードはサウンドの連続再生に使用します (たとえば、指定した一連のトラックを再生するシンプルな BGM プレイリストを作成します)。このノードは連続再生処理を行いますが、各アセットの間にわずかな遅延も追加します。

最初は、このノードに 2 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

Continuous Modulator ノード

Continuous Modulator ノードでは、名前付きパラメータでボリュームとピッチ モジュレーション (変調) をリアルタイムに制御します。典型的な例として、ビークルの速さをエンジン音のピッチに対応させることができます。このモジュレータを機能させるにはコードまたはブループリントで接続する必要があります。また、サウンド キュー エディタ内では、それ自体では機能しません。ただし、サウンド キュー エディタ内からピッチとボリュームは変更できます。

最小値と最大値を設定すると、ランダム化の範囲を決定することができます。

入力サウンドのピッチとボリュームのデフォルト設定は一様分布ですが、サウンド キュー エディタで他のタイプに変更することができます。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

Crossfade by Distance ノード

Crossfade by Distance ノードは、サウンド キューの原点からリスナーへの距離に基づいて、2 つ以上の入力サウンド間でフェードさせることができます。

たとえば、遠くから聞こえる銃声は、近くの銃声とは聞こえ方が異なります。このノードでは、リスナーの銃声からの距離を計算し、短距離か長距離か、またはこの 2 つの組み合わせに基づいてサウンドを再生します。

このノードは、サウンドが最小距離と最大距離の設定内にある場合にのみ再生される点で Attenuation ノードとは異なります。

サウンド ノードは Crossfade by Distance ノードの入力へ直接接続することもできますが、それらの間にノードを追加することによって、レイヤーごとに独立した制御を行うことも可能です。

最初は、このノードに 2 つの入力ピンがあります。ピンの数を増やすには、[Add input] をクリックします。

サウンドを間近で聞きたい場合は、Fade in Distance Start を「0」に設定することをお勧めします。

これらの値はアタッチされたサウンドごとに個別に設定できます。

Crossfade by Param ノード

Crossfade by Param ノードは Crossfade by Distance ノードと同じように機能します。異なる点は、Crossfade by Param ノードでは、クロスフェードを制御する名前付きパラメータ値を (コードもしくはブループリントを使用して) プログラムで操作できることです。

最初は、このノードに 2 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

サウンドを間近で聞きたい場合は、Fade in Param Value Start を「0」に設定することをお勧めします。

Crossfade by Param ノードは負の値をサポートしません。

Crossfade by Param の例

画像をクリックして拡大表示します。

上図は、指定されたプロパティ値に基づいて、2 つのパラメータの経時的な体積変化を示しています。

Delay ノード

Delay ノードは一連のサウンド ノードに遅延を挿入し、入力サウンドが出力に渡される前に一時停止させます。遅延時間は [Details] パネルで指定する [Delay Min] から [Delay Max] の間のランダム値です。

Dialogue Player ノード

Dialogue Player ノードでは、特定の条件下で再生される ダイアログ ウェーブ アセットを設定します。

ダイアログ ウェーブは純粋に会話に対しての使用を想定しているため、Dialogue Player ノードには話し手と、再生されるダイアログのターゲットの両方を指定する必要があります。これにより、複数の性別のある言語などの特定のコンテキストに応じて、またはローカライゼーションを目的として、ダイアログ ウェーブが正しいオーディオ アセットを再生できるようになります。

Doppler ノード

Doppler ノードは、リスナーに対する音源の動きに基づいてサウンドのピッチが変化するドップラー効果をシミュレートします。ピッチは、ソースがリスナーに近づくにつれて増加し、ソースが離れるにつれて減少します。

これの実世界における一般的な例は、救急車が通過する際のサイレンの音です。

Enveloper ノード

Enveloper ノードは、サウンドのボリュームとピッチが分布カーブを介して指定された期間にわたって操作されるエンベロープを作成します。これらのカーブは組み込み済みの カーブ エディタ を使用して編集したり、コンテンツ ブラウザ にある既存の Float Curve アセットで定義されているカーブを基に作成することができます。

オプションで、エンベロープは、設定された回数、または無期限にループするように設定できます。

Modulation カテゴリのプロパティを使用すると、エンベロープ上に定義されたセット ポイントに対して事前に定義されている値をランダム化できます。

Group Control ノード

Group Control ノードは、アクティブなサウンドの数に基づいて再生されるサウンドを制御し、最初に使用可能なグループを優先します。

最初は、このノードに 2 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

Looping ノード

Looping ノードは、サウンドを無期限に、または設定された回数ループするために使用します。

Mixer ノードと一緒に使用すると、複数のオーディオ ファイルを個別にループすることができます。

Looping ノード ではサウンドがシームレスに再生されないため、遅延の導入などの論理的またはプロシージャルなループにのみ使用してください。サウンドをシームレスかつ無限にループさせる場合は、サウンドの Wave Player ノード (後述を参照) で Looping フラグを使用します。

Mature ノード

Mature ノードを使用すると、成人オーディエンス向けとして入力ノードにフラグを立てることができます。このノードは、UEngine:bAllowMatureLanguage の値を使用して、入力ノードを再生するかどうかを決定します。

最初は、このノードに 2 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

Mixer ノード

Mixer ノードは、個々の入力ごとにボリューム コントロールを提供することにより、サウンド キューの同時音を混ぜ合わせる方法を定義します。

最初は、このノードに 2 つの入力ピンがあります。ピンの数を増やすには、[Add input] をクリックします。

Modulator ノード

Modulator ノードは、ランダムなボリュームとピッチのモジュレーションを加えるために使用します。最小値と最大値を設定すると、ランダム化の範囲を決定することができます。サウンド キューがトリガーされると、その範囲内にある値がランダムに選択されます。

ボリュームまたはピッチに一貫したレベルを設定するには、最小値と最大値の両方に同じ値を設定します。また、このノードを使用すると、サウンド キュー内に含まれている複数の Sound Wave ノードの相対ボリュームを調整することもできます。

Modulator ノードを Looping ノードと組み合わせて使用すると、個々のループではなく、Sound Cue トリガーごとにランダム化されます。

Oscillator ノード

Oscillator ノードを使用すると、時間経過に伴う継続的なピッチとボリュームのオシレーションを導入できます。サウンドをループさせ、継続している動作を大きくする場合に便利です。

最小値と最大値を設定すると、ランダム化の範囲を決定できます。

Quality Level ノード

デフォルトでは品質レベルはありません。ノード入力を設定する場合は、デザイナーが [Project Settings] に追加する必要があります。一度設定すると、ノードの分岐を使用して SoundCue グラフの複雑度のレベルを切り替えることができます。これにより、デザイナーは低出力のプラットフォームでよりシンプルな SoundCue グラフを使用することができます。

Quality Level ノードは GameUserSettings AudioQualityLevel (またはエディタ オーバーライド) を使用して再生するブランチを選択します。

ランタイム時に、このノードは選択したブランチに接続された Sound Wave のみをメモリにロードします。

Random ノード

Random ノードは、接続された入力ノードのリストからノードをランダムにトリガーするために使用されます。Weight 値は Random ノードに接続されている他のノードと比較し、トリガーされるノードの確率を制御します。

入力ノードがランダムに選択されると、SoundCue はその選択された入力のデータフロー全体を再生します。

最初は、このノードに 2 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

SoundClass ノード

SoundClass ノードは、入力ノードで使用した Sound Class アセットを再マッピングできます。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

Switch ノード

Switch ノードは実行時の整数パラメータ値に基づいて入力ノードを選択します。指定されたパラメータは、コードまたはブループリントのいずれかで宣言する必要があります。

最初は、このノードに 4 つの入力ピンがあります。ノードの [Add input (入力を追加)] ボタンをクリックしてピンを追加したり、ピンを右クリックしてコンテキスト メニューから [Delete Input (入力を削除)] を選択してピンを削除したりできます。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

Wave Param ノード

Wave Param ノードは名前付きパラメータを使用して、入力ピンへ入力されるものとは異なる Sound Wave を再生するかどうかを決定します。指定されたパラメータが有効な Sound Wave アセットの名前に設定されている場合、そのアセットが再生されます。

オプションの入力ノードが接続されていて、名前付きパラメータが有効な場合、サウンド キューの再生時に Wave Param が入力ノードをオーバーライドします。

名前付きパラメータの詳細については、このページの「名前付きパラメータ」セクションを参照してください。

このノードの潜在的な用途としては、電子音の間に動的なダイアログラインを再生して、ラジオでのダイアログをシミュレートすることが挙げられます。このようにして、同じサウンド キューを再利用して大きな効果を得られます。

Wave Player ノード

Wave Player ノードには、サウンド キューと再生する Sound Wave アセットへの参照が含まれています。

コメントを追加する

コメントはサウンド キュー上のどこにでも追加することができます。出力には影響しませんが、注意を喚起するため、あるいはノードの調整や使用に関する詳細を説明するために使用できます。

コメントはフレームの上部に表示されます。コメントの長さに制限はありません。

コメントフレームのサイズは右下隅の線をドラッグして変更できます。その位置もフレームの他の場所からドラッグして変更できます。どこに配置しても、ノードの後ろに表示されます。

コメントボックスを移動すると、それに付随するすべてのサウンド ノードも一緒に移動します。

複数のノードを選択し、それらノードを右クリックして、コンテキスト メニューから [Create Comment from Selection (選択からコメントを作成)] を選択して、コメントを追加することもできます。

例

次に示すのは、より複雑なサウンド キューの調整例です。各画像をクリックすると拡大できます。

このサウンド キューは、パラメータが true に設定されていると 1 つのサウンドを再生し、false の場合は別のサウンドを再生します。

このサウンド キューは Sound Waves の Sound クラスを変更します。

このサウンド キューでは、Sound Waves に減衰、ランダム化、ループ、遅延などの各種プロパティを混在させています。