Como criar linhas do tempo

Como criar linhas do tempo

Você pode criar e instanciar seu próprio componente de linha do tempo em uma classe de ator seguindo as etapas a seguir.

1. Vá para a pasta Classes C++ e clicar em Add+. No menu suspenso, selecione Nova classe C++.

   

2. Selecione a classe de Ator como uma Classe pai.

   

3. O nome da classe de ator Ator de linha do tempo criada.

   

4. Vá até o arquivo TimelineActor.h e inclua a biblioteca de classe TimelineComponent a seguir.

   TimelineActor.h

   C++

   #include "Components/TimelineComponent.h"

   Copy full snippet(1 line long)

5. Implemente a seguinte declaração de classe dentro da definição de classe TimelineActor:

   TimelineActor.h

   C++

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

   Copy full snippet(4 lines long)

   Nesta amostra de código, você usará as tags do especificador de propriedade EditAnywhere e BlueprintReadWrite.

6. Vá até o arquivo TimelineActor.cpp e adicione o código a seguir ao construtor TimelineActor:ATimelineActor::ATimelineActor().

   TimelineActor.cpp

   C++

   ATimelineActor::ATimelineActor()
        {
            // Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.
            PrimaryActorTick.bCanEverTick = true;
            ExampleTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("TimelineComponent"));
        }

   Copy full snippet(6 lines long)

7. Compile seu código.

8. Navegue até a pasta Classes C++, clique com o botão direito em TimelineActor e crie um Blueprint baseado na classe TimelineActor. Nomeie como Bp_TimelineActor.

   

9. Depois de criar o Blueprint TimelineActor, você poderá visualizar os padrões de classe. Na aba Componentes, você verá o componente de linha do tempo de exemplo.

   

Código em andamento

TimelineActor.h

#pragma once
	#include "Components/TimelineComponent.h"
	#include "CoreMinimal.h"
	#include "GameFramework/Actor.h"
	#include "TimelineActor.generated.h"

	UCLASS()
	class CPPTIMELINE_API ATimelineActor : public AActor
	{
		GENERATED_BODY()

TimelineActor.cpp

#include "TimelineActor.h"

	// Sets default values
	ATimelineActor::ATimelineActor()
	{
		// Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.
		PrimaryActorTick.bCanEverTick = true;
		ExampleTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("TimelineComponent"));
	}

Variáveis de linha do tempo

Quando você cria um componente de linha do tempo em C++ usando especificadores UProperty, ele ficará disponível como uma variável na aba Componentes. Isso pode ser útil para designers que gostariam de continuar fazendo iterações no TimelineComponent pelo script de Blueprint.

Para obter uma lista completa dos nós de linha do tempo de Blueprint disponíveis e suas funcionalidade, confira a página Nós da linha do tempo.

Como criar um FTimeLineEvent

Eventos de linha do tempo (FOnTimelineEvent) são delegados dinâmicos que fornecem funcionalidade a um componente de linha do tempo para processar um evento. Siga as etapas a seguir para criar um FTimeLineEvent que será vinculado à funcionalidade final do componente de linha do tempo.

1. Vá para o arquivo TimelineActor.h e declare o código a seguir na Definição de classe:

   TimelineActor.h

   C++

   protected:
   
            //Delegate signature for the function which will handle our Finished event.
            FOnTimelineEvent TimelineFinishedEvent;
   
            UFUNCTION()
            void TimelineFinishedFunction();

   Copy full snippet(7 lines long)

2. Navegue até TimelineActor.cpp e implemente o seguinte código:

   TimelineActor.cpp

   C++

   void ATimelineActor::TimelineFinishedFunction()
         {
            UE_LOG(LogTemp, Warning, TEXT("Finished Event Called."));
         }

   Copy full snippet(4 lines long)

3. Navegue até o método ATimelineActor::BeginPlay() e implemente o seguinte código:

   TimelineActor.cpp

   C++

   // Called when the game starts or when spawned
   
        void ATimelineActor::BeginPlay()
        {
            Super::BeginPlay();
   
            TimelineFinishedEvent.BindUFunction(this, FName("TimelineFinishedFunction"));
            ExampleTimelineComp->SetTimelineFinishedFunc(TimelineFinishedEvent);
            ExampleTimelineComp->PlayFromStart();
        }

   Copy full snippet(10 lines long)

   Você vinculou com sucesso o evento TimelineFinished à função TimelineFinished personalizada.

4. Compile o código. Abra o Editor e vá para o Navegador de Conteúdo. Encontre o BP_TimelineActor e arraste-o para o nível.

   

5. Pressione o botão Reproduzir. Você deve ver a seguinte mensagem na janela do Log de Saída:

   

Código finalizado

TimelineActor.h

#pragma once
	#include "Components/TimelineComponent.h"
	#include "CoreMinimal.h"
	#include "GameFramework/Actor.h"
	#include "TimelineActor.generated.h"

	UCLASS()
	class CPPTIMELINE_API ATimelineActor : public AActor
	{
		GENERATED_BODY()

TimelineActor.cpp

#include "TimelineActor.h"

	// Sets default values
	ATimelineActor::ATimelineActor()
	{
		// Set this actor to call Tick() every frame.  You can turn this off to improve performance if you don't need it.
		PrimaryActorTick.bCanEverTick = true;
		ExampleTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("TimelineComponent"));
	}