Tetikleyici Bileşeni ve Tetiklenebilir Alt Sınıflar

Bu sayfa, trigger_component adlı yeni bir Scene Graph bileşeni oluştururken sana yol gösterir. Bu bileşen, tetiklenebilir arayüzü uygulayan bir Scene Graph bileşeninin bulunduğu varlıklar üzerinde eylemler tetikler. trigger_component, aracıların bir volume_device aracılığıyla Scene Graph ile etkileşime girmesini sağlar. Bir aracı volume_device cihazına girdiğinde veya cihazdan çıkış yaptığında karşılık gelen AgentEnteredEvent ve AgentExitedEvent olayı sinyal verilir ve Scene Graph bileşenleri ile varlıkları üzerinde eylem gerçekleştirmek üzere karşılık gelen geri çağırmalar yapılır.

Aşağıdaki görüntüde yerde bulunan beyaz platform, trigger_component bileşenine ve platformun etrafında görünmez volume_device cihazına sahip olan bir Scene Graph varlığıdır.

Oyuncu platforma bastığında trigger_component en sağdaki iki ışığı tetikler.

Oyuncu platformdan ayağını kaldırıp volume_device cihazından ayrıldığında ışıklar açık durumda kalır.

Bu sayfada kullanılan Verse dili özellikleri hakkında daha fazla bilgi için bkz.:

• Verse’te Arayüz

• Verse Kullanarak Kendi Bileşenini Oluşturma

Tetikleyici Bileşenini Tanımlama

1. Verse Gezgini’ne git, proje adına sağ tıkla ve Projeye yeni Verse dosyası ekle’yi seç.

   

2. Scene Graph Bileşeni şablonunu seç ve Bileşen Adı’nı trigger_component olarak değiştir.

   

3. trigger_component sınıfını tanımla ve bu bileşenin yalnızca alt öğeleri veya tüm tetiklenebilir alt öğeleri tetiklediğinden bağımsız olarak, ilişkili volume_device cihazına referans veren tüm alanları ve bu bileşenle etkileşimde bulunan tüm aracılara referans veren bir dizi ekle.

   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. Bir aracı bu bileşenin ilişkili volume_device cihazına girip çıktığında ne olacağını tanımlayan OnAgentEntersVolume ve OnAgentExitsVolume adlı fonksiyonlar ekle. Bir aracı etki aktörüne girdiğinde etkileşimdeki aracıyı kaydet ve triggerable arayüzünü uygulayan bir bileşene sahip olan alt varlıkları ara, ardından bu varlıklar üzerinde bileşeni tetikle. Bir aracı etki aktörüne girdiğinde etkileşimde bulunan aracıyı bu etki aktörüyle etkileşimde bulunan aracılar listesinden kaldır.

   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. OnAgentEntersVolume ve OnAgentExitsVolume fonksiyonlarını, bu bileşenin OnSimulate fonksiyonunda AgentEntersEvent ve AgentExitsEvent için geri çağırma fonksiyonları olarak kaydederek volume_device cihazına bağla.

   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)

Tetiklenebilir Bileşenleri Tanımlama

Ardından, daha önce oluşturulan tetiklenebilir arayüzü uygulayan bileşenleri tanımla. Bunlar puzzle_component bileşenine sahip bir varlığın alt öğeleri olan ve trigger_component bileşenine sahip bir üst varlık tarafından tetiklenen Scene Graph varlıklarına eklenen bileşenlerdir. Bu eğitimde üç farklı tetiklenebilir bileşen tanımlanır:

• triggerable_mesh_component: Varlığın mesh_component bileşeninin görünürlüğünü açıp kapatır.

• triggerable_light_component: Varlığın sphere_light_component bileşenini açıp kapatır ve varlığın mesh_component bileşenini, ışığın açık veya kapalı olmasına bağlı olarak, yayıcı renk olan veya olmayan bir bileşenle değiştirir.

• triggerable_movement_component: keyframed_movement_component kullanarak varlığın mesh_component bileşeninde bir dönüşüm tetikler.

Bu üç farklı bileşenin çok sayıda işlevselliği ortaktır ve fonksiyonların çoğu aynı şekilde tanımlanır. Başlangıçta TriggerableComponents.verse adlı yeni, boş bir Verse dosyası oluştur.

1. Aşağıdaki modülleri ekle:

   • /Verse.org/SceneGraph bileşeni çünkü bu dosya Scene Graph bileşenlerini ve Sahne Olaylarını kullanır.

   • /Verse.org/SceneGraph/KeyframedMovement çünkü bu dosya keyframed_movement_delta kullanır.

   • /Verse.org/Simulation çünkü bu dosya @editable özniteliğini kullanır.

   • /Verse.org/SpatialMath çünkü bu dosya Verse dönüşümleri kullanır.

   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. triggerable_mesh_component, triggerable_light_component ve triggerable_movement_component bileşenlerini tanımla. Bu bileşenlerin tümü, temel bileşen sınıfından devralır ve tetiklenebilir arayüzü uygular.

3. Üç bileşen de aynı üç olayı uygular:

   • OnReceive: Bu bileşen bir Sahne Olayı aldığında çağrılır.

   • OnBeginSimulation: Bileşenin simülasyona başlaması gerektiğinde çağrılır.

   • OnSimulate: Bileşen simülasyona başladığında çağrılır.

   Üç bileşenin tümüne aşağıdaki uygulamaları ekle.

   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. Tetiklenebilir bileşen bir bulmaca parçasıysa üç bileşenin tamamı bir triggered_event göndererek tetiklenebilir arayüz PostTrigger geçersiz kılmasını aynı şekilde uygular. Bunu tetiklenebilir arayüzün kendi içinde yapamazsın çünkü Verse’ün hangi varlığın tetiklendiğini bilmesi gerekir ve Varlık alanı, bileşen sınıfının bir parçasıdır ve bileşen sınıfına daha fazla bağımlılık olmadan tetiklenebilir arayüz tarafından kullanılamaz.

   Verse

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

   Copy full snippet(6 lines long)

Tetiklenebilir Örgü Bileşeni

triggerable_mesh_component, bir varlık üzerinde mesh_component görünürlüğünü açıp kapatır. Bunun için aşağıdaki tetiklenebilir arayüz fonksiyonlarına yönelik geçersiz kılmaların sağlanması gerekir:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

1. İlk tetiklenme durumu, örgü bileşeninin ayrıntılar panelinde ayarlandığı gibi örgünün oyun dünyasında görünür şekilde başlayıp başlamadığı kontrol edilerek belirlenir.

2. triggerable_mesh_component eylemi, mesh_component örgüsünü görünür yapmaktır. Bunu yapmak için karşılık gelen varlığa ilişkin mesh_component öğesini al, örgüyü görünür olarak ayarla, ardından triggerable_mesh_component bileşenini tetiklenmiş duruma ayarla.

   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. Tersine triggerable_mesh_component eylemi, mesh_component örgüsünü görünmez yapmaktır. Bunu yapmak için karşılık gelen varlığa ilişkin mesh_component öğesini al, örgüyü görünmez olarak ayarla, ardından triggerable_mesh_component bileşenini tetiklenmemiş duruma ayarla.

   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)

Tetiklenebilir Hareket Bileşeni

triggerable_movement_component, bir varlığı keyframed_movement_component kullanarak bir konumdan başka bir konuma sırayla hareket edecek şekilde tetikler. Bunun için aşağıdaki tetiklenebilir arayüz fonksiyonlarına yönelik geçersiz kılmaların sağlanması gerekir:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

Ayrıca bu bileşen birkaç yardımcı fonksiyon kullanır:

• GetMovementStates: Bu varlık için dönüşüm serisini tanımlayan alt varlıkların dönüşümlerini al.

• MakeDeltaTransform: İki girdi dönüşümü arasında bir delta dönüşüm oluştur.

• ConstructKeyframeDeltas: keyframed_movement_component girdisi için keyframed_movement_delta objelerinden oluşan bir dizi oluştur.

• SetAndPlayAnimation: Anahtar kareleri ata ve hareket animasyonunu oynat.

1. Bu sınıfa anahtar kareli animasyonun ne kadar süreceğini belirleyen bir kayan sayı ekle.

   Verse

       @editable
       Duration:float = 2.0
   

   Copy full snippet(2 lines long)

2. Bu sınıf, tetiklenebilir arayüzü uygular, bu nedenle varsayılan uygulamaları olmayan PerformAction ve PerformReverseAction fonksiyonları için geçersiz kılmaların sağlanması gerekir. Başlangıçta bir tetiklenme durumu olmadığından ve eylem konumlar arasında bir hareket olduğundan varsayılan başlangıçta tetiklenme durumu false olur. Temel uygulamanın tetiklenebilir arayüzde yaptığı şey budur, dolayısıyla bu fonksiyon bu bileşen sınıfında bir geçersiz kılma gerektirmez.

3. triggerable_movement_component eylemi, varlığı alt varlıklar tarafından tanımlanan dönüşüm serisi boyunca taşımaktır.

   Verse

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

   Copy full snippet(4 lines long)

4. Tersine Triggerable_movement_component eylemi, varlığı alt varlıklar tarafından tanımlanan dönüşüm serisi boyunca ters yönde taşımaktır. Bu fonksiyon, dönüşüm dizisinin ters sırada olması dışında PerformAction ile benzerdir.

   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. Bu bileşenin kullandığı yardımcı fonksiyonları tanımla. İlk olarak, bu hareketin yöneldiği dönüşümleri almak için GetMovementStates adlı bir fonksiyon oluştur.

   Verse

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

   Copy full snippet(3 lines long)

6. İki dönüşüm arasında delta dönüşüm oluşturan MakeDeltaTransform adlı bir yardımcı fonksiyon tanımla. A dönüşümünden B dönüşümüne D delta dönüşümü, D dönüşümü A dönüşümüne uygulandığında sonucun B dönüşümü olduğu bir dönüşümdür. 

   Bu tanımı genişletmek için, geçerli A dönüşümüne sahip bir Scene Graph varlığın olduğunu, ancak varlığı B dönüşümüne sahip olacak şekilde ölçeklendirmek, döndürmek ve taşımak istediğini varsayalım. D delta dönüşümü, bir keyframed_movement_delta varlığının A dönüşümünden B dönüşümüne geçiş hareketine animasyon uygulamak için gereken dönüşümdür.  

   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. keyframed_movement_component animasyonunun girdisi olarak bir keyframed_movement_delta obje dizisi oluşturan ConstructKeyframeDelta adlı bir yardımcı tanımla.

   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. keyframed_movement_delta dizisini keyframed_movement_component animasyonuna atayan ve oynatan SetAndPlayAnimation adlı bir fonksiyon oluştur.

   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)

Tetiklenebilir Işık Bileşeni

triggerable_light_component bir ışığı açar ve kapatır. Bunun için aşağıdaki tetiklenebilir arayüz fonksiyonlarına yönelik geçersiz kılmaların sağlanması gerekir:

• SetInitialTriggeredState

• PerformAction

• PerformReverseAction

1. Işığın başlangıçtaki tetiklenmiş durumu, ışığın açık olup olmadığına göre belirlenir, bu nedenle SetInitialTriggeredState ışığın zaten açık olup olmadığını kontrol eder ve açıksa başlangıçta tetiklendi olarak ayarlar.

   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. triggerable_light_component tarafından gerçekleştirilen eylem, ışığı açmak ve ışığın açık olduğunu gösteren bir örgüye geçmektir.

   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. triggerable_light_component tarafından gerçekleştirilen eylem, ışığı kapatmak ve yayıcı olmayan mesh_component bileşenini görünür olarak ayarlamaktır.

   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)

Sonraki Adımlar

Verse kodunun tamamı yazıldığına göre artık Verse kodunu oluştur. Ardından, kendi bulmaca deneyimini oluşturmak için temel varlıklar ve bileşenlerle UEFN’de yeniden kullanabileceğin prefablar inşa et.

Nihai Kod

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 #>

• 

  Prefab Oluşturma

  Prefablar ve bir bulmaca oluşturmak için önceden tanımlanmış bileşenleri kullan.