Senkronize Kaybolan Platformlar

Bir kaybolan platformlar serisi, engelli parkurlar gibi platformlu oyun modlarının başlıca unsurları arasındadır. Bunlar oyuncuların bir dizi platform arasındaki sıçrayışları zamanlamasını gerektirir, aksi takdirde oyuncu düşer ve baştan başlamak zorunda kalır.

Bu eğitimi takip ederek Fortnite İçin Unreal Editor (UEFN) içinde Verse ile oluşturulmuş bir cihazı kullanarak sırayla görünen ve kaybolan bir platform serisi oluşturmayı öğreneceksin.

Kullanılan Verse Dili Özellikleri

• Dizi: Dizi türü ile platform referanslarını hızlı erişim için ve kod yinelemelerini önlemek amacıyla bir arada depolayabilirsin.

• Döngü: Platformların görünme ve kaybolma döngüsü, oyun başladığında başlamalı ve oyun bitene kadar devam etmelidir. Bu örnekte bu davranışın Verse döngü ifadesi ile nasıl oluşturulacağı gösteriliyor.

• Blok: Blok ifadesiyle birden fazla ifadeyi sırayla yürütülecek şekilde gruplandırabilirsin.

• For: For ifadesiyle dizindeki her platform üzerinde yineleme yapabilirsin.

• Sync: Sync ifadesi ve yapılandırılmış eşzamanlılık ile aynı anda birden fazla asenkron ifadeyi yürütebilirsin.

Kullanılan Verse API’leri

• Sleep(): Sleep() API’si ile platformların görünmezlik ve görünürlük durumlarında ne kadar süreyle kalacağını seçebilirsin.

• Düzenlenebilir Özellikler: Platformların davranışı için üç adet gecikme ve platformlara dört adet cihaz referansı olmak üzere yedi adet Verse ile oluşturulmuş bir cihaz özelliği UEFN’de kullanıma sunulur, böylece bu özellikleri Editör’de düzenleyebilirsin.

Talimatlar

Düzenli aralıklarla kaybolan ve görünen bir platform serisi oluşturmak için aşağıdaki adımları izle. Tam kod, referans olması için bu kılavuzun sonuna eklenmiştir.

Bölümü Kurmak

Bu eğitimde başlangıç noktası olarak Verse Başlangıç Şablonu kullanılmaktadır. Başlamak için Verse Cihazı özellik örneğinden yeni bir proje oluştur.

Bu örnekte aşağıdaki nesne ve cihazlar kullanılıyor.

• 1 adet Oyuncu Doğma Karesi Cihazı: Bu cihaz, oyuncunun oyun başlangıcında nerede doğacağını belirler.

• 6 x Kreatif Nesne: Kreatif nesneler, platformun görünürlüğünü ve çarpışmasını değiştirmek için Hide() ve Show() gibi Verse ile çağırabileceğin çeşitli davranışlara sahiptir. Bu eğitimde oyuncu etkileşimli platform olarak Airborne Hoverplatform A kullanılmaktadır. Bunu deneyiminin ihtiyaçlarına göre değiştirebilirsin.

Bölümünü ayarlamak için şu adımları izle:

1. Sahnene bir adet Airborne Hoverplatform A ekle. Zeminin üzerine yerleştir, böylece oyuncu kaybolan platformdan zamanında atlamazsa düşecektir. Anahat Düzenleyicisi’nde platformu SynchronizedPlatform1 olarak adlandır.

   

2. Bir çizgi oluşturmak için platformu birkaç kez çoğalt. Ardından Oyuncu Doğma Karesi cihazını oyuncunun başlamasını istediği platforma yerleştir. Tamamlanmış ayarlar şu şekilde görünmelidir:

   

Cihazı Oluşturma

Bu örnekte platformların görünürlükle görünmezlik arasındaki geçiş davranışını tanımlamak için Verse ile oluşturulmuş bir cihaz kullanılır. Verse kullanarak bu cihazı oluşturmak için aşağıdaki adımları izle.

1. Platform_series adlı yeni bir Verse cihazı oluştur. Verse’te yeni bir cihazın nasıl oluşturulacağını öğrenmek için Verse Kullanarak Kendi Cihazını Oluşturma bölümüne bakabilirsin.

   

2. Platform_series cihazını İçerik Tarayıcısı’ndan bölüme sürükle.

UEFN’de Cihaz Özelliklerini Düzenleme

Bu bölümde, editörde özelleştirebilmen için cihaz özelliklerinin UEFN'e nasıl açılacağı gösterilmektedir:

• Platformların ne kadar süreyle görünmez/görünür olması gerektiğini depolayacak HeadStart, AppearDelay ve DisappearDelay adlı üç kayan sabit.

• Bölüme yerleştirdiğin kreatif objelere yönelik cihaz referansları.

Önceki kısımda oluşturduğun platform_series cihazından bu özellikleri kullanıma açmak için aşağıdaki adımları izle.

1. Verse Gezgini’ni aç ve platform_series.verse dosyasına çift tıklayarak kodu Visual Studio Code ile aç.

2. Platform_series sınıf tanımına aşağıdaki alanları ekle:

   • HeadStart adlı düzenlenebilir bir kayan değer. Bu, platformlar görünmeye başladıktan sonra ve platformlar kaybolmaya başlamadan önce kaç saniye süreyle bekleneceğini belirtir. Bu değeri 2,5 veya iki buçuk saniye olarak başlat.

     Verse

       # How long to wait in seconds after platforms start appearing
       # before they start disappearing.
       @editable
       HeadStart:float = 2.5
     

     Copy full snippet(4 lines long)

   • AppearDelay adlı bir düzenlenebilir kayan değer. Bu, bir sonraki platform görünmeden önce kaç saniye süreyle bekleneceğini belirtir. Bu değeri 1,0 veya bir saniye olarak başlat.

     Verse

       # How long to wait in seconds before the next platform appears.
       @editable
       AppearDelay:float = 1.0
     

     Copy full snippet(3 lines long)

   • DisappearDelay adlı bir düzenlenebilir kayan değer. Bu, bir sonraki platform kaybolmadan önce kaç saniye süreyle bekleneceğini belirtir. Bu değeri 1,25 veya bir ve çeyrek saniye olarak başlat.

     Verse

       # How long to wait in seconds before the next platform disappears.
       @editable
       DisappearDelay:float = 1.25
     

     Copy full snippet(3 lines long)

   • DisappearingPlatform adlı bir düzenlenebilir creative_prop. Bu, kaybolup görünecek olan bölüm içi platformu temsil eder. Yazdığın kod henüz bölümde bu objeye bir referans içermediğinden, bunu boş bir arketip creative_prop{} ile örneklendirirsin. Bu referansı daha sonra kayan platformuna atayabilirsin.

     Verse

       # The in-level platform that disappears and reappears.
       @editable
       DisappearingPlatform:creative_prop = creative_prop{}
     

     Copy full snippet(3 lines long)

3. Platform_series sınıf alanların aşağıdaki gibi görünmelidir:

   Verse

        # A Verse-authored creative device that can be placed in a level
        platform_series := class(creative_device):
   		
        # How long to wait in seconds after platforms start appearing
        # before they start disappearing.
        @editable
        HeadStart:float = 2.5
   		
        # How long to wait in seconds before the next platform appears.
        @editable
   
   Expand code Copy full snippet(19 lines long)

   Kodlardan editöre AppearDelay gibi değerleri göstermek için @editable özniteliğini kullanmak yararlıdır. Bu, her seferinde Verse kodunu yeniden oluşturmak zorunda kalmadan UEFN'deki değerlerini özelleştirmeni sağlar, böylece hızlı bir şekilde yineleyebilir ve oyun deneyimine uyan değerleri bulabilirsin.

4. Kodu Visual Studio Code içinde kaydet.

5. UEFN araç çubuğunda, bölümdeki platform_series cihazını güncellemek için Verse’e tıklayıp ardından Verse Kodu Oluştur’a tıkla.

   

6. UEFN’deki Anahat Düzenleyicisi panelinde cihazın Ayrıntılar panelini açmak için platform_series cihazını seç.

7. Platform Serisi’nin altındaki Ayrıntılar panelinde, obje seçiciye tıklayarak ve görünüm penceresindeki platform cihazını seçerek DisappearingPlatform’u SynchronizedPlatform1 (bölüme eklediğin kreatif nesne) olarak ayarla.

Platformu Gizleme ve Gösterme

Bölümü ve birinci platformu ayarladığına göre, artık platformu gösterme ve gizleme işlevini ekleyelim. Bu davranışı platform_series cihazına eklemek için aşağıdaki adımları izle:

1. Creative_prop sınıfının görünürlüğünü açıp kapatmak için iki metot vardır: Hide() ve Show(). Visual Studio Code’da OnBegin() içinde, Hide() çağrısı yap ve ardından DisappearingPlatform’unda Show() çağır.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
   		
            # Hide the platform.
            DisappearingPlatform.Hide()
   		
            # Show the platform.
            DisappearingPlatform.Show()
   

   Copy full snippet(8 lines long)

   Bu kodu çalıştırdığında, Hide() ve Show() çağrıları birbirinin hemen ardından gerçekleştiği için platformun kaybolup yeniden belirdiği görülmez.

2. Platformun görünür/görünmez durumda daha uzun kalması için, Hide() veya Show() çağrısı yaparken Sleep() kullanarak bir gecikme ekleyebilirsin. Sleep() fonksiyonu bir yordamın yürütülmesini askıya alır, burada fonksiyona bir float bağımsız değişkeni ileterek yürütmenin askıya alınacağı süreyi (saniye olarak) belirtebilirsin. Her Hide() ve Show() çağrısından önce Sleep() çağrısı yap ve daha önce tanımladığın DisappearDelay değerini geçir.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
   		
            # Hide the platform.
            DisappearingPlatform.Hide()
   		
            # Wait for DisappearDelay seconds.
            Sleep(DisappearDelay)
   		
            # Show the platform.
   
   Expand code Copy full snippet(11 lines long)

   Bu kodu çalıştırırsan, oyunun geri kalanında Platform görünür hale gelmeden önce bir saniye (DisappearDelay ile tanımlanan süre) boyunca görünmez olur.

   Sleep() fonksiyonu sadece bir asenkron bağlamda çağrılabilir. OnBegin() metodu, suspends belirleyicisine sahip olduğu için zaten bir asenkron bağlam olduğundan, başka bir şey yapmana gerek yoktur. Suspends belirleyicisi hakkında daha fazla bilgi edinmek için Belirleyiciler ve Öznitelikler sayfasına bakabilirsin.

Birden Fazla Platformu Gizleme ve Gösterme

Bir önceki adımdaki kodu kaybolmasını istediğin bölümdeki her platform için tekrarlayabilirsin ancak tüm cihaz referanslarını saklamak için bir dizi oluşturmak daha verimli olacaktır. Bu da dizideki her platformda yineleme yapmanı ve Verse cihazını birden fazla kez çoğaltmak zorunda kalmadan her birinde kod çalıştırmanı sağlayacaktır. Birden çok platformu gizlemek ve göstermek için aşağıdaki adımları izle:

1. Platform_series sınıf tanımında, DisappearingPlatform alanını DisappearingPlatforms adlı bir creative_prop dizisi olarak değiştir. Platformları sırayla yinelemek için bu diziyi kullanacaksın. Değişkeni, boş bir dizi olan array{} varsayılan değeriyle başlat.

   Verse

        # The in-level platforms that disappear and reappear in sequence.
        @editable
        DisappearingPlatforms:[]creative_prop = array{}
   

   Copy full snippet(3 lines long)

2. Dizideki her bir öğeyi yinelemek için for ifadesini kullanabilirsin. For ifadesi sana bir dizin-değer eşleştirmesi vermek için X ->Y desenini kullanır. Dizin sol kısma (X), değer ise sağ kısma (Y) bağlıdır. BuradaX değeri platformun numarası/dizindir ve Y değeri diziden alınan her bir platformun referansıdır. Öncelikle, her bir öğeyi yinelemek için bir for ifadesi oluştur ve PlatformNumber değişkenindeki her bir sayının dizinini al.

   ~~~(verse) # Cihaz, çalışmakta olan bir oyunda başlatıldığında çalışır OnBegin<override>()<suspends>:void= for: PlatformNumber -> DisappearingPlatform:DisappearingPlatforms do: ~~~

3. Platformun numarasını yazdır ve platformu gizlemek için Hide() fonksiyonunu çağır. Ardından DisappearDelay saniye boyunca Sleep() fonksiyonunu çağır.

   Verse

        # For each platform in DisappearingPlatforms, make it invisible and sleep.
        for:
            PlatformNumber -> DisappearingPlatform:DisappearingPlatforms
        do:
            # Hide the platform
            DisappearingPlatform.Hide()
            Print("Platform {PlatformNumber} is now hidden")
            Sleep(DisappearDelay)
   

   Copy full snippet(8 lines long)

4. Karşı platformları göstermek için, birinciden sonra ikinci bir for ifadesi kullanırsın. DisappearingPlatforms içindeki her platformu aynı şekilde yinele, ancak bu sefer platformu göstermek için Show() ve AppearDelay saniye değeri için de Sleep() fonksiyonunu çağır.

   ~~~(verse) # DisappearingPlatforms'daki her platform için görünür hale getir ve uyut. for: PlatformNumber -> DisappearingPlatform:DisappearingPlatforms do: # Platformu göster. DisappearingPlatform.Show() Print("Platform {PlatformNumber} şimdi görünüyor") Sleep(AppearDelay) ~~~

5. Kod yazarken, yeniden kullanmak isteyebileceğin kodları ayrı fonksiyonlara yerleştirmek iyi bir fikirdir. Bu, kodu farklı bağlamlardan çağırmana ve aynı kodu tekrar tekrar yazmak zorunda kalmamana olanak sağlar. Deneyimine bağlı olarak, farklı durumlarda platformları gizlemek ve göstermek isteyebilirsin, bu nedenle bunların her birini işlemek için fonksiyonlar oluşturmalısın. Platform_series sınıf tanımına HideAllPlatforms() ve ShowAllPlatforms() adında iki yeni fonksiyon ekle. Platformları gizlemeyi yöneten for ifadesini HideAllPlatforms() içine ve platformları göstermeyi yöneten ifadeyi ShowAllPlatforms() içine taşı. Sleep() fonksiyonunu kullandığın için bu fonksiyonların asenkron olması gerekir. Bu nedenle her birine <suspends> değiştiricisini ekle. Sonra OnBegin() içinde, HideAllPlatforms() ve ardından ShowAllPlatforms() fonksiyonlarını çağır.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
            HideAllPlatforms()
            ShowAllPlatforms()
   
        HideAllPlatforms()<suspends>:void=
            # For each platform in DisappearingPlatforms, make it invisible and sleep.
            for:
                PlatformNumber -> DisappearingPlatform:DisappearingPlatforms
            do:
   
   Expand code Copy full snippet(24 lines long)

6. Şu anda, bu kod sadece bir kez çalışacaktır. Oyun devam ettiği sürece platformların kaybolmasını ve yeniden görünmesini sürdürmek için loop ifadesini kullanarak bu davranışı tekrarlayabilirsin. Bunu gerçekleştirmek için, OnBegin() fonksiyonuna HideAllPlatforms() ve ShowAllPlatforms() çağrılarını içeren bir loop ifadesi ekle. Bu örnekte, platformların görünürlüğünü oyun devam ettiği sürece değiştirmek istiyorsun, bu nedenle loop’tan çıkmak için bir break ifadesi eklemene gerek yoktur.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
            loop:
                # Hide all platforms.
                HideAllPlatforms()
   
                # Show all platforms.
                ShowAllPlatforms()

   Copy full snippet(8 lines long)

   Bu kodu çalıştırırsan platformların hepsi önce sırayla kaybolur, sonra aynı sırayla yeniden görünür ve bu döngü oyun bitene kadar devam eder.

7. Kodunu kaydet ve derle. UEFN’deki Anahat Düzenleyicisi panelinde cihazın Ayrıntılar panelini açmak için platform_series cihazını seç.

8. DisappearingPlatforms’un altındaki Ayrıntılarpanelinde, bölümdeki her platform için bir dizi öğesi ekle. "Eleman Ekle" düğmesiyle diziye yeni elemanlar ekle, ardından obje seçiciye tıkla ve görünüm penceresindeki kreatif nesneyi seç. Bu dizinin sırasının, yineleme yapmak istediğin sırayla eşleştiğinden emin ol:

   

Bu kodu çalıştırırsan platformların hepsi önce sırayla kaybolur, sonra aynı sırayla yeniden görünür ve bu döngü oyun bitene kadar devam eder.

Kaybolan ve Yeniden Görünen Platformları Senkronize Etme

Oyuncuyu karelerin üzerinde zıplarken daha hızlı hareket etmeye zorlamak istersen sıranın sonraki bölümlerinde yer alan platformlar görünmeye devam ederken platformların kaybolmasını başlatabilirsin. Bu şekilde oyuncu, seri boyunca acele etmek zorunda kalacak, aksi takdirde düşecektir. Bu davranışı oluşturmak için her iki yordamın da (ShowAllPlatforms() ve HideAllPlatforms()) aynı zamanda çalışması ve ikincinin birinciden geride kalması gerekir. Böylece oyuncu, bir sonraki platform kaybolmadan önce platforma atlayabilmek için erken bir başlangıç yapabilir.

Platformların tümünün aynı anda gizlenmesi ve gösterilmesi için aşağıdaki adımları izle.

1. HideAllPlatforms() ve ShowAllPlatforms()’un eşzamanlı olarak çalışması için sync ifadesini kullanabilirsin. sync ifadesi kod bloğunda iki veya daha fazla asenkron ifadeyi yürütür ve devam etmeden önce tüm ifadelerin tamamlanmasını bekler. OnBegin()’deki loop ifadesinin içine, HideAllPlatforms() ve ShowAllPlatforms() fonksiyonlarına bir sync ifadesi ekle.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
            loop:
                # Run both expressions concurrently using sync.
                sync:
                    # Hide all platforms.
                    HideAllPlatforms()
   
                    # Show all platforms.
                    ShowAllPlatforms()

   Copy full snippet(10 lines long)

2. Bu kodu olduğu gibi çalıştırırsan, bir platform eşzamanlı olarak gizlenir ve gösterilir. Bu istenen sonuç değildir, bu nedenle platformun kaybolmasını biraz geciktirmen gerekecektir. Oyuncuya başlangıç avantajı vermek için, HeadStart değerini geçerek Sleep() fonksiyonunu kullanmak isteyeceksin. sync ifadesi kod bloğundaki tüm ifadeleri aynı anda yürüttüğünden, Sleep() ve HideAllPlatforms() fonksiyonlarını iç içe yerleştirmek için block ifadesini kullanman gerekir. Sleep() ve HideAllPlatforms() ifadelerini kapsayan block ifadesini ekle. Şimdi senkronizasyon iki ifadeyi çalıştıracaktır. İlki ShowAllPlatforms()’u, ikincisi Sleep()’i ve sonrasında da HideAllPlatforms() fonksiyonunu çağırır.

   Verse

        # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
            loop:
                # Run both expressions concurrently using sync.
                sync:
                    block:
                        Sleep(HeadStart)
                        # Hide all platforms.
                        HideAllPlatforms()
                    # Show all platforms.
   
   Expand code Copy full snippet(11 lines long)

3. Kodu kaydet ve Verse’e tıklayıp ardından kodu derlemek için Verse Kodu Oluştur’a tıkla.

4. Bölümün oynanış testini yapmak için UEFN araç çubuğunda Oturumu Başlat düğmesine tıkla.

   

Şimdi bölüme oynanış testi uyguladığında platformlar sırayla kaybolmaya başlar, sıranın sonraki bölümlerinde yer alan platformlar ise yeniden görünür ve oyun devam ettiği sürece bu desen devam eder.

Tam Kod

Aşağıdaki kod, sırayla görünen ve kaybolan bir platform serisi oluşturmaya yarayan tam koddur.

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# See https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse for how to create a verse device.

# A Verse-authored creative device that can be placed in a level
platform_series := class(creative_device):

    # How long to wait in seconds after platforms start appearing

Kendi Kendine Yapabileceklerin

Bu eğitimi tamamlayarak, bir dizi platformun görünürlüğünü oyun devam ettiği sürece değiştiren bir cihazı Verse kullanarak nasıl oluşturacağını öğrendin.

Öğrendiklerini kullanarak aşağıdaki işlemleri yapmaya çalış:

• Platformların görünme ve kaybolma sırasını değiştir.

• Fonksiyonları, Nesne Yürütücü Cihaz gibi diğer cihaz türlerinde düzenli aralıklarla çağırmak için aynı kavramları uygula.