Um exemplo de linha do tempo em C++ é usado para definir uma porta clássica que se abre com base na proximidade.
Como criar o ator de porta
Crie o projeto C++ baseado no modelo Blank com Conteúdo Inicial habilitado e nomeie como TimelineDoorActor.
Vá até o Navegador de Conteúdo, clique na pasta Classes de C++ e, em seguida, clique no botão Adicionar (+) e selecione Nova classe C++.
Selecione Ator como uma Classe Pai.
Nomeie o Ator criado como DoorActor.
Quando um novo Ator é criado, o Visual Studio abre automaticamente os arquivos
DoorActor.heDoorActor.cpp. Vá até o arquivoDoorActor.he declare o seguinte:DoorActor.h
C++#include "Components/TimelineComponent.h"Em seguida, na definição da classe
DoorActor, adicione o seguinte código:DoorActor.h
C++protected: //MeshComponents to represent Door assets UPROPERTY(VisibleAnywhere, BlueprintReadWrite) UStaticMeshComponent* DoorFrame; UPROPERTY(VisibleAnywhere, BlueprintReadWrite) UStaticMeshComponent* Door; //TimelineComponent to animate Door meshes UPROPERTY(VisibleAnywhere, BlueprintReadWrite)Vá até
DoorActor.cpp. Você precisará incluir a biblioteca de classe a seguir para utilizar o Componente de caixa.DoorActor.cpp
C++#include "Components/BoxComponent.h"No construtor do
ADoorActor::ADoorActor, declare o seguinte:DoorActor.cpp
C++// Sets default values ADoorActor::ADoorActor() { // 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; //Create our Default Components DoorFrame = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("DoorFrameMesh")); Door = CreateDefaultSubobject<UStaticMeshComponent>(TEXT("DoorMesh")); DoorTimelineComp = CreateDefaultSubobject<UTimelineComponent>(TEXT("DoorTimelineComp"));Observação: mantemos a transformação relativa da porta como uma regra de anexo para manipulá-la depois com um método personalizado para o Ator de porta. Para obter mais documentação, consulte FAttachmentTransformRules.
Compile o código.
Como configurar a Malha Estática da porta
Você precisará definir os ativos de Malha estática que representarão visualmente os componentes de DoorFrame e de malha estática de porta.
No Navegador de Conteúdo, vá até a sua pasta de Classes C++.
Clique com o botão direito na classe DoorActor e selecione Criar classe de Blueprint com base em DoorActor.
Nomeie o ator de Blueprint como Bp_DoorActor e coloque-o na pasta apropriada.
Na aba Componentes, selecione o componente de malha estática DoorFrame.
Vá até o painel Detalhes e altere a Malha Estática para SM_DoorFrame.
Vá até a aba Componentes e selecione o componente DoorMesh.
No painel Detalhes, altere a Malha Estática para SM_Door.
Em seguida, vá até a categoria Transformação e altere o valor de Posição Y para 45,0.
Clique nos botões Compilar e Salvar.
Como criar faixas de evento de linha do tempo e UCurveFloat
O Componente de linha do tempo requer uma Curva de linha do tempo. Cada curva pode conter várias chaves que definem um tempo e um valor. As curvas interpolam essas chaves para calcular o valor em qualquer ponto na linha do tempo.
Para este exemplo, usaremos um UCurveFloat.
Vá até a definição de classe
ADoorActoremDoorActor.he declare as seguintes variáveis:DoorActor.h
C++public: // Variable to hold the Curve asset UPROPERTY(EditAnywhere) UCurveFloat* DoorTimelineFloatCurve; private: //Float Track Signature to handle our update track event FOnTimelineFloat UpdateFunctionFloat; //Function which updates our Door's relative location with the timeline graphVá até
DoorActor.cppe implemente o métodoUpdateTimelineComp:DoorActor.cpp
C++void ADoorActor::UpdateTimelineComp(float Output) { // Create and set our Door's new relative location based on the output from our Timeline Curve FRotator DoorNewRotation = FRotator(0.0f, Output, 0.f); Door->SetRelativeRotation(DoorNewRotation); }Em seguida, no método
BeginPlay, adicione o seguinte código:DoorActor.cpp
C++//Binding our float track to our UpdateTimelineComp Function's output UpdateFunctionFloat.BindDynamic(this, &ADoorActor::UpdateTimelineComp); //If we have a float curve, bind it's graph to our update function if (DoorTimelineFloatCurve) { DoorTimelineComp->AddInterpFloat(DoorTimelineFloatCurve, UpdateFunctionFloat); }Compile o código.
Código em andamento
DoorActor.h
// Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.
#pragma once
#include "Components/TimelineComponent.h"
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "DoorActor.generated.h"
UCLASS()
class TIMELINEDOORACTOR_API ADoorActor : public AActor
{
DoorActor.cpp
//Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.
#include "DoorActor.h"
#include "Components/BoxComponent.h"
// Sets default values
ADoorActor::ADoorActor()
{
// 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;
Como criar e vincular eventos de sobreposição de colisão
O componente de caixa precisa ter a capacidade de reagir quando um ator entra ou sai de seus limites de colisão.
Vá até a definição de classe do seu arquivo
DoorActor.he declare o seguinte:DoorActor.h
C++// Begin and End Overlap Events for our DoorProxVolume UFUNCTION() void OnOverlapBegin(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult& SweepResult); UFUNCTION() void OnOverlapEnd(class UPrimitiveComponent* OverlappedComp, class AActor* OtherActor, class UPrimitiveComponent* OtherComp, int32 OtherBodyIndex);Em seguida, vá até o arquivo
DoorActor.cpppara implementar os métodos de classeOnOverlapBegineOnOverlapEnd:DoorActor.cpp
C++void ADoorActor::OnOverlapBegin(UPrimitiveComponent * OverlappedComp, AActor * OtherActor, UPrimitiveComponent * OtherComp, int32 OtherBodyIndex, bool bFromSweep, const FHitResult & SweepResult) { DoorTimelineComp->Play(); } void ADoorActor::OnOverlapEnd(UPrimitiveComponent * OverlappedComp, AActor * OtherActor, UPrimitiveComponent * OtherComp, int32 OtherBodyIndex) { DoorTimelineComp->Reverse(); }Vincule as funções de sobreposição no método
BeginPlayda seguinte maneira:DoorActor.cpp
C++void ADoorActor::BeginPlay() { Super::BeginPlay(); //Binding our float track to our UpdateTimelineComp Function's output UpdateFunctionFloat.BindDynamic(this, &ADoorActor::UpdateTimelineComp); //If we have a float curve, bind it's graph to our update function if (DoorTimelineFloatCurve) {Compile o código.
Como criar um ativo de curva no Unreal Editor
Você deve criar um ativo de curva no Unreal Editor para atribuí-lo ao Blueprint de Ator de linha do tempo.
Navegue até o Navegador de Conteúdo, selecione Adicionar (+) > Diversos > Curva.
Selecione CurveFloat e nomeie o ativo DoorCurveFloat.
Clique duas vezes no DoorCurveFloat criado para abrir o Editor de linha do tempo.
Adicione duas chaves à curva float clicando com o botão direito em Gráfico e selecione Adicionar chave. Ajuste o valor de tempo da primeira chave para (0, 0). Ajuste o valor de tempo da segunda chave para (4, 90).
Para obter mais informações sobre a edição de curvas da linha do tempo, consulte Chaves e curvas.
Pressione SHIFT e clique para selecionar as duas chaves, depois clique com o botão direito no Gráfico e defina-as como Interpolação automática.
Sua curva agora deve ter a seguinte aparência. Salve o DoorCuveFloat e feche o Editor de linha do tempo.
Abra o Bp_DoorActor e selecione Bp_DoorActor na aba Componentes.
Vá até o painel Detalhes e selecione DoorCurveFloat no menu suspenso Curva float de linha do tempo da porta da seção Ação da porta.
Vá até o Navegador de Conteúdo e posicione o Bp_DoorActor no nível.
Compile e salve, depois pressione JNE.
Usando entrada com WASD, você pode controlar o Pawn de espectador. Ao navegar até os limites de colisão do seu DoorActor, você pode observar a reprodução na linha do tempo. Ao sair dos limites, você pode observar a reprodução no sentido inverso.
Código finalizado
DoorActor.h
// Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.
#pragma once
#include "Components/TimelineComponent.h"
#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "DoorActor.generated.h"
UCLASS()
class TIMELINEDOORACTOR_API ADoorActor : public AActor
DoorActor.cpp
// Copyright 1998-2022 Epic Games, Inc. All Rights Reserved.
#include "DoorActor.h"
#include "Components/BoxComponent.h"
// Sets default values
ADoorActor::ADoorActor()
{
// 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;