Anahtar Kare Hareketi Bileşeni

Bileşenler, oyununu oluşturmak için veri ve mantık kullanan temel yapı taşlarıdır. Anahtar kare hareketi bileşeni, varlıklara animasyon anahtar kareleri ekleyip bunların bölümde belirtilen parametreler dahilinde akıcı şekilde hareket etmesini sağlar. 

UEFN’de, objelerin dünyadaki konumlarını Verse kodu ile TeleportTo() veya MoveTo() gibi fonksiyonlar kullanarak değiştirip hareket ettirebilirsin. Ancak, bu fonksiyonların Verse kodlarının her simülasyon güncellemesinde değerlendirilmesi gerektiğinden bu fonksiyonları kullanarak sorunsuz, sürekli hareket elde etmek zor olabilir. Objeleri konumlarını değiştirerek hareket ettirmek yerine animasyonlardan yararlanabilirsin. Obje ayarlanmış anahtar kareler arasında hareket ettiğinden ve bunu sunucu istemci gecikmeleriyle karşılaşmadan yaptığından, keyframed_movement_component bileşeni akıcı animasyonlar oluşturabilir. Bir dizi ray üzerinde akıcı bir şekilde hareket eden bir maden arabasını düşün. Bir anahtar kare hareketi bileşeni, bunu oluşturabilmen için iyi bir çözüm sunar. 

Varlığına bir bileşen eklemek için Varlıklar ve Bileşenlerle Çalışma bölümüne bakabilirsin. Bileşen, anahtar kare hareketi bileşeninin Verse sınıfıyla eşleşecek şekilde keyframed_movement_component olarak listelenmiştir. Bileşen için Verse API’si hakkında daha fazla bilgi için keyframed_movement_component API referans modülüne göz at.

Kodunda KeyframedMovement modülüne referans verdiğinde, seçili varlık üzerinde gerçekleştirebileceğin işlemlere erişebilirsin. Aşağıdaki örnekte, varlığı taşımak için @editable ve keyframe_movement_delta bileşeninin nasıl kullanılacağı gösteriliyor. 

Örnek

Bir varlığın bir dizi anahtar kare arasında hareket etmesini sağlamak için:

1. Projende bir varlıkoluştur. Bunu ilk kez yapıyorsan Varlıklar ve Bileşenlerle Çalışma bölümüne bak.

2. + Bileşen düğmesine tıkla ve bir mesh_component ekle. Küp örgüsünü seç.

3. Bir KeyframedMovement bileşeni ekle.

4. + Bileşen düğmesine tekrar tıkla ve bu sefer Yeni Verse Bileşeni seçeneğine git.

5. Bileşeni move_cycle_component olarak adlandır ve Oluştur düğmesine tıkla.

6. Visual Studio Code’da, KeyframedMovement modülünü { /UnrealEngine.com/Temporary/SceneGraph/KeyframedMovement }kullanarak belirle.

7. Dönüşümün çalışması için, { /Verse.org/SpatialMath } kullanarak belirttiğinden emin ol.

8. Move_cycle_component sınıfının üstüne, Anahtar Kareler adlı bir düzenlenebilir keyframed_movement_delta dizisi ekle. Editörde bir keyframed_movement_delta dizisini kullanıma açarak doğrudan ayrıntılar panelinden anahtar kareler oluşturabilir ve animasyondaki her anahtar kare için dönüşüm, süre ve yavaşlatma değerlerini ayarlayabilirsin.

# A Verse-authored component that can be added to entities
move_cycle_component<public> := class<final_super>(component):


    @editable
    var Keyframes:[]keyframed_movement_delta = array{}

Verse kodunu oluşturduktan sonra Anahtar Kareler editörde move_cycle_component altında görünür. + simgesine tıklayarak 2 dizi elemanı ekle.

Artık her dizi elemanının dönüşümünü, süresini ve yavaşlatma değerini değiştirebilirsin. Her dizi elemanı bir anahtar karenin eşdeğeridir. 

İlk elemanda dönüşümü genişlet ve ileri değerini 500 olarak ayarla. İkinci elemanda, sol değerini -500 olarak ayarla. Her iki eleman için de süreyi 2,0 (saniye), yavaşlatma değerini ise cubic_bezier_asset_function olarak ayarla.

İlk anahtar karenin örgünün dünyadaki konumuna göre olması gibi, ayarladığın her yeni anahtar karenin değerinin önceki anahtar kareye göre olduğunu unutmamalısın. 

Bir oturumu kaydedip başlattığında küpünün ayarladığın anahtar kareler arasında hareket ettiğini göreceksin:

Verse’te Anahtar Kareler Oluşturma

Anahtar kareleri Verse koduyla da oluşturabilirsin: 

1. Keyframed_movement_component öğesini al.

2. İlk anahtar karen olacak Key0’ı keyframed_movement_delta fonksiyonunu çağırıp dönüşüm, süre ve yavaşlatma değerlerini belirle. İkinci anahtar kare olan Key1 için bu işlemi tekrarla.

3. Animasyonu ayarla. Burada kayıttan oynatma modunu da belirleyebilirsin. Bu örnekte animasyon pinpon olacaktır.

4. Animasyonu oynat. Doğru sözdizimi için aşağıdaki koda bak.

  # Runs when the component should start simulating in a running game.
    # Can be suspended throughout the lifetime of the component. Suspensions
    # will be automatically canceled when the component is disposed of or the game ends.
    OnSimulate<override>()<suspends>:void =
        # TODO: Place simple suspends logic to run for this component here
        Print("OnSimulate")


        if:
            KFM:keyframed_movement_component = Entity.GetComponent[keyframed_movement_component]

Tam Kod

Aşağıda bu örnek için tam kodun kopyalanıp yapıştırılabilir bir sürümü verilmiştir:

using { /Verse.org }
using { /Verse.org/Native }
using { /Verse.org/Simulation }
using { /Verse.org/SpatialMath }
using { /UnrealEngine.com/Temporary/SceneGraph }
using { /UnrealEngine.com/Temporary/SceneGraph/KeyframedMovement }


# A Verse-authored component that can be added to entities
move_cycle_component<public> := class<final_super>(component):