連番画像を再生する

  1. クイックスタート
  2. サポートされている画像形式
  3. フレームマーカー
  4. ギャップの外挿
  5. 曲線の編集　（エディターのみ）
  6. StreamingImageSequencePlayableAsset

クイックスタート

空のシーンから、次の手順を実行して下さい。

  1. 空の GameObject を作成し、Director コンポーネントを追加する。
  2. Unity プロジェクト内のフォルダー（StreamingAssets 配下のフォルダーが推奨されます）内の画像シーケンスをコピーする。 > StreamingAssets 配下のフォルダーにコピーすると、これらの画像を Unity にインポートするプロセスを省くことができます（画像の数が多い場合にはこのインポートプロセスに時間が掛かる場合があります）。
  3. Timeline ウィンドウを開く。

  4. Timeline ウィンドウに StreamingImageSequenceTrack を追加する。

    AddStreamingImageSequenceTrack

  5. 追加した StreamingImageSequenceTrack に画像シーケンスの入ったフォルダーをドラッグアンドドロップする。 これにより、フォルダー内の画像を使った StreamingImageSequencePlayableAsset が自動的に生成されます。

    DragAndDropFolder

  6. メニューを GameObject > UI > Image の順にクリックして Image オブジェクトを作成する。

  7. 作成した Image オブジェクトを、StreamingImageSequenceTrack のオブジェクトプロパティーにドラッグアンドドロップし Create StreamingImageSequenceRenderer on Image をクリックする。

    CreateStreamingImageSequenceNativeRenderer

フォルダー内の画像シーケンスが Image オブジェクトの中に表示されます。 Timeline を再生したり、Timeline ウィンドウのタイムスライダーをドラッグすると、 Image オブジェクトの Renderer コンポネントが更新されます。

画像をインポートする他の方法については、 画像をインポート を参照してください。

サポートされている画像形式

Windows Mac Linux
png ✅ ✅ ✅
tga ✅ ✅ ✅

フレームマーカー

すべてのフレームが フレームマーカー を持っています。 これは特定のフレームに割り当てられた画像をスキップし、 そのフレームの直前に使われた画像を代わりに表示するために使います。

FrameMarker

詳細に関してはフレームマーカーを参照してください。

ギャップの外挿

StreamingImageSequencePlayableAssetExtrapolation

StreamingImageSequence クリップの前後のギャップの動作は、 Animation クリップのギャップの外挿の設定のと同様、 下記のオプションで設定できます：

  1. None (デフォルト): Renderer コンポーネントを非アクティブにし、バインドされたオブジェクトを非表示にする。
  2. Hold: ギャップ内に連番の最初、または最後のフレームを表示し続ける。
  3. Loop: 同じクリップの長さで、連番をループする。
  4. Ping Pong: 同じクリップの長さで、連番を逆方向にループし、次に順方向にループする。
  5. Continue: Hold と同じ。

デフォルトでは、StreamingImageSequence は Pre-Extrapolate と Post-Extrapolate プロパティの両方を None に設定します。

曲線の編集（エディターのみ）

エディターでは、再生のタイミングを次のように変更できます。

  1. 曲線のセクションを開く
  2. 曲線を右クリックして、キーを追加する
  3. 追加されたキーを動かす

現状、この機能はエディターでのみサポートされており、実行時の再生のタイミングは常にリニアになります。

StreamingImageSequenceCurve

StreamingImageSequencePlayableAsset

StreamingImageSequencePlayableAsset は、 Unity Timeline で 連番画像を再生する為に使われる PlayableAsset です。
インスペクターで下記のプロパティを確認または変更することができます。

StreamingImageSequencePlayableAsset

  • Resolution（読み取り専用）
    フォルダー内の最初の画像の幅と高さを表示します。
  • Folder
    画像ファイルが入っているフォルダーです。
  • Images
    フォルダー内の画像です。 画像ファイルの名前を上下にドラッグアンドドロップして並び替えることができます。
  • Show FrameMarkers
    各フレームのフレームマーカーの表示・非表示を切り替えます。
    • Reset
      フレームマーカーの編集をリセットします。

  • Background Colors.

    • In Timeline Window
      Timeline ウィンドウのプレビュー画像の背景色。

  • Reset Curve。 プレイアブルアセット内の曲線のタイミングをリニアにリセットします。