Un exemple de chronologie C++ est utilisé pour configurer une porte dont l'ouverture est basée sur la proximité.
Créer l'acteur de porte
Créez le nouveau projet C++ basé sur un modèle vide en activant le contenu de démarrage. Nommez-le TimelineDoorActor.
Accédez au navigateur de contenu, cliquez sur dossier Classes_C++, puis cliquez sur le bouton Ajouter (+) et sélectionnez Nouvelle classe C++.
Sélectionnez Acteur comme classe parente.
Nommez l'acteur créé DoorActor.
Dés qu'un nouvel acteur est créé, Visual Studio ouvre automatiquement les fichiers
DoorActor.hetDoorActor.cpp. Accédez au fichierDoorActor.het déclarez ce qui suit :DoorActor.h
C++#include "Components/TimelineComponent.h"Ensuite, dans la définition de classe
DoorActor, ajoutez le code suivant :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)Accédez à
DoorActor.cpp. Vous devez inclure la bibliothèque de classes suivante pour utiliser votre composant de boîte.DoorActor.cpp
C++#include "Components/BoxComponent.h"Dans le constructeur de votre
ADoorActor::ADoorActor, déclarez ce qui suit :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"));Remarque : nous conservons la transformation relative de la porte comme règle de fixation afin de pouvoir la manipuler ultérieurement avec une méthode personnalisée pour notre acteur de porte. Pour en savoir plus, consultez la rubrique FAttachmentTransformRules.
Compilez votre code.
Configurer le maillage statique de porte
Vous devez configurer les ressources de maillage statique qui représenteront visuellement vos composants de maillage statique DoorFrame et Door.
Dans le navigateur de contenu, accédez à votre dossier Classes_C++.
Faites un clic droit sur votre classe DoorActor, puis sélectionnez Créer une classe de blueprint basée sur DoorActor.
Nommez votre blueprint d'acteur Bp_DoorActor et placez-le dans le dossier approprié.
Dans l'onglet Composants, sélectionnez le composant de maillage statique DoorFrame.
Accédez au panneau Détails et définissez SM_DoorFrame comme maillage statique.
Accédez à l'onglet Composants et sélectionnez le composant DoorMesh.
Dans le panneau Détails, définissez SM_Door comme maillage statique.
Ensuite, accédez à la catégorie Transformer et définissez la valeur de Emplacement Y sur 45,0.
Cliquez sur les boutons Compiler et Enregistrer.
Créer des pistes d'événements UCurveFloat et Timeline
Le composant de chronologie nécessite une courbe de chronologie. Chaque courbe peut contenir plusieurs clés qui définissent la durée et la valeur. Les courbes interpolent ces clés pour calculer la valeur à tout moment de la chronologie.
Dans cet exemple, nous utilisons UCurveFloat.
Accédez à la définition de la classe
ADoorActordansDoorActor.het déclarez les variables suivantes :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 graphAccédez à
DoorActor.cppet implémentez la méthodeUpdateTimelineComp: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); }Ensuite, dans la méthode
BeginPlay, ajoutez le code suivant :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); }Compilez votre code.
Code en cours de réalisation
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;
Créer et lier des événements de chevauchement de collision
Le composant de boîte doit pouvoir réagir lorsqu'un acteur entre dans les limites de collision ou en sort.
Accédez à la définition de classe de votre
DoorActor.het déclarez ce qui suit :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);Accédez ensuite au fichier
DoorActor.cpppour implémenter vos méthodes de classeOnOverlapBeginetOnOverlapEnd: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(); }Liez vos fonctions de chevauchement dans la méthode
BeginPlay, comme suit :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) {Compilez votre code.
Créer une ressource de courbe dans l'Unreal Editor
Vous devez créer une ressource de courbe dans l'Unreal Editor pour l'attribuer à votre blueprint d'acteur de chronologie.
Accédez au navigateur de contenu, puis sélectionnez Ajouter (+) > Divers > Courbe.
Sélectionnez CurveFloat et nommez la ressource DoorCurveFloat.
Double-cliquez sur DoorCurveFloat pour ouvrir l'éditeur de chronologie.
Ajoutez deux clés à la courbe de float en faisant un clic droit sur le graphique, puis sélectionnez Ajouter une clé. Ajustez la valeur-temps de la première clé sur (0, 0). Ajustez la valeur-temps de la deuxième clé sur (4, 90).
Pour en savoir plus sur la modification des courbes de chronologie, consultez la rubrique Clés et courbes.
Appuyez sur la touche Maj et cliquez pour sélectionner les deux clés, puis faites un clic droit sur le graphique et définissez-les sur l'interpolation automatique.
Votre courbe doit maintenant ressembler à ceci. Enregistrez DoorCaveFloat et fermez l'éditeur de chronologie.
Ouvrez votre Bp_DoorActor et sélectionnez Bp_DoorActor dans l'onglet Composants.
Accédez au panneau Détails et sélectionnez DoorCurveFloat dans le menu déroulant Courbe de float de chronologie de la porte de la section Action de porte.
Accédez au navigateur de contenu et placez Bp_DoorActor dans le niveau.
Cliquez sur Compiler et Enregistrer, puis appuyez sur PIE.
Utilisez les touches WASD pour contrôler votre pion spectateur. Lorsque vous vous déplacez vers les limites de collision de votre composant DoorActor, la lecture de la chronologie commence ; lorsque vous sortez des limites, la chronologie est jouée à l'envers.
Code final
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;