Komponent wyzwalacza i aktywowane klasy pochodne

Ta strona poprowadzi cię przez proces tworzenia nowego komponentu Scene Graph o nazwie trigger_component. Ten komponent aktywuje akcje na jednostkach zawierających komponent Scene Graph implementujący możliwy do aktywowania interfejs. Komponent trigger_component umożliwia agentom interakcję z systemem Scene Graph za pośrednictwem volume_device. Gdy agent wejdzie do volume_device lub go opuści, sygnalizowane jest odpowiednie zdarzenie AgentEnteredEvent i AgentExitedEvent oraz wywoływane są odpowiednie wywołania zwrotne w celu wykonania działań na komponentach i jednostkach Scene Graph.

Na poniższej ilustracji biały cokół na ziemi jest jednostką Scene Graph z trigger_component i niewidocznym volume_device wokół cokołu.

Gdy gracz stanie na cokole, trigger_component aktywuje dwa światła najbardziej wysunięte w prawo.

Gdy gracz zejdzie z cokołu i opuści volume_device, światła pozostają włączone.

Aby dowiedzieć się więcej na temat funkcji języka Verse używanych na tej stronie, patrz:

• Interfejs w Verse

• Tworzenie własnego komponentu za pomocą Verse

Definiowanie komponentu wyzwalacza

1. Przejdź do Eksploratora Verse, kliknij prawym przyciskiem myszy nazwę projektu i wybierz opcję Dodaj nowy plik Verse do projektu.

   

2. Wybierz szablon Komponent Scene Graph i zmień nazwę komponentu na trigger_component.

   

3. Zdefiniuj klasę trigger_component i dodaj pola, które odwołują się do powiązanego volume_device, niezależnie od tego, czy ten komponent aktywuje tylko elementy podrzędne czy wszystkie możliwe do aktywowania elementy potomne, a także tablicę odwołującą się do wszystkich agentów wchodzących w interakcję z tym komponentem.

   Verse

   trigger_component := class<final_super>(component):
   
       # volume_device associated with this trigger_component
       @editable
       InteractionVolume<private>:volume_device = volume_device{}
   
       # whether or not this triggers on components on child entities
       @editable
       OnlyTriggerChildren:logic = false
   
   
   Expand code Copy full snippet(12 lines long)

4. Dodaj funkcje o nazwach OnAgentEntersVolume i OnAgentExitsVolume, które określają, co się stanie, gdy agent wejdzie do urządzenia volume_device powiązanego z tym komponentem i z niego wyjdzie. Gdy agent wejdzie do wolumenu, zarejestruj agenta wchodzącego w interakcję i poszukaj jednostek potomnych, które mają komponent implementujący możliwy do aktywowania interfejs, a następnie aktywuj komponent w tych jednostkach. Gdy agent wejdzie do wolumenu, usuń agenta wchodzącego w interakcję z listy agentów wchodzących w interakcję z tym wolumenem.

   Verse

       # Event that is triggered when an Agent enters the InteractionVolume
       OnAgentEntersVolume(Agent:agent):void=
           for:
               ChosenEntity : Entity.FindDescendantEntities(entity)
               ChosenEntityComponent : ChosenEntity.GetComponents()
               CastToInterface := triggerable[ChosenEntityComponent]
           do:
               if (OnlyTriggerChildren?):
                   if (Entity = ChosenEntity.GetParent[]):
                       CastToInterface.Trigger()
   
   Expand code Copy full snippet(17 lines long)

5. Połącz funkcje OnAgentEntersVolume i OnAgentExitsVolume z volume_device, rejestrując je jako funkcje wywołania zwrotnego dla AgentEntersEvent i AgentExitsEvent w funkcji OnSimulate tego komponentu.

   Verse

       # Runs when the component should start simulating in a running game.
       OnBeginSimulation<override>():void =
           # Run OnBeginSimulation from the parent class before
           # running this component's OnBeginSimulation logic
           (super:)OnBeginSimulation()
   
       # Runs when the component should start simulating in a running game.
       # Can be suspended throughout the lifetime of the component. Suspensions
       # will be automatically cancelled when the component is disposed or the
       # game ends.
   
   Expand code Copy full snippet(15 lines long)

Definiowanie komponentów możliwych do aktywowania

Następnie zdefiniuj komponenty, które implementują utworzony wcześniej interfejs możliwy do aktywowania. Są to komponenty dodawane do jednostek Scene Graph, które są elementami potomnymi jednostki z puzzle_component i są aktywowane przez jednostkę będącą przodkiem z trigger_component. W tym samouczku zdefiniowano trzy różne komponenty możliwe do aktywowania:

• triggerable_mesh_component: Przełącza widoczność komponentu mesh_component jednostki.

• triggerable_light_component: Włącza i wyłącza komponent sphere_light_component jednostki oraz zamienia komponent mesh_component jednostki na taki z kolorem emisyjnym lub bez niego, w zależności od tego, czy światło jest włączone.

• triggerable_movement_component: Aktywuje przekształcenie komponentu mesh_component jednostki za pomocą komponentu keyframed_movement_component.

Te trzy różne komponenty mają wiele wspólnych funkcji, a wiele z nich definiuje się w ten sam sposób. Aby rozpocząć, utwórz nowy, pusty plik Verse o nazwie TriggerableComponents.verse.

1. Dołącz następujące moduły:

   • /Verse.org/SceneGraph, ponieważ ten plik wykorzystuje komponenty Scene Graph i zdarzenia sceny.

   • /Verse.org/SceneGraph/KeyframedMovement, ponieważ ten plik używa keyframed_movement_delta.

   • /Verse.org/Simulation, ponieważ ten plik używa atrybutu @editable.

   • /Verse.org/SpatialMath, ponieważ ten plik używa przekształceń Verse.

   Verse

   using { /Verse.org/SceneGraph }
   using { /Verse.org/SceneGraph/KeyframedMovement }
   using { /Verse.org/Simulation }
   using { /Verse.org/SpatialMath }
   

   Copy full snippet(4 lines long)

2. Zdefiniuj komponenty triggerable_mesh_component, triggerable_light_component i triggerable_movement_component. Wszystkie te komponenty dziedziczą z bazowej klasy komponentu i implementują interfejs możliwy do aktywowania.

3. Wszystkie trzy komponenty implementują te same trzy zdarzenia:

   • OnReceive: Opcja wywoływana, gdy ten komponent odbierze zdarzenie sceny.

   • OnBeginSimulation: Opcja wywoływana, gdy komponent powinien rozpocząć symulację.

   • OnSimulate: Opcja wywoływana, gdy komponent rozpoczyna symulację.

   Dodaj następujące implementacje do wszystkich trzech komponentów.

   Verse

       # Runs when this component receives a scene event
       OnReceive<override>(SceneEvent:scene_event):logic=
           if (PuzzleSolvedEvent := puzzle_solved_event[SceneEvent], not PuzzlePiece?):
               Trigger()
               true
           false
     
       # Runs when the component should start simulating in a running game.
       OnBeginSimulation<override>():void =
           # Run OnBeginSimulation from the parent class before
   
   Expand code Copy full snippet(20 lines long)

4. Wszystkie trzy komponenty implementują również zastąpienie możliwego do aktywacji interfejsu PostTrigger w ten sam sposób, wysyłając triggered_event w górę, jeśli komponent możliwy do aktywowania jest elementem łamigłówki. Nie można tego wykonać w samym interfejsie możliwym do aktywowania, ponieważ Verse musi wiedzieć, która jednostka jest aktywowana, a pole Jednostka jest częścią klasy komponentu i jest niedostępne dla interfejsu możliwego do aktywowania bez dodatkowej zależności od klasy komponentu.

   Verse

       PostTrigger<override>():void =
           if (PuzzlePiece?):
               Event := triggered_event:
                   Triggered := Triggered
                   TriggeredEntity := option{Entity}
               Entity.SendUp(Event)

   Copy full snippet(6 lines long)

Aktywowany komponent siatki

Komponent triggerable_mesh_component przełącza widoczność mesh_component na jednostce. Wymaga to wprowadzenia zastąpień dla następujących funkcji możliwego do aktywowania interfejsu:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

1. Początkowy stan aktywowania jest określany poprzez sprawdzenie, czy siatka na początku wyświetla się jako widoczna w świecie gry zgodnie z ustawieniami w panelu Szczegóły komponentu siatki.

2. Akcja triggerable_mesh_component polega na wyświetleniu siatki mesh_component. W tym celu pobierz mesh_component dla odpowiedniej jednostki, ustaw siatkę na widoczną, a następnie ustaw stan triggerable_mesh_component na aktywowany.

   Verse

       # Determine the initial triggered state of this component
       SetInitialTriggeredState<override>():void=
           if (MeshComponent := Entity.GetComponent[mesh_component], MeshComponent.Visible?):
                   set Triggered = true

   Copy full snippet(4 lines long)

3. Akcja odwrotna triggerable_mesh_component polega na ustawieniu niewidoczności siatki mesh_component. W tym celu pobierz mesh_component dla odpowiedniej jednostki, ustaw siatkę na niewidoczną, a następnie ustaw stan triggerable_mesh_component na nieaktywowany.

   Verse

       PerformReverseAction<override>():void =
           if (MeshComponent := Entity.GetComponent[mesh_component]):
               if (MeshComponent.Visible?):
                   set MeshComponent.Visible = false
                   set Triggered = false

   Copy full snippet(5 lines long)

Komponent ruchu z możliwością aktywowania

Komponent triggerable_movement_component aktywuje jednostkę, aby kolejno przemieściła się z jednej lokalizacji do serii innych lokalizacji za pomocą keyframed_movement_component. Wymaga to wprowadzenia zastąpień dla następujących funkcji możliwego do aktywowania interfejsu:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

Ponadto komponent ten wykorzystuje kilka funkcji pomocniczych:

• GetMovementStates: Pobiera przekształcenia jednostek podrzędnych definiujące serie przekształceń dla tej jednostki.

• MakeDeltaTransform: Tworzy przekształcenie delta między dwoma przekształceniami wejściowymi.

• ConstructKeyframeDeltas: Tworzy tablicę obiektów keyframed_movement_delta na potrzeby danych wejściowych do keyframed_movement_component.

• SetAndPlayAnimation: Przypisuje klatki kluczowe i odtwarza animację ruchu.

1. Dodaj do tej klasy edytowalną wartość zmiennopozycyjną, która określa czas trwania animacji z klatką kluczową.

   Verse

       @editable
       Duration:float = 2.0
   

   Copy full snippet(2 lines long)

2. Ta klasa implementuje interfejs możliwy do aktywowania, dlatego dla funkcji PerformAction i PerformReverseAction należy wprowadzić zastąpienia, ponieważ nie mają one domyślnych implementacji. Ponieważ nie ma początkowego stanu aktywowania, a akcja jest ruchem między lokalizacjami, domyślnym początkowym stanem aktywowania jest false. To właśnie implementacja bazowa wykonuje w interfejsie z możliwością aktywowania, więc funkcja ta nie wymaga zastąpienia w tej klasie komponentu.

3. Akcja triggerable_movement_component polega na przemieszczeniu jednostki wzdłuż serii przekształceń zdefiniowanych przez jednostki podrzędne.

   Verse

       PerformAction<override>():void =
           MovementStates := GetMovementStates()
           AnimationFrames:[]keyframed_movement_delta = ConstructKeyframeDeltas(MovementStates)
           SetAndPlayAnimation(AnimationFrames)
   

   Copy full snippet(4 lines long)

4. Akcja odwrotna triggerable_movement_component polega na przemieszczeniu jednostki wzdłuż serii przekształceń zdefiniowanych przez jednostki podrzędne w odwrotnej kolejności. Funkcja ta jest podobna do PerformAction, z tą różnicą, że tablica przekształcenia jest w odwrotnej kolejności.

   Verse

       PerformReverseAction<override>():void =
           MovementStates := GetMovementStates()
           ReversedMovementStates := for:
               Index := 0..MovementStates.Length - 1
               ReversedElement := MovementStates[MovementStates.Length - 1 - Index]
           do:
               ReversedElement
           AnimationFrames := ConstructKeyframeDeltas(ReversedMovementStates)
           SetAndPlayAnimation(AnimationFrames)
   

   Copy full snippet(9 lines long)

5. Zdefiniuj funkcje pomocnicze używane przez ten komponent. Najpierw utwórz funkcję o nazwie GetMovementStates, aby pobrać przekształcenia, do których przenosi się ten ruch.

   Verse

       GetMovementStates():[]transform=
           for (ChildEntity : Entity.FindDescendantEntities(entity), Entity = ChildEntity.GetParent[]):
               ChildEntity.GetGlobalTransform()
   

   Copy full snippet(3 lines long)

6. Zdefiniuj funkcję pomocniczą o nazwie MakeDeltaTransform, która konstruuje przekształcenie delta między dwoma przekształceniami. Przekształcenie delta, D, od przekształcenia A do przekształcenia B jest takim przekształceniem, że po zastosowaniu przekształcenia D do przekształcenia A wynikiem jest przekształcenie B. 

   Aby rozwinąć tę kwestię, załóżmy, że masz jednostkę Scene Graph z bieżącym przekształceniem A, ale chcesz ją skalować, obracać i przesunąć, aby miała przekształcenie B. Przekształcenie delta D to przekształcenie potrzebne, aby zdarzenie keyframed_movement_delta animowało ruch jednostki od przekształcenia A do przekształcenia B.  

   Verse

       MakeDeltaTransform(InTransformOne:transform, InTransformTwo:transform):transform =
           transform:
               Translation := InTransformTwo.Translation - InTransformOne.Translation
               Rotation := MakeComponentWiseDeltaRotation(InTransformOne.Rotation, InTransformTwo.Rotation)
               Scale := vector3:
                   Forward := InTransformTwo.Scale.Forward / InTransformOne.Scale.Forward
                   Right := InTransformTwo.Scale.Right / InTransformOne.Scale.Right
                   Up := InTransformTwo.Scale.Up / InTransformTwo.Scale.Up
   

   Copy full snippet(8 lines long)

7. Zdefiniuj funkcję pomocniczą o nazwie ConstructKeyframeDelta, która tworzy tablicę obiektów keyframed_movement_delta na potrzeby danych wejściowych w animacji keyframed_movement_component.

   Verse

       ConstructKeyframeDeltas<public>(MovementStates:[]transform):[]keyframed_movement_delta =
           var LastTransform:transform = Entity.GetGlobalTransform()
           for (EntityIndex -> CurrentTransform : MovementStates):
               DeltaTransform := MakeDeltaTransform(LastTransform, CurrentTransform)
               set LastTransform = CurrentTransform
               keyframed_movement_delta:
                   Transform := DeltaTransform
                   Duration := Duration
                   Easing := if (MovementStates.Length > 1):
                       if (EntityIndex = 0):
   
   Expand code Copy full snippet(17 lines long)

8. Utwórz funkcję o nazwie SetAndPlayAnimation, która przypisuje tablicę keyframed_movement_delta do animacji keyframed_movement_component i ją odtwarza.

   Verse

       SetAndPlayAnimation<private>(Frames:[]keyframed_movement_delta):void =
           if (KeyframedMovementComponent := Entity.GetComponent[keyframed_movement_component]):
               KeyframedMovementComponent.SetKeyframes(Frames, oneshot_keyframed_movement_playback_mode{})
               KeyframedMovementComponent.Play()
   

   Copy full snippet(4 lines long)

Komponent światła z możliwością aktywowania

Komponent triggerable_light_component włącza i wyłącza światło. Wymaga to wprowadzenia zastąpień dla następujących funkcji możliwego do aktywowania interfejsu:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

1. Początkowy stan aktywowania światła zależy od tego, czy światło jest włączone, dlatego SetInitialTriggeredState sprawdza, czy światło jest już włączone, a jeśli tak, ustawia je jako początkowo aktywowane.

   Verse

       # Determine the initial triggered state of this light
       SetInitialTriggeredState<override>():void=
           for:
               DescendantEntity : Entity.FindDescendantEntities(entity)
               Entity = DescendantEntity.GetParent[]
               MeshComponent := DescendantEntity.GetComponent[mesh_component]
               LightComponent := DescendantEntity.GetComponent[light_component]
               MeshComponent.IsEnabled[]
               LightComponent.IsEnabled[]
           do:
   
   Expand code Copy full snippet(11 lines long)

2. Akcja wykonywana przez triggerable_light_component polega na włączeniu światła i przełączeniu na siatkę wskazującą, że światło jest włączone.

   Verse

       PerformAction<override>():void=
           if (not IsLightOn?):
               for (DescendantEntity:Entity.FindDescendantEntities(entity), Entity = DescendantEntity.GetParent[]):
                   if (MeshComponent := DescendantEntity.GetComponent[mesh_component]):
                       if (LightComponent := DescendantEntity.GetComponent[light_component]):
                           MeshComponent.Enable()
                           LightComponent.Enable()
                       else:
                           MeshComponent.Disable()
               set IsLightOn = true
   
   Expand code Copy full snippet(11 lines long)

3. Akcja wykonywana przez triggerable_light_component polega na wyłączeniu światła i ustawieniu nieemisyjnego komponentu mesh_component na widoczny.

   Verse

       PerformReverseAction<override>():void=
           if (IsLightOn?):
               for (DescendantEntity:Entity.FindDescendantEntities(entity), Entity = DescendantEntity.GetParent[]):
                   if (MeshComponent := DescendantEntity.GetComponent[mesh_component]):
                       if (LightComponent := DescendantEntity.GetComponent[light_component]):
                           MeshComponent.Disable()
                           LightComponent.Disable()
                       else:
                           MeshComponent.Enable()
               set IsLightOn = false
   
   Expand code Copy full snippet(11 lines long)

Kolejne kroki

Po napisaniu całego kodu Verse skompiluj go. Następnie zbuduj gotowce z bazowych jednostek i komponentów, które wykorzystasz w UEFN do stworzenia swojej łamigłówki.

Kod końcowy

TriggerComponent.verse

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /Verse.org/SceneGraph }
using { Logging }

trigger_component<public> := class<final_super>(component):

    @editable
    InteractionVolume<private>:volume_device = volume_device{}

  TriggerableComponents.verse

using { /Verse.org/SceneGraph }
using { /Verse.org/SceneGraph/KeyframedMovement }
using { /Verse.org/Simulation }
using { /Verse.org/SpatialMath }

EnabledToolTip<public><localizes>:message = "Whether or not this component is enabled."

triggerable_mesh_component<public> := class<final_super>(component, triggerable):

    <# Triggerable interface #>

• 

  Tworzenie gotowców

  Użyj zdefiniowanych wcześniej komponentów, aby stworzyć gotowce i przygotować łamigłówkę.