Etkileşimli Eşya Alma Bileşeni Oluştur

Bu eğitim, oyuncuların özel eşyaları almasına olanak tanıyan ve alınan eşyayı oyuncunun envanterine ekleyen özel bir etkileşimli “eşya alma” bileşenini nasıl oluşturacağını gösterir.

Başlamadan Önce

Bu eğitimi başarıyla tamamlayabilmek için UEFN, Scene Graph ve Verse kodu konusunda bilgi sahibi olman gerekir.

Projeni Ayarla

Projeni ayarlamak ve Özel Çanta ve Eşyalar’ı etkinleştirmek için aşağıdaki adımları izle.

1. UEFN’i aç ve herhangi bir ada şablonundan bir proje oluştur. Düz bir alan üzerinde çalışmak istiyorsan Ada Şablonları bölümünden Boş projeyi kullanabilirsin. Yeni projene bir isim ver ve onu editörde açmak için Oluştur butonuna tıkla.

   

2. Araç çubuğundan Proje’ye tıkla ve Proje Ayarları’nı seç.

   

3. Aşağı kaydırarak Deneysel Erişim bölümüne git ve Özel Eşyalar ve Çanta kutusunu işaretle. 

Verse Kodunu Yaz

interactable_component, genel etkileşimi yönetmek için kullanılan bir Scene Graph bileşenidir. Varsayılan durumda, oyuncular bir girdiye basıp bu bileşene sahip varlıkla etkileşim kurabilir. Bu bileşeni özelleştirmek için bu adımları izleyin.

1. Özel etkileşimli bileşeni ekleyeceğin varlığı seç. Ayrıntılar panelinde +Component butonuna tıkla ve Yeni Verse Bileşeni seçeneğine git. Verse Bileşeni Oluştur penceresi açılır.  

   Verse Gezgini üzerinden yeni bir Verse dosyası ekleyerek de bir Verse bileşeni oluşturabilirsin.

2. Şablon Seç altında Scene Graph Bileşeni’ni seç.

3. Alttaki Bileşen Adı alanına item_interactable_component yaz. Ardından Oluştur butonuna tıkla.

4. Menü çubuğunda, Verse > Verse Gezgini’ne tıkla. Yeni Verse bileşenini bul, ona sağ tıkla ve Visual Studio Code’da Aç’ı seç.

5. Yeni Verse dosyasındaki mevcut kodu sil çünkü tamamını bu eğitimde yazacaksın. Önce gerekli modülleri ekle. Bunları aşağıdaki kod parçacığından kopyalayıp yapıştırabilirsin.

   Verse

   using { /Verse.org/Simulation }
   using { /Verse.org/SceneGraph }
   using { /UnrealEngine.com/Itemization }

   Copy full snippet(3 lines long)

6. Ardından, belirtilen bir oyuncudan kök envanterini almak için bir yardımcı fonksiyon ekle.

   Verse

   GetInventoryRoot(Agent:agent)<decides><transacts>:inventory_component =
           Inventory := (for (I : Agent.FindDescendantComponents(inventory_component)) { I })[0]

   Copy full snippet(2 lines long)

7. Yeni özel bileşeni oluşturmadan önce, sınıf kapsamımızın dışında yeni bir mesaj türü sabiti bildirmen gerekir. Fonksiyon bir eşyanın item_details_component bileşeninden ad alamıyorsa varsayılan olarak bu mesaj kullanılır. Genellikle bu mesaj türü Verse dosyasının en altına yazılır.

   Verse

   DefaultInteractionMessage<localizes>:message = "Interact"

   Copy full snippet(1 line long)

8. interactable_component bileşeninden devralan yeni bir Scene Graph tanımla. Bu item_interactable_component bileşenidir.

   Verse

   item_interactable_component := class(interactable_component) :

   Copy full snippet(1 line long)

9. İsteğe bağlı bir iptal edilebilir değişken ekle. Bir oyuncunun eşyayla ne zaman etkileşime girdiğini öğrenmek için bu özel bileşenin bir olaya abone olması gerekir. Bu değişken, o aboneliğin referansını kaydeder ve gerekirse iptal eder.

   Verse

   var SucceededEventHandler : ?cancelable = false

   Copy full snippet(1 line long)

10. Ardından OnAddedToScene fonksiyonunu geçersiz kıl. Böylece bu bileşenin sahibi olan varlığın üst öğesi değiştiğinde (örneğin dünyaya yerleştirildiğinde) isteğe bağlı değişken ayarlanır. SucceededEventHandler’ı, SucceededEvent üzerindeki abone olma fonksiyonunu çağırmak için ayarla. Bu aynı zamanda OnSucceededEvent fonksiyonunu da etkileşim gerçekleştiğinde tetiklenecek şekilde tanımlayacaktır.

    Verse

    OnAddedToScene<override>():void =
          if(not SucceededEventHandler?):
             set SucceededEventHandler = option{SucceededEvent.Subscribe(OnSucceededEvent)}

    Copy full snippet(3 lines long)

11. Bir eşya alındıktan sonra SucceededEvent aboneliğinin temizlenmesi gerekir, aksi takdirde eşya bir çantaya yerleştikten sonra diğer kodlarla etkileşime girebilir. Bunu OnRemovingFromScene fonksiyonunu geçersiz kılarak yapabilirsin. Bu, eşya varlığının üst öğesi değiştiğinde etkinleşir. Olay aboneliğini burada iptal etmek için cancel() kullan. Başarılı olursa, SucceededEventHandler’ı da geçersiz kılar.

    Verse

    OnRemovingFromScene<override>():void =
        if(SucceededEventHandler?.Cancel()):
    		   set SucceededEventHandler = false

    Copy full snippet(3 lines long)

12. 10. adımda OnSucceededEvent fonksiyonu SucceededEvent öğesine abone yapılır fakat fonksiyon henüz kodda yoktur. Yani aynı imzayla yeni bir fonksiyon yazman gerekiyor. 6. adımda, etkileşimde bulunan oyuncudan kök envanterini almak için GetInventoryRoot[] yardımcı fonksiyonunu kullandın. Şimdi bu bileşene sahip olan varlığı sunmak için AddItemDistribute() fonksiyonunu çağır.

    Verse

    OnSucceededEvent(Agent:agent):void =
            if(PickupInventory := GetInventoryRoot[Agent]):
                if(PickupInventory.AddItemDistribute(Entity).GetSuccess[]):

    Copy full snippet(3 lines long)

13. Bu bileşen için gereken son kod parçası, InteractMessage[] fonksiyonunun geçersiz kılınmasıdır. Bu, bir oyuncu eşyayı almadan önce ona baktığında ekranda gösterilen mesajı döndürür. Bu bileşene sahip olan varlığın aynı zamanda bir item_details_component bileşenine sahip olup olmadığını da kontrol edecektir. Eğer öyleyse, bu öğenin adını alır. Aksi takdirde, varlıkta item_details_component bileşeni yoksa veya varlık bir nedenle kaldırılmışsa daha önce bildirdiğimiz DefaultInteractionMessage kullanılır.

    Verse

    InteractMessage<override>(Agent:agent)<reads><decides>:message =
            if(Details := Entity.GetComponent[item_details_component]):
                Details.Name
            else:
                DefaultInteractionMessage

    Copy full snippet(5 lines long)

Prefab Kurulumu

item_interactable_component bileşenini yazdığına göre artık onu sergilemek için örnek bir eşya hazırlayabilirsin. Bir Scene Graph prefabı oluşturmak ve yeni bileşeni eklemek için aşağıdaki adımları izle.

1. İçerik Tarayıcısı’nda sağ tıkla ve bağlam menüsünden Varlık Prefabı Tanımı seçeneğine git. Yeni prefabı Item_Cube olarak adlandır.

   

2. Yeni prefabı aç ve Ayrıntılar panelinde +Component butonuna tıklayarak aşağıdaki bileşenleri ekle.

   • item_component

   • item_details_component - Bu bileşendeki alanları doldur:

     • Ad

     • Açıklama

     • Kısa Açıklama

   • mesh_component - Küp primitifini veya başka bir küpü seç.

   • item_interactable_component

   

Aşağıdaki video, item_interactable_component bileşenini çalışırken göstermektedir. Oyuncu, senin oluşturduğun Item_Cube prefabıyla etkileşime girdiğinde eşya oyuncunun çantasına eklenir.

İşte bu eğitim için tam kod.

using { /Verse.org/Simulation }
using { /Verse.org/SceneGraph }
using { /UnrealEngine.com/Itemization }


# This function returns the first subentity with an inventory_component. Use this to get the root inventory of an agent.
GetInventoryRoot(Agent:agent)<decides><transacts>:inventory_component =
        Inventory := (for (I : Agent.FindDescendantComponents(inventory_component)) { I })[0]