ADX2 for UE4とシーケンサーを使いカットシーン中の音を制御する

# はじめに
アンリアルエンジン4とサウンドミドルウェア「ADX2 for UE4」を使って、UE4の「シーケンサー」と連携して、サウンドを変化させる基本テクニック＆プチ応用を扱います。

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

記事執筆時点のADX2 for UE4のSDKバージョンはv1_29です。

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

# シーケンサーについて

シーケンサーはUE4に標準搭載されている機能で、タイムライン上でキーを打ち、オブジェクトの座標やパラメータなどを変動させることで一連の決まった動きを作るものです。
一般的にはゲームのカットシーンやギミック、または映像制作に使用されます。

![A00.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/0696706b-f244-4264-2a64-962be5c9d26e.png)


# 実装

今回は実装例として、環境音をAtomCraftで構成し、UE4に持っていき制御してみます。

## AtomCraftで環境音を構成する

### マテリアルの用意

風の音、雨の音になる2種類の音源を用意しました。
ドラッグアンドドロップでマテリアルツリーにインポートします。
![A01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/63467af9-ab67-f63b-c62a-94a275151159.png)
ふたつの音源を選択し、インスペクターにてループ情報の上書きを「True」に、ループタイプを「ループ」にします。
![A01B.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/0359f890-690b-b4a7-2313-dcfeea7818af.png)


### キューの作成
新規にキューを作成します。
キューシートを右クリックし、「新規オブジェクト」→「キュー『ポリフォニック』の作成」を選択します。
![A02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3e6be062-9eeb-cfbc-d6a3-9845591a9f9b.png)
キュー内に2種類の音源をドラッグアンドドロップします。
![A03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ceb2b209-f1da-42b9-e2dc-30425795070a.png)


### AISACの作成

風の音のトラックを選択した状態で、右クリックして「新規オブジェクト」→「AISACの作成」を選択。
![A04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d373a057-ca8d-6247-af75-df1cbad76d3b.png)
ウィンドウが開くので、次のように設定します。
![A05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/774b3538-c1ad-0f6c-fdba-fe8e2bb0d01e.png)
AISACタブが開きます。
![A06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/37df58ac-2317-4631-c5d0-4a0c4a6d7eb6.png)
画面下からタブを切り替え、タイムラインに戻ります。
![A07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/67f86167-6b91-913a-9098-852b27434254.png)
雨の音のトラックを選択し、右クリックして同じようにAISACを作成します。設定項目は同じです。
![A08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/50dff23a-f398-9bf7-6eb0-7e30f4e4a87e.png)
AISACタブで、トラックごとにグラフを編集します。
![A09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/926ac9af-f420-b0ae-1f86-0742283f227a.png)
風のトラックはAisacControlの数値が1に近づくほど低めに、雨のトラックは0から1に上がっていくようにします。
![A10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/881f8b1d-e8b4-b5e0-4bd8-6bec7379cfc0.png)
再生しながら、上部のスライダーを動かしてテストします。数値を上げると、風の音が控えめになっていき雨の音が聞こえだす状態が理想です。
![A11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/c3aea562-4083-8ca4-7387-5cbe4174a961.png)
今度は屋内に入った際の音の変化をするためのAISACを作成します。
タイムラインタブに戻り、今度はトラックを選択せずに空欄でAISACを作成します。
![A12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/6d578e0f-c754-8f2c-c4a7-3cf036dda7a0.png)
次のように設定します。音をくぐもらせたいので、グラフタイプは「バンドパス - Cof高域」を選択します。
![A13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/7a640fbb-34a6-c773-e05f-d77e4ce07c98.png)
AisacControl_01の数値が1に近づくほど紫のグラフが低めになるよう編集します。
![A14.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/fd983ceb-6544-a3ff-6d4e-fcccf269b0a2.png)
こちらも上部のスライダーを動かして、テストしながら設定するといいでしょう。
スライダーが右にいくほど屋内に入り、雨音がくぐもった状態になるといい感じです。
![A15.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/46b22b78-0ae3-c1e6-ad6e-b29e2698726d.png)


### 別バリエーションによる遷移キュー

別の音の遷移を試すため、異なるタイプのキューも作ってみましょう。
「セレクターによるトラック遷移」のキューを作成します。
![A16.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3f271d34-d543-3756-3949-f70819199804.png)
同じようにタイムライン上にマテリアルを配置します。
![A17.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/a57d4b8d-762a-701f-bb5e-ba1ac7436432.png)
プロジェクトツリーにて、「セレクターフォルダ」を選択し右クリックして、「新規オブジェクト」→「セレクターの作成」を選択します。
![A18.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/f3fae0b9-8240-ea0c-197f-dc6594d31fdd.png)
セレクターフォルダが作られます。環境音用なので、「Selector_Amb」と名前をつけました。
![A19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/e3d16c4a-cbdf-3564-cb12-cad5dd6219f7.png)
さらに、作成したセレクターフォルダの中にセレクターラベルを作成します。風用、雨用をそれぞれ作ります。
![A20.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/86583831-c768-fec3-1c01-6e543474406f.png)
トラック名の下でセレクターラベルが選択できます。それぞれ合うものを設定しておきます。
![A21.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/54b4d65b-77f8-8f90-7464-68940ecb325b.png)
キューのインスペクターにて、遷移時間が設定できます。ミリ秒単位で指定します。
![A22.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/9307a3c2-82e7-4aee-982e-5f32e4b84212.png)
遷移を実行するために、トラックリストの空欄で右クリックして「新規オブジェクト」→「ビート同期情報の作成」でBeatSyncマーカーを作っておきます。
![A26.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/f4524f8b-e3b2-2c89-6a69-21fbf0317b94.png)

再生しながら、プロジェクトツリーのセレクターラベルをクリックするとトラックが遷移します。
![A23.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/168dd12c-63fb-a128-18a8-3e6e5510c3bb.png)


### キューシートのビルド

ここまでできたらキューシートをビルドします。
![A24.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ff4a53a7-012c-1328-0e47-5918042aea62.png)
![A25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3473e6ed-a6e5-2c75-d9bd-b6e678f84d66.png)

ここからUE4での実装に移ります。

## シーケンサーでAtom Soundを扱う

### 音声のセットアップ

まずはビルドしたキューシートをインポートしましょう。
acfファイル、acbファイルをコンテンツブラウザにドラッグアンドドロップしてインポートします。
![B01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d3e024de-608b-6ce4-4bbf-1ea2d50c1342.png)
プロジェクト設定を開きます。
![B02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/47121ee8-de2d-3c92-32d8-c12592c68658.png)
「CriWare」タブの「Atom Config」にacfファイルをセットします。
![B03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/71006d9c-eb04-349f-b8e7-c66254114644.png)
レベル上にドラッグアンドドロップして配置します。
![B04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/1781c19b-5245-4b0e-9966-217ebc19a861.png)
この時点でゲームを再生すると、風の音が流れることを確認しておくといいでしょう。
![B05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/67f6bef3-3868-2dbc-9d61-362904be6f76.png)


### シーケンサーで音声を再生する

配置したAtom Soundをシーケンサーから制御したいので、自動再生を無効化しておきます。
Atom Soundを選択し、Detailsパネルで「Auto Activate」のチェックを外せばOKです。
![B06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/53e13b45-d7d6-b6b2-f909-d777df646d24.png)

レベルシーケンスを作成します。
上部の「Cinematics」から、「Add Level Sequence」をクリックします。
![B07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/5fec4bdc-187f-55a5-ebe4-e8b465f5e0b2.png)
適当な場所にシーケンスを保存します。
![B08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/cc654b59-35b3-fc35-9861-0cceaad460fb.png)
シーケンサーのエディタが開きます。
画像では1画面におさめていますが、領域が大きくなるので別画面があればそちらに表示するのがいいでしょう。
![B09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/92b0aa69-0343-64a9-2ff2-5f5def96f652.png)
レベル上で**Atom Soundを選択した状態で**、「+Track」ボタン→「Actor To Sequencer」→「Add（Atom Sound名）」で音源をシーケンサーに登録します。
これでシーケンサー上で音声の制御ができるようになります。
![B10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d2d2933b-c780-2eb4-7859-107bba5f0b22.png)
追加されたトラックの「+Track」を押し、「Atom」から再生したいAtom Cueを選択します。
![B11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/a15f0382-e413-6738-5afb-09b87a606832.png)
これで目的の波形が配置されます。
下部の再生ボタンを押すと風の音が流れてくるはずです。
![B12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/2d7d168a-373f-32df-3de2-6f220d97767d.png)

ゲーム中でレベルシーケンスを再生するには、シーケンスを選択してDetailsパネルで「Auto Play」にチェックを入れます。
その下にある「Loop」を変更するとループ再生が可能です。
![C08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/f42aee92-c0a0-78fb-ab9f-d617effd0968.png)

任意のタイミングで再生するには、レベルブループリントから制御するといいでしょう。
レベルブループリントを開き、
![C10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/51501db9-4549-e7a1-3e25-70915660bc8d.png)
レベル上でシーケンスを選択した状態で、イベントグラフの空欄で右クリックし「Create a Reference to （シーケンス名）」を選択します。
![C11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ba439cc4-50ed-0dbd-e55e-87ae94002036.png)
**「Play(SequencePlayer)」**を選択します。
![C12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/7b0dbfc8-3fd3-27e5-50c2-5715c8bb2985.png)
再生用のノードが作られるので、任意のイベントにつなげば再生が開始されます。
![C13.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/d8ba03c4-b2bb-9714-f764-63df3d903f74.png)


## シーケンサーからAisacコントロールを制御する

タイムライン上でAisacの値を制御し、雨を降らせてみましょう。
まずは表示時間の単位をフレーム数から秒数に変更します。
![C01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/4d769b07-9dec-d89c-b6e7-53d393bc562b.png)
Atomトラックの表示を展開します。ボリュームやピッチ、そしてAtomCraftで設定していればAisacコントロールのトラックが出てきます。
![C02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/4499b2ea-2f0c-182b-a587-9c88eb49bfac.png)
数値を変更するか、キーフレーム追加ボタンを押すとタイムライン上にキーが追加され、値の変動が起きます。
![C03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/abff85af-adb0-a4c2-6e90-d265457dcf5f.png)
1秒の時点で「0」、3秒の時点で「1」に変動するようキーを打ってみましょう。
![C04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/48cb3705-6295-5f39-8feb-f2ab5fd08605.png)
再生ボタンを押すと風の音に雨の音が混じっていく様子が確認できます。
![C05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/28edce9d-23c3-481b-f48e-1f3f32638489.png)
カーブエディタを上部のボタンから起動できます。
![C06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ee5e5013-33a6-574e-4f22-3c5681dabae9.png)
トラックを選択すると、値が変化していく様子をグラフで見ることができます。
この状態での編集も可能です。
![C07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/2bb7cb9b-195a-af12-cad4-5e0c8f7c8e1b.png)
また、同じように「AisacControl_01」も変化させてみました。段々と屋内に入っていくように雨音がくぐもっていきます。
![C09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/492d31f8-d1dc-fc21-95d6-6d3e50d8fe3a.png)


## ブループリントと連携しイベントを発火する

セレクタラベルなどの機能はシーケンサーだけでは完全にアクセスすることができません。ですが、ブループリントと連携することで処理を完成させることができます。

いくつか方法はありますが、専用のアクターを作ってしまうのが楽なので新規に作成します。
適当な場所でブループリントクラスを作ります。
![D01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/82a8fc90-72bd-795b-6bb8-4308662cc572.png)
親クラスはActorにします。
![D02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/9687c31d-a250-1447-9e5c-8fb19df527ad.png)
アクターを開き、イベントグラフに次のような処理を書きます。
グローバルなラベルを交互に変更するカスタムイベントです。
![D03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/e93b01db-a814-816b-4666-44818fb0f176.png)
アクターをレベルに配置します。
![D04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/521c87f1-9c0e-7d9f-3630-47c37bc7d304.png)
レベルシーケンスを作り、先程のアクターをトラックに追加します。
「+Track」から「Atom」→セレクター遷移を使用したAtom Cueを選択します。
![D05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/e6f23741-9982-c5d4-69af-1b903c1e22db.png)
さらに、アクターのトラックにEvent Track（Trigger）を追加します。
このトラックで任意のイベントを発火させることができます。
![D06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/0c5a1b57-d836-a52b-2f50-e4b25afa97e9.png)
適当な時間でキーを打ちます。
![D07.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/ef8d7c85-8c14-e539-828a-6f74504f35df.png)
キーを右クリックし、「Properties」からイベントを選択します。
![D08.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/2d240b47-40a2-47e9-6754-e36a892085f9.png)
「Quick Bind」から検索して先ほどアクター内に作成したカスタムイベントを選択します。
![D09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3207f3c0-7467-dbf2-fb9c-092e1fe903fd.png)
シーケンサーからイベントを呼び出す「SequenceDirector」が作られ、開きますが特に変更の必要はないのでそのまま閉じて大丈夫です。
![D10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/3b5d80e3-0d0b-1746-db2e-518f79471c4d.png)
イベントのキーのプロパティから「Call in Editor」にチェックを入れます。
![D11.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/f7afd5da-e990-8be4-5cab-93f92ceebc86.png)
これで再生すると、キーを打ってイベントを呼び出すたびに風の音、雨の音が交互に遷移するようになります。
もちろんランタイムでも同じように動作します。
![D12.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/154452/0fc61d32-5517-7c7e-f8e0-104063a5b8ab.png)