Unreal Engine 5 ドキュメントは Epic Developer Community に移動しました

Timeline ノードの作成

このドキュメントは、ブループリントで **Timeline** ノードを作成する方法の概要です。

Choose your operating system:

Windows

macOS

Linux

実装方法を選んでください。

Blueprints

C++

タイムラインの作成

以下の手順に従って、 Actor ブループリントに独自の Timeline Component を作成することができます。

  1. コンテンツ ブラウザ を開いて、 Add/Import > [Blueprint Class] の順に選択し、 BP_TimelineActor という名前の Actor Blueprint を新規作成します。 [Pick Parent Class] ダイアログが表示されます。

    image alt text

  2. クラス デフォルトで、 イベント グラフ を右クリックし、[Blueprint Context Menu] を表示して [Add Timeline (タイムラインを追加)] を選択します。

    image alt text

イベントグラフに新しい Timeline ノードが表示されます。

image alt text

Blueprint クラスに Timeline が追加されると、 [My Blueprint] タブのリストで確認することができます。

image alt text

Timeline 変数

作成された Timeline は、 [My Blueprint] タブで変数として利用できるようになっています。それにより Timeline コンポーネントに参照が提供されるので、Timeline ノードを利用しなければいけない時に特に便利です。これらのノードは、再生レートなどの Timeline の一定の機能へアクセスするために存在します。

image alt text

このサンプルでは、 Get Timeline 0 変数を使って、そのタイムラインの現在の Play Rate 値をクエリします。

image alt text

これらの様々なノードを使って、値をクエリし Timeline ノードの動作を制御することができます。利用可能な Timeline ノードおよびその機能の一覧は、「 Timeline ノード 」をご覧ください。

Timeline イベントを作成する

Timeline イベント ( FOnTimelineEvent ) は、Timeline Component にイベントを処理する機能を提供します。以下の手順は、独自のイベントを追加する方法の例です。

  1. BP_TimelineActor を開き、 Begin play から execution pin を選択して引き出し、Timeline Component の Play 実行ピンにつなぎます。

    image alt text

  2. 次に、 Finished 実行ピンを引き出し、文字列 " Timeline Finished " を付けて print string node を新規作成します。

  3. コンパイル して 保存 し、 PIE を押します。

    image alt text

    デフォルトのタイムライン 長 である 5 秒後に、テキスト "Timeline Finished" がビューポートの左上隅に表示されます。

タイムラインの名前を変更する

ブループリントで複数のタイムラインを使用する場合は、それぞれのタイムラインに適切な名前を付けることが重要です。すべてのタイムラインはデフォルトでは、 "Timeline_n" の最後に連番が付いた名前になっています。タイムラインの名前変更は、[Graph] タブまたは [My Blueprint] タブ内でタイムラインを右クリックするか、 [Rename (名前を変更)] を選択します。

image alt text

image alt text

タイムライン エディタを開く

タイムラインを作成しても、実行する何かを設定しない限り、役に立たない場合があります。タイムラインの編集に関する詳細は、「 タイムラインの編集 」を参照してください。

タイムラインを作成する

以下の手順に従って、 Actor クラスに独自の Timeline Component を作成およびインスタンス化することができます。

  1. 「 C++ Classes 」フォルダへ移動し、 コンテンツ ブラウザ ウィンドウ を右クリックします。ドロップダウン メニューから New C++ class を選択します。

  2. Timeline Actor という名前のアクタを新規作成します。

    ClassWizard.png

「TimelineActor.h」ファイルへ移動します。以下の Timeline Component ライブラリをインクルードして機能を使用します。 

include "Components/TimelineComponent.h

TimelineActor クラス定義内で以下のクラス宣言を実装します。 

protected:
    UPROPERTY(EditAnywhere, BlueprintReadWrite)
    UTimelineComponent* ExampleTimelineComp;

このコード サンプルでは、 プロパティ指定子 、 EditAnywhere 、 BlueprintReadWrite を使用します。

  1. デフォルトのサブオブジェクト テンプレートを使って Timeline Component をインスタンス化し、以下のコードを TimelineActor コンストラクタ ATimelineActor::ATimelineActor: に追加します。 

    ExampleTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("TimelineComponent"));

  2. Unreal Editor から [Compile] を選択してコードを ホット リロード します。

    HotReloadCompile.png

C++ クラス フォルダで TimelineActor を右クリックし、TimelineActor クラスからブループリントを派生させ、 Bp_TimelineActor と名前を付けます。 

![](BpTimelineActor.png)

TimelineActor ブループリントが作成されると、 Class Defaults を表示することができます。 [Components] タブで Example Timeline Component を確認することができます。

ClassDefaults.png

タイムライン変数

UProperty 指定子を使って C++ にタイムライン コンポーネントを作成すると、[Component] タブで変数として使用することができるようになります。デザイナーがブループリント スクリプティングを介して TimelineComponent へのイタレーションを継続したい場合、 これは便利な場合があります。

ExamplePlayRate.png

上の画像では、ネイティブ C++ タイムライン変数を使って、ブループリントで Timeline の Current Play Rate 値を取得します。

利用可能な Timeline ノード、およびその機能の一覧は、「 Timeline ノード 」を参照してください。

FTimeLineEvent を作成する

タイムライン イベント ( FOnTimelineEvent ) は、Timeline Component にイベントを処理する機能を提供する デリゲート です。 以下の手順に従って、使用する Timeline Component の完成した機能に結合される FTimeLineEvent を作成します。

  1. TimelineActor.h file に移動し、 class definition で以下のコードを宣言します。 

    protected:
    //Delegate signature for the function which will handle our Finished event.
    FOnTimelineEvent TimelineFinishedEvent;

UFUNCTION()
void TimelineFinishedFunction();

  2. 次に、 TimelineActor.cpp の TimelineFinishedFunction に以下のコードを実装します。 

    UE_LOG(LogTemp, Warning, TEXT("Finished Event Called."));

  3. void ATimelineActor::BeginPlay() メソッドに移動し、以下のコードを実装します。 

    Super::BeginPlay();

    これで TimelineFinished Event をカスタムした TimelineFinished 関数に結合することができました。

  4. 最後に、エディタでコードをコンパイルし、Bp_TimelineActor のインスタンスをレベルにドラッグします。[Play In Editor (PIE)] を押します。

[Output Log] ウィンドウに以下のメッセージが表示されます。 

![](OutputMessage.png)
Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル