Unreal Engine Pluginを使ってアクターを動かそう

次のステップでUnreal EngineにUnreal Engine Pluginを導入し、アクターを動かしてみましょう。

1. 事前準備
2. STEP1：Unreal Engine Pluginのインストール
3. STEP2：モーションデータの受信～動作確認
4. STEP3：モーションデータの記録～アニメーション シーケンスの作成
5. 付録) 複数のモーションデータを受信する方法

事前準備

以下の手順で、Unreal Engine Pluginを使用するための準備をします。

1. ローカルネットワークに、Unreal Engineがインストールされているパソコン（Windows/Mac）を接続します。
2. Downloadsページにアクセスし、最新のUnreal Engine Pluginをダウンロードします。
3. ダウンロードしたZIPファイルを任意のフォルダに解凍します。
   配布データの詳細については、配布データの内容を参照してください。
4. ローカルネットワークに、mocopiアプリがインストールされているスマートフォンを接続します。
5. mocopiアプリからのデータ送信方法を参照し、mocopiアプリからモーションデータをUDP送信できる状態にします。
   「IP」欄にはUnreal EngineがインストールされているパソコンのIPアドレス、「Port」欄には使用するポート番号（初期値：12351）、送信フォーマットは「mocopi (UDP)」を指定してください。

これで、事前準備ができました。

STEP1：Unreal Engine Pluginのインストール

1. Unreal Engineを起動します。
   既存Unreal Engineプロジェクトを使用する場合は、手順3に進んでください。
2. 新規Unreal Engineプロジェクトをプリセット「Third Person Game Project」を選択して作成し、プロジェクトを閉じます。
3. 事前準備の手順3で解凍したUnreal Engine Plugin（MocopiLiveLinkフォルダ）を、Unreal Engineプロジェクト直下のPluginsフォルダにコピーします。
   Pluginsフォルダが無い場合は作成してください。

   参考

   1. Unreal Engineのバージョン（5.0または5.1または5.2または5.3）と同じバージョンのプラグインを使用してください。

   2. 任意のプロジェクトでUnreal Engine Pluginを読み込めるようにしておきたい場合は、Unreal Engine Plugin（MocopiLiveLinkフォルダ）をUnreal EngineのPlugins/Marketplaceフォルダにコピーします。

      Unreal Engineのプラグインフォルダのパス：
      例[Windows]）C:\Program Files\Epic Games\UE_5.1\Engine\Plugins\Marketplace\
      例[mac]）/Users/Shared/Epic Games/UE_5.1/Engine/Plugins/Marketplace/

4. Unreal Engineプロジェクトを再起動します。
5. Unreal Editorのメニューバーで［Edit］＞［Plugins］を順にクリックします。
   Pluginsウィンドウが開きます。
6. 「mocopi」を検索して、「MocopiLiveLink」が表示され有効化されていることを確認します。
   

これで、Unreal Engine Pluginがインストールできました。

STEP2：モーションデータの受信～動作確認

1. Unreal Editorのメニューバーで［Window］＞［Virtual Production］＞［Live Link］を順にクリックします。
   Live Linkウィンドウが表示されます。
2. ［+ Source］＞［Mocopi LiveLink］を順にクリックし、以下の項目を設定します。
   1. Port Number
      UDP受信するポート番号（初期値：12351）を入力します。
      mocopiアプリで指定したポート番号と、同じ番号を入力します。
   2. Subject Name
      「MocopiSkeleton」になっていることを確認します。

      参考

      サブジェクト名は変更することができます。変更した場合は、プラグインに含まれる「ABP_Mocopi」ブループリントの修正も必要となります。

3. ［Create Mocopi Source］ボタンをクリックします。
   
   ソースセクションに「Mocopi LiveLink」が追加されます。
4. mocopiアプリを操作し、モーションデータのUDP送信を開始します。
   Unreal Engineがモーションデータを受信すると、Live Linkウィンドウのサブジェクトパネルに、作成したMocopi LiveLinkソースのサブジェクト名と緑色のインジケーターが表示されます。
   
5. Unreal Editorのメニューバーで［Window］＞［Content Browser］＞［Content Browser 1 - 4］を順にクリックします。
   ［Content Browser］タブ／ウィンドウが表示されます。
6. ［Content Browser］タブ／ウィンドウの左ペインで［All］＞［Plugins］＞［MocopiLiveLink Content］を順に開きます。

   参考

   1. ［Content Browser］タブ／ウィンドウの左ペインに［MocopiLiveLink Content］が表示されない場合：
      ［Content Browser］タブ／ウィンドウ右上の［Settings］をクリックし、［Show Plugin Content］にチェックを付けてください。
   2. Unreal EngineのPluginsフォルダにインストールした場合：
      ［Settings］をクリックして［Show Engine Content］にチェックを付け、［All］＞［Engine］＞［Plugins］＞［MocopiLiveLink Content］を順に開きます。
   
7. 「ABP_Mocopi」ブループリントをダブルクリックしてアニメーションを表示します。
   
   または「MocopiActor」ブループリントをシーンにドラッグ＆ドロップします。
   
   アクターがモーションデータに従ってシーン上で動作します。

これで、モーションデータの受信と動作確認ができました。

STEP3：モーションデータの記録～アニメーション シーケンスの作成

以下の手順でモーションデータ（アクターの動き）を記録し、アニメーション シーケンスを作成することができます。

1. モーションデータの受信中に、Unreal Editorのメニューバーで［Window］＞［Cinematics］＞［Take Recorder］を順にクリックします。
   ［Take Recorder］タブ／ウィンドウが表示されます。
2. ［+ Source］＞［From LiveLink］＞［MocopiSkeleton］を順にクリックします。
   
   ソースセクションに「MocopiSkeleton」が追加されます。
3. 録画ボタンをクリックします。
   
   3秒のカウントダウン表示のあと、モーションデータの記録が開始されます。
4. 停止ボタンをクリックして、モーションデータの記録を停止します。
5. 左上の「Review Last Recording」アイコンをクリックします。
   
   ［Sequencer］タブ／ウィンドウに記録したテイクが表示されます。
6. 再生ボタンをクリックします。
   記録したテイクが再生されます。
   記録し直したい場合は、［Take Recorder］タブ／ウィンドウ左上の「Return」アイコンをクリックし、手順3から操作し直してください。
7. 気に入ったモーションデータの記録ができたら、［Sequencer］タブ／ウィンドウ右上の「Lock」アイコンをクリックします。
   
   アニメーションが編集可能な状態になります。
8. ［Content Browser］タブ／ウィンドウを表示し、「MocopiActor」ブループリントを［Sequencer］タブ／ウィンドウ内の記録したテイクの下にドラッグ＆ドロップします。
   
9. ［Sequencer］タブ／ウィンドウ内の［Mocopi Actor］を右クリックし、［Bake Animation Sequence］をクリックします。
   
   Create a New Animation Assetウィンドウが表示されます。
10. 保存先のフォルダを選び、「Animation Name」欄に判別しやすいアニメーション名を入力します。
11. ［OK］ボタンをクリックします。
    
    Animation Sequence Optionsウィンドウが表示されます。
12. ［Export To Animation Sequence］ボタンをクリックします。
    

これで、モーションデータの記録とアニメーション シーケンスの作成ができました。

複数のモーションデータを受信する方法

以下の手順で、複数のmocopiアプリのモーションデータを受信することができます。

1. 事前準備の手順5を参照して、追加するmocopiアプリからモーションデータをUDP送信できる状態にします。
2. STEP2：モーションデータの受信～動作確認の手順1～4を参照し、新しいMocopi LiveLinkソースからモーションデータを受信します。
   
3. STEP2：モーションデータの受信～動作確認の手順5～6を参照し、［Content Browser］タブ／ウィンドウで［MocopiLiveLink Content］を開きます。
   
4. 「ABP_Mocopi」ブループリントと「MocopiActor」ブループリントを選んで右クリックし、［Duplicate］をクリックします。
   ブループリントが複製されます。
5. 複製した「ABP_Mocopi」ブループリントをダブルクリックします。
   ABP_Mocopi_xウィンドウ（xは数字）が表示されます。
6. ［AnimGraph］をダブルクリックします。
   ［AnimGraph］タブが表示されます。
7. 「LiveLink Pose」ノードのドロップダウンメニューで、新しいMocopi LiveLinkソースのLive Linkサブジェクト名を選びます。
   データストリームを、複製したブループリントに紐づけることができます。
8. ［Compile］ボタンをクリックします。
9. 「Save」アイコンをクリックします。
10. 画面右上の［×］をクリックします。
    
11. 複製した「MocopiActor」ブループリントをダブルクリックします。
    MocopiActor_xウィンドウ（xは数字）が表示されます。
12. ［Components］タブで［SkeletalMesh］をクリックします。
13. ［Details］タブの［Animation］＞［Anim Class］のプルダウンメニューから、手順4で複製した「ABP_Mocopi_x」ブループリントを選びます。
14. ［Compile］ボタンをクリックします。
15. 「Save」アイコンをクリックします。
16. 画面右上の［×］をクリックします。
    
17. 複製した「MocopiActor」ブループリントをシーンにドラッグ＆ドロップします。
    複数のアクターが、モーションデータに従ってシーン上で動作します。