Se usa un ejemplo de escala de tiempo de C++ para configurar una puerta de apertura clásica basada en la proximidad.
Cómo crear el actor de puerta
Crea el nuevo proyecto de C++ basado en una plantilla en blanco con contenido de inicio habilitado y denomínalo TimelineDoorActor.
Dirígete al explorador de contenido, haz clic en la carpeta C++ Classes y, a continuación, haz clic en el botón Añadir (+) y selecciona Nueva clase C++.
Selecciona Actor como clase padre.
Nombra al actor creado como DoorActor.
Cuando se crea un nuevo actor, Visual Studio abre automáticamente los archivos
DoorActor.hyDoorActor.cpp. Dirígete al archivoDoorActor.he introduce las siguientes declaraciones:DoorActor.h
C++#include "Components/TimelineComponent.h"A continuación, en la definición de la clase
DoorActor, añade el siguiente 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)Dirígete a
DoorActor.cpp. Tendrás que incluir la siguiente biblioteca de clases para usar el componente de caja.DoorActor.cpp
C++#include "Components/BoxComponent.h"En el constructor del
ADoorActor::ADoorActor, incorpora las siguientes declaraciones: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"));Nota: Mantenemos la transformación relativa de la puerta como regla de vinculación para poder manipularla más adelante con un método personalizado para nuestro actor de puerta. Para obtener más información, consulta FAttachmentTransformRules.
Compila el código.
Cómo configurar la malla estática de la puerta
Tendrás que configurar los recursos de malla estática que representarán visualmente tus componentes de malla estática DoorFrame y Door.
En el explorador de contenido, dirígete a la carpeta Clases de C++.
Haz clic derecho en la clase DoorActor y selecciona Crear clase de Blueprint basada en DoorActor.
Llama a tu actor de blueprint Bp_DoorActor y colócalo en la carpeta adecuada.
En la pestaña Componentes, selecciona el componente de malla estática DoorFrame.
Ve al panel Detalles y cambia la malla estática a SM_DoorFrame.
Dirígete a la pestaña Componentes y selecciona el componente DoorMesh.
En el panel de Detalles, cambia la Malla estática a SM_Door.
A continuación, ve a la categoría Transformar y cambia el valor de la posición Y a 45.0.
Haz clic en los botones Compilar y Guardar.
Cómo crear pistas de eventos de escala de tiempo y UCurveFloat
El componente de escala de tiempo requiere una Timeline Curve. Cada curva puede contener varias claves que definen un tiempo y un valor. Las curvas interpolan estas claves para calcular el valor en cualquier punto de la escala de tiempo.
Para este ejemplo, usaremos un UCurveFloat.
Dirígete a la definición de clase
ADoorActorenDoorActor.he introduce las siguientes declaraciones de variables: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 graphDirígete a
DoorActor.cppe implementa el 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); }A continuación, en el método
BeginPlay, añade el siguiente 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); }Compila el código.
Código en progreso
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;
Cómo crear y vincular eventos de colisión solapados
El componente de caja requiere la capacidad de reaccionar cuando un actor entra o sale de sus límites de colisión.
Dirígete a la definición de clase del archivo
DoorActor.he introduce las siguientes declaraciones: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);A continuación, dirígete al archivo
DoorActor.cpppara implementar los métodos de claseOnOverlapBeginyOnOverlapEnd: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(); }Vincula las funciones de solapamiento en el método
BeginPlay, de la siguiente manera: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) {Compila el código.
Cómo crear un recurso de curva en Unreal Editor
Debes crear un recurso de curva en Unreal Editor para asignarlo a tu blueprint de actor de escala de tiempo.
Navega hasta el explorador de contenido, selecciona Añadir (+) > Varios > Curva.
Selecciona CurveFloat y nombra al recurso DoorCurveFloat.
Haz doble clic en el DoorCurveFloat creado para abrir el editor de escala de tiempo.
Añade dos claves a la curva float. Para ello, haz clic derecho sobre el grafo y selecciona Añadir clave. Ajusta el valor de tiempo de la primera clave a (0, 0). Ajusta el valor de tiempo de la segunda clave a (4, 90).
Para obtener más información sobre cómo editar las curvas de la escala de tiempo, consulta la sección Keys and Curves.
Pulsa Mayús y haz clic para seleccionar las dos claves. Haz clic derecho en el grafo y establécelo en interpolación automática.
La curva ahora debería verse de la siguiente manera. Guarda el DoorCuveFloat y cierra el editor de escalas de tiempo.
Abre el Bp_DoorActor y selecciona el Bp_DoorActor en la pestaña Componentes.
Navega hasta el panel Detalles y selecciona DoorCurveFloat en el menú desplegable Curva flotante de la escala de tiempo de la puerta de la sección Acción de la puerta.
Dirígete al explorador de contenido e introduce el Bp_DoorActor en el nivel.
Compila y guarda. A continuación, pulsa PIE.
Al usar la entrada con WASD, puedes controlar al peón espectador. Al desplazarte hasta los límites de colisión del DoorActor, puedes observar que se reproduce la escala de tiempo, y al salir de los límites, puedes observar que se reproduce en 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;