ADX2+UE4で作る立体環境音（拡張編）

# はじめに
アンリアルエンジン4とサウンドミドルウェア「ADX2 for UE4」を連携させ、
環境音にひと工夫して、立体的なアンビエントサウンドを汎用的に使えるよう実装していきます。
前回公開した記事では鳥のさえずり音を立体的な空間にスポーンし、ランダムな方向から聞こえるような実装をしました。
https://qiita.com/SigRem/items/ef86c0faf71ecd2e7974
当記事ではこれに改良を加え、より多くのシチュエーションに対応できるよう使い勝手のいい機能にしていきます。


当記事ではUE4.23+「ADX2 LE v2.10.05」を使用します。基本的にブループリントのみでの実装を想定しています。
ADX2はインディー向けの「LE版」であれば、無料で使用できます。
https://game.criware.jp/products/adx2-le/

# 前提
ADX2 for UE4の導入や基本的な使い方は以下の記事にあります。当記事だけでも実装はできるかと思いますが、必要に応じて参照してください。
ADX2 for UE4の導入で、一歩上のサウンド表現を（導入編）
https://qiita.com/SigRem/items/4250925f6d66a4fd287a
ADX2 for UE4の導入で、一歩上のサウンド表現を（実践編）
https://qiita.com/SigRem/items/c089b71c42e898980a46

# 実装

## 再生するサウンドを簡単に差し替え可能にする

ブループリントを書き換えなくても、レベル上で手軽に再生するサウンドを編集可能にします。
新しくアクターを作成します。
![01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d8ad8bcc-0716-324a-0fbc-f600e067265e.png)
![02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/908e647d-0d11-c9a5-2b95-7881aa25c774.png)
イベントグラフを開き、前回記事の処理をそのままコピー＆ペーストします。
この時点ではほぼ同じ内容です。汎用的な音を再生したいので、カスタムイベントの名前を「PlaySound」に変更します。
それに伴い、**Set Timer by Function Name**ノードの「Function Name」も「PlaySound」に変えておきます。
![03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/a3be9620-0491-dee2-cbf5-f6ca62e395d0.png)

**Play Sound at Location**ノードの「Sound」の青いインプットピンを右クリックし「Promote to Variable」をクリックします。
![04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ec2e180c-55dc-01e1-b2be-8ebe6964edd0.png)
新しく変数が作られ、自動的に接続されます。適当に名前をつけておきましょう。画像では「Sound」としています。
![05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/99a185bf-0c14-350f-01b8-f7a8b0032fcf.png)
作成した変数はMy Blueprintパネルの「Variables」内にあります。デフォルトでは右側に目が閉じているマークがあるので、クリックして目玉が開いた状態にします。
![06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3f64c888-4d17-fda3-594d-00b5717c2333.png)
一度コンパイルしておき、DetailsパネルでデフォルトのAtom Cueを指定しておきます。
![07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/564d419f-57b9-aaef-2773-a4b757761eef.png)
レベル上にアクターを配置し、選択した状態でDetailsパネルで再生するAtom Cueが選べるようになっています。
![08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/9b401b26-94c9-c3ca-f640-4319005b185d.png)

### より多くのパラメータをカスタマイズ可能にする

パラメータを変数化しておき、多彩な鳴らし方が可能になるよう改良します。
まずは音声の再生間隔を変数化します。
**Random Float in Range**のふたつのFloat型パラメータを「Promote to Variable」で変数に変化させます。
それぞれ「IntervalMin」「IntervalMax」と名前をつけ、忘れずに目玉のアイコンをクリックして開いている状態にします。
![11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/7a48fe4f-7f76-c108-3d29-473bc657e0d8.png)
![12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/b6d56b2a-64d5-b55e-9f3a-39fb90c2ac06.png)

ゲーム開始時にもイベントの発生タイミングにランダム性をもたせたいので、**Set Timer by Function Name**にも一連のノードをコピーします。
![13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/bd07f7df-40e1-eb5e-9efe-f9d419ca1fd0.png)
また、**Play Sound at Location**ノードの「Volume Multiplier」「Pitch Multiplier」も変数化して編集可能にしました。
![14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/8702cd1e-6015-8610-af98-9d30e814ae8d.png)

レベル上で各種パラメータが変更可能になりました。
![15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/8b79e07d-4f21-d820-ee11-00ca3e05e3cc.png)

### 再生する座標をカスタマイズ可能にする
サウンドはプレイヤーの周りのランダムな座標で再生されますが、この範囲も変更できるようにします。
Vector型の変数をふたつ作ります。「LocationVectorMin」「LocationVectorMax」と名前をつけ、公開設定にしておきます。
![16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/6647e8b1-e425-d1c7-3570-feae659c87fc.png)
次のようになっている座標のランダム処理を……
![17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/142bddd4-6388-a052-9a8c-99410d0aeaea.png)
次の例のように構成しなおします。ふたつの変数の要素を一度**Break Vector**で分解し、**Random Float in Range**ノードにつないでいます。
![18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/5cbc1055-e611-6812-6640-ab1504526b87.png)

これで再生範囲も編集可能になりました。
![19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/c1e10bcc-1937-a82a-c07c-93d5b56af68e.png)
変数の初期値が0になっている（再生範囲が狭すぎて再生されない）事故を防ぐため、Default Valueを設定しておきましょう。
![20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/b968c869-7d03-17a7-ff53-8d239ae3beef.png)


### 再生する範囲（トリガー）を指定する

プレイヤーが近づくと再生が開始されるよう、再生範囲を指定できるようにします。
「Box Collision」コンポーネントを追加します。
![21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/6c2d0483-f5bc-ee0f-6cd1-6c8cabbc9ee2.png)
再生範囲となるVector型変数「TriggerBoxExtent」（トリガーボックスの範囲）を作成し、公開設定にします。
![22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d59b2ee0-5cdb-6747-e3f9-8b253bbf46e9.png)
**「Construction Script」タブ**に移り、**Set Box Extent**ノードを置きます。「Construction Script」タブはエディタ内で、レベル上に配置したアクターの変数が変更されると走る処理です。
![23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/1b72983c-b760-1524-51b2-3c0ed001ebf9.png)
もし「Construction Script」タブが見当たらない場合、「My Blueprint」パネルの「Construction Script」をダブルクリックすると開くことができます。
![23a.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/4d799e41-2b76-a1ec-07f5-0932dee99673.png)
「TriggerBoxExtent」変数のDefault Valueを適当に設定しておきます。
![24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/9cd3fad6-a834-f621-b0a1-877377a9a9a4.png)

イベントグラフに戻り、Box Collisionコンポーネントを右クリックし「Add Event」→「Add OnComponentBeginOverlap」を選択します。
![25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/e6453693-a04d-792c-e512-377c57d8b5c0.png)
ボックス内になにかが進入した際のイベントが作られます。ゲーム開始時に処理は行わなくなるので、**Event BeginPlay**ノードの接続は解除しておきます。
![26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/eb40f9d4-b83d-52c7-be64-871fbaee545a.png)
プレイヤー以外がボックスに進入しても処理を行わないよう、感知したアクターがプレイヤーである（プレイヤーの同一である）ことを**Branch**ノードで判別します。
![27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/cbd02681-ce11-e8c8-71c6-687103662750.png)
ぼっくすから出た際のイベントも追加します。今度は「Add Event」→「Add OnComponentEndOverlap」です。
![28.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d8637c30-66b9-7636-c737-e807eb3a9bc0.png)
カスタムイベントのループ処理を解除するには、**Clear Timer by Function Name**を使います。
![29.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/1b0e28bf-422f-8108-02b6-c0fb4839b60d.png)
レベル上でイベントの開始範囲を設定できるようになりました！「TriggerBoxExtent」変数の値を変更することで、黄色い枠線の範囲が変わるはずです。
![30.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/db6090f3-0468-dc92-1234-36cac023fb2b.png)

このままではアクターを移動させた際にいちいち「Construction Script」タブの処理が走ってしまうので、変数の値を変えたときのみに処理をさせるように変更します。
アクターの「Class Settings」を開きます。
![31.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/1add10df-bda5-a876-0384-8ad354dcc348.png)
Detailsパネルにて「Run Construction Script on Drag」のチェックを外します。これだけです。
![32.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/42151743-d2cf-601b-57ba-cfb2029bbc21.png)