Unreal Engine で画像シーケンスを再生する | Unreal Engine 5.5 ドキュメンテーション

Image Media Source (イメージメディアソース) アセットでは、Unreal Engine 5 (UE5) の中で画像シーケンスを Media Framework ツールの一部としてプレイすることができます。ビデオへリンクするのではなくパスを「Image Sequence」ファイルに指定して再生できるという点で、イメージメディアソースアセットはファイルメディアソースと似ています。命名規則は重要ですので、連番を使用することをお勧めします。たとえば、「Image_01」、「Image_02」、「Image_03」とすれば、必ず正しく順番に再生されます。

この操作ガイドでは、イメージメディアソースを使ってレベル内のスタティックメッシュ上で画像シーケンスを再生します。

現在 Electra Media Player は画像シーケンスの再生をサポートしていません。

このチュートリアルでは、動画ファイルを再生するための手動ワークフローを説明します。5.1 以降では、メディアソースをドラッグ＆ドロップで追加できる Media Plate Actorや、事前に作成されたメッシュに最適化されたストリーミングを使用することもできます。

手順

スターターコンテンツこの操作ガイドでは、スターターコンテンツを有効にした状態 の 「ブループリントのサードパーソンテンプレート」 プロジェクトを使用しています。画像シーケンスも必要です。ない場合は、このガイドで使用するサンプル画像シーケンスを右クリックしてダウンロードできます。

[コンテンツブラウザ] の [Sources (ソース)] パネル を展開し、[Content (コンテンツ)] に「「Movies」という名前のフォルダを作成します。
「Movies」フォルダを右クリックして、[Show in Explorer (エクスプローラーで表示)] を選択します。

必須ではありませんが、プロジェクトで正しくメディアをパッケージ化およびデプロイするために、「Content/Movies」フォルダに保存することを推奨します。
画像シーケンスの画像を「Content/Movies」フォルダに配置します。

上の画像のとおり、「UE5_Images」という名前の新しいフォルダを「Content/Movies」内に作成し、その中に JPG 画像を配置しました。さらに、シーケンス画像の低解像度版が入っている「lowres」という名前のフォルダも作成しました。 Media Framework ツールを使えば、メディアソースプロキシを使って開発中に (通常は) 低解像度の画像で作業することができます。作業する画像のシーケンスやファイルサイズが大きな場合は、低解像度の画像で作業した方が効率的であり、かつパフォーマンス問題の発生も最小限に抑えることができます。
エディタ に戻って、Unreal Engine 5 のプロジェクト内の [Auto-Import (自動インポート)] ダイアログウィンドウにある [Don't Import (インポートしない)] ボタンをクリックします。

プロジェクトディレクトリのどこに置かれているのか参照可能なので、プロジェクトに画像をインポートする必要はありません。
「Content/Movies」フォルダを右クリックして [Media (メディア)] から [Img Media Source (画像メディアソース)] を選択して「MyImageSequence」と名前を付けます。
新しい MyImageSequence アセット中の [Sequence Path (シーケンスパス)] ボタンの横にある [...] ボタンをクリックして、画像シーケンスの中の最初の画像に指定します。
[Advanced Options (詳細オプション)] をクリックして [Sequence (シーケンス)] オプションを展開し、[Proxy Override (プロキシオーバーライド)] に「lowres」と入力します。

ここでは、開発で使用する低解像版の画像が入っている「lowres」フォルダを指定しています。低解像度の画像ファイルを使うと必要なメモリ量が減るため、フル解像度のファイルを使う場合よりも最適化された体験を提供することができます。

「Proxy Override」パスをオリジナルのフル解像度画像と同じディレクトリ構造で、同じ名前のフォルダに指定して、見つけられるようにしておきます。
「Content/Movies」フォルダを右クリックして [Media] から [Media Player (メディアプレーヤー)] を選択します。

メディアプレーヤーアセットを使用して、さきほど作成した画像シーケンスを再生します。
[Create Media Player (メディアプレーヤーを作成)] ウィンドウで [Video output Media Texture asset (ビデオ出力メディアテクスチャアセット)] オプションを有効にして [OK] ボタンをクリックします。

これにより、画像シーケンスに使用するメディアプレーヤーに関連する メディアテクスチャ アセットが自動的に作成され、割り当てられます。
(自動的に「Media Texture」という名前になっている) メディアプレーヤー アセット名を「MyPlayer」に変更し、ダブルクリックして開きます。
メディアエディタ の [Details] パネルで、[Loop (ループ)] オプションを有効にします。

このオプションを有効にすると、メディアプレーヤーが画像シーケンスの再生をループし続けます。
MyImageSequence アセットをダブルクリックして、画像シーケンスの再生を開始します。

画像シーケンスはメディアエディタで再生を開始します。[Info] タブをクリックすると、再生中の画像シーケンスの情報が表示されます。この例では、低解像度 の画像を使っているので、画像シーケンスの Dimension (寸法) は 640 x 360 と表示されています。
コンテンツブラウザ で MyImageSequence アセットを開き、[Proxy Override] セクションをクリアします。

これでフル解像度の画像への切り替えが可能になります。メディアプレーヤーアセットを開いて画像シーケンスを再度再生すると [Dimension] 値が異なります。

[プレーヤー] ウィンドウの下部にある [Image Cache (画像キャッシュ)] 進捗バーはメモリへキャッシュされたコンテンツ量を表します (緑はすべてロード済み、黄色はロード中、グレーはロードをスケジュール中)。使用しているシステムハードウェアによって、キャッシュの量と表示カラーは異なることがあります。詳細は「Media Framework の概要」の「画像メディア」セクションを参照してください。
メインエディタの [Place Actors (アクタを配置)] パネルの [Shapes (形状)] タブから、[Plane (平面)] をレベルにドラッグし、自由にサイズ変更および配置します。

トランスフォームツールを使用して、平面を自由に移動、回転、スケーリングすることができます。
コンテンツブラウザ から、MyPlayer_Video メディアテクスチャアセットをレベルの中の平面の上にドラッグします。

これにより、メディアテクスチャを使用して マテリアル がレベルの平面に自動的に作成および適用され、画像シーケンスが再度再生されます。
メインツールバーで [Blueprints (ブループリント)] ボタンをクリックし [Open Level Blueprint (レベルブループリントを開く)] を選択します。

テストを開始する前に、ブループリントを使って、メディアプレーヤーにゲームプレイの開始時にイメージメディアソースアセットを開いて再生が開始されるように指示します。
[MyBlueprint] パネルで Media Player Reference というタイプの MediaPlayer という変数を作成し、メディアプレーヤー として MyPlayer に割り当てます。

[Default Value (デフォルト値)] を メディアプレーヤー に割り当てるためには、変数を作成した後に [Compile (コンパイル)] をクリックする必要があります。
Ctrl キーを押しながら MediaPlayer 変数をグラフへドラッグし、右クリックして Event Begin Play ノードを追加します。
MediaPlayer 変数を引き出して Open Source ノードを使って Media Source (メディアソース) を MyImageSequence に設定し、以下のように接続します。
コンパイル して保存し、メインエディタから [Play (再生)] ボタンをクリックしてエディタ内で再生します。