1. Epic GamesDeveloper
  3. 3. Oynanış Etiketleri ile Çalışma Zamanında Işık Bulma

3. Oynanış Etiketleri ile Çalışma Zamanında Işık Bulma

Oyuncunun Verse ile oluşturulmuş bir cihazı kullanarak bir eşya oluşturmak için doğru açık ve kapalı ışık birleşimini bulmasının gerekli olduğu bir bulmaca oluştur.

3. Oynanış Etiketleri ile Çalışma Zamanında Işık Bulma
Prerequisite topics

In order to understand and use the content on this page, make sure you are familiar with the following topics:

Etiketli Işıklar Bulmacası eğitimindeki bu adımı tamamlayarak oyun devam ederken belirli bir etiketle işaretlenmiş aktörleri bulmak için Oynanış Etiketlerini nasıl kullanacağını öğreneceksin. Oynanış Etiketleri, editörde referanslarını oluşturmak zorunda kalmadan birden fazla cihazla çalışmana olanak tanır. Bu seçenek, örneğin oyuncu oyunda ilerlerken aktif olan cihazları kodunun dinamik olarak değiştirmesi gibi ilgi çekici oynanış fırsatları yaratabilir.

Yeni bir Oynanış Etiketi oluşturmak ve bulmaca bölümündeki tüm ışıklara atamak için aşağıdaki adımları izle:

  1. Verse Gezgini menüsünü aç ve tagged_lights_puzzle.verse kodunu çift tıklayarak Visual Studio Code ile aç.
  2. Kod dosyasının en üstünde:
    • tag sınıfına başvurmak ve GetCreativeObjectsWithTag() işlevini kullanmak için using { /Verse.org/Simulation/Tags } ekle.
    • Düzenlenebilir özellikler oluşturabilmek için using { /Verse.org/Simulation } ekle.
     using { /Fortnite.com/Devices }
 using { /Verse.org/Native }
 using { /UnrealEngine.com/Temporary/Diagnostics }
 using { /Verse.org/Simulation/Tags }
 using { /Verse.org/Simulation }
    
 log_tagged_lights_puzzle := class(log_channel){}

  3. log_tagged_lights_puzzle sınıfının üstüne tag sınıfından devralan puzzle_light adlı yeni bir alt sınıf ekle. Devralınan sınıf adı, herhangi bir kreatif cihazında kullanman için özel bir oynanış etiketi haline gelir.

     # Yeni bir oynanış etiketi oluşturmak için Verse.org/Simulation/Tags modülünde `tag` sınıfından türet.
 puzzle_light := class(tag){}

 log_tagged_lights_puzzle := class(log_channel){}
  4. UEFN araç çubuğunda Verse Kodları Oluştur (Build Verse Scripts) seçeneğine tıklayarak kodunu ve yeni puzzle_light Oynanış Etiketini projene derle.
  5. UEFN Anahat Düzenleyici menüsünden bir Özelleştirilebilir Işık Cihazı seçerek Ayrıntılar panelini aç.
  6. Ayrıntılar panelinde:
    1. Yeni bileşen ekle seçeneğine tıkla ve Verse etiket işaretleme öğesini seç.
    2. Arıntılar panelinde ayarlarını görüntülemek için VerseTagMarkup bileşenini seç.
    3. Oynanış Etiketleri altında Etiketler özelliğini düzenle ve puzzle_light etiketini ekle.
    VerseTagMarkup Bileşenini ve puzzle_light etiketini ekleme

    Her bir cihazın aynı anda birden fazla gruba ait olabilmesi için aynı cihaza birden fazla etiket eklenebilir. Örneğin, GetCreativeObjectsWithTag(tag1{}) veya GetCreativeObjectsWithTag(tag2{}) çağrıldığında tag1 ve tag2 etiketine sahip bir cihaz bulunacaktır.
  7. tagged_lights_puzzle sınıf tanımına iki değişken dizisi alanı ekle:
    • Tüm ışıkların geçerli durumunu (açık veya kapalı) göstermek için LightsState adlı düzenlenebilir bir logic değişkeni. Bu değişken, aynı zamanda ışıkların başlangıç durumunu öğe sayısı puzzle_light etiketiyle işaretlenmiş ışık sayısıyla eşleşecek şekilde ayarlamak için kullanılır. Bu örnekte varsayılan olarak tüm ışıklar kapalıdır, bu yüzden tüm ışıklar için başlangıç değeri false şeklindedir. 
       @editable
 var LightsState : []logic = array{false, false, false, false}
    • puzzle_light Oynanış Etiketi ile etiketlenmiş tüm Özelleştirilebilir Işık cihazlarını depolamak için Lights adlı düzenlenebilir bir customizable_light_device değişken dizisi. 
       @editable
 var Lights : []customizable_light_device = array{}
  8. Oyun başladığında cihaz, LightsState dizisinde belirtilen başlangıç yapılandırmasıyla eşleşecek şekilde ışıkları ayarlamalı ve referansları, oyun durumu değiştiğinde güncellenebilecek şekilde Lights dizisine kaydetmelidir. Bu işlem SetupPuzzleLights() : void adlı bir yöntemde yapılacak ve oyun başladığında ışıkların ayarlanması için OnBegin() yönteminde çağrılacaktır. 
     SetupPuzzleLights() : void =
     Logger.Print(“Setting up in-game lights”)
    
 OnBegin<override>()<suspends> : void =
     SetupPuzzleLights()
  9. SetupPuzzleLights() işlevinde GetCreativeObjectsWithTag(puzzle_light{}) çağrısı yaparak puzzle_light etiketine sahip tüm cihazları bul ve TaggedActors adlı bir diziye kaydet. TaggedActors, kapsamı SetupPuzzleLights() yönteminde yerel olan sabit bir dizi olduğundan dizi için açıkça bir tür belirtmen gerekmez çünkü bu bağlamda diziye referans verilebilir. 
     SetupPuzzleLights() : void =
     Logger.Print("Setting up in-game lights")
     TaggedActors := GetCreativeObjectsWithTag(puzzle_light{})

    GetCreativeObjectsWithTag() işlevinin farklı çağrıları, cihazları dizi sonucunda farklı sıralara yerleştirebilir çünkü Oynanış Etiketleri ile aktörleri alırken kesin bir sıra yoktur.
  10. Artık puzzle_light etiketine sahip tüm cihazları topladığına göre her bir ışığın LightsState dizisi tarafından belirtilen başlangıç durumuyla eşleştiğinden emin olmalısın. Tüm etiketli cihazlarda yinelemek için bir for döngüsü kullanabilirsin. 
     for:
     ActorIndex -> TaggedActor : TaggedActors
 do:
     TaggedActor
  11. GetCreativeObjectsWithTag() işlevi creative_object_interface türünde bir dizi döndürür. Bu örnekte ışığı açmak veya kapatmak için her bir TaggedActor ile bir customizable_light_device olarak etkileşime girmen gerekecektir.
    • NewDeviceReference := device_type_to_cast_to[DeviceReference] sözdizimini kullanarak bir sınıfı alt sınıflarından birine dönüştürebilirsin (tür dönüştürme adı verilir). Bu sözdiziminde device_type_to_cast_to değeri istediğin cihazdır ve bu örnekte customizable_light_device şeklindedir. Bu başarısız olabilir bir ifadedir çünkü cihaz o türe dönüştürülemiyorsa (örneğin, farklı bir cihaz türüyse) tür dönüştürme başarısız olacaktır. 
       LightDevice := customizable_light_device[TaggedActor]

    GetCreativeObjectsWithTag() işlevi []creative_object_interface dönüş türüne sahiptir çünkü işlev farklı türlerde aktörler döndürebilir. Bu nedenle dönüş türü, GetCreativeObjectsWithTag() tarafından döndürülmesi için tüm aktörlerin uygulamak zorunda olduğu arayüzdür. Daha fazla bilgiyi oynanış etiketleri bölümünde bulabilirsin.
    • for ifadeleriyle başarısız olabilir ifadeleri bir filtre olarak kullanabilir ve daha sonra for kod bloğunda kullanabileceğin yeni değişkenler oluşturabilirsin. Bu durumda önceki adımda yaptığın customizable_light_device cihazına tür dönüştürmeyi, yineleme ifadesine eklemelisin. 
       for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
 do:
      LightDevice
    • Bir kod bloğundaki son ifade, kod bloğunun sonucudur. for ifadesi bir dizideki her bir yinelemeden kod bloğunun sonucunu döndürür. Bu yüzden bu for ifadesi, puzzle_light ile etiketlenmiş customize_light_device referanslarının bir dizisidir. Bunun anlamı, Lights dizisini doğrudan for ifadesinin sonucuyla güncelleyebileceğindir. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
 do:
      LightDevice
    • Bu for döngüsü ayrıca ışıklar üzerinde TurnOn() / TurnOff() çağrısı yaparak editördeki başlangıç LightsState ayarıyla eşleştirmelidir. for ifadesi, geçerli etiketli cihazı almak için dizini döndürebilir (örnekte ActorIndex) ve bu değeri, ışığın açılması veya kapanması gerektiğini görmek için LightsState dizisine dizin oluşturmak için kullanabilirsin. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
      ShouldLightBeOn:= LightsState[ActorIndex]
 do:
      LightDevice
    • Ardından, ShouldLightBeOn değerinin true / false olmasına göre TurnOn() / TurnOff() işlevini çağır. Bir koşulu temel alarak farklı ifadeler (özellikle başarısız olabilir bir ifade) yürütmek için bir if ifadesi kullanabilirsin. Bu durumda başarısız olabilir ifade, IsLightOn ile ? işlevini kullanabilir ve ShouldLightBeOn değeri true ise başarılı olacak (bu yüzden TurnOn() çağrısı yapacak) ve ShouldLightBeOn değeri false ise başarısız olacaktır (bu yüzden TurnOff() çağrısı yapacaktır). 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
      ShouldLightBeOn := LightsState[ActorIndex]
 do:
      if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
      LightDevice
    • Kodunun beklenen şekilde çalıştığını doğrulayabilmen ve bölümde gördüklerinle karşılaştırabilmen için ışık dizinini ve başlangıç değerini yazdırmak da iyi bir fikirdir.
    • Biz dizenin ortasında {} kullandığında önce {} arasındaki ifade değerlendirilir ve değeri dizeye eklenir. Böylece değerleri koşullu olarak eklemek için bir if ifadesini dizenin ortasında kullanabilirsin. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[ActorIndex]
      ShouldLightBeOn := LightsState[ActorIndex]
 do:
      Logger.Print("Adding Light at index {ActorIndex} with State:{if (ShouldLightBeOn?) then "On" else "Off"}")
      if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
      LightDevice
  12. SetupPuzzleLights() yöntemin şu anda böyle görünmelidir: 
     SetupPuzzleLights() : void =
     TaggedActors := GetCreativeObjectsWithTag(puzzle_light{})
     <#
     puzzle_light etiketine sahip her bir cihaz için cihazı o türe dönüştürerek bir customizable_light_device olup olmadığını kontrol et.
     Bir customizable_light_device ise LightDevice cihazına TurnOn() veya TurnOff() fonksiyonunu uygulamak için başlangıçtaki LightState değerini al.
     Tüm etiketlenmiş customizable_light_device cihazlarını Lights dizisine kaydet.
     #>
     set Lights = for:
             ActorIndex -> TaggedActor : TaggedActors
             LightDevice := customizable_light_device[TaggedActor]
             ShouldLightBeOn := LightsState[ActorIndex]
     do:
             Logger.Print("Adding Light at index {ActorIndex} with State:{if (ShouldLightBeOn?) then "On" else "Off"}")
             if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
             LightDevice
  13. Kodu Visual Studio Code içinde kaydet.
  14. UEFN araç çubuğunda Verse Kodları Oluştur seçeneğine tıklayarak kodunu derle.
  15. Bölüme oynanış testi uygulamak için UEFN araç çubuğunda oyna butonuna tıkla.

Bölümüne oynanış testi uyguladığında her bir ışığın başlangıç durumuyla birlikte çıktı günlüğüne yazdırılarak Lights dizisine eklendiğini görmen gerekir.

Sonraki Adım

Bu eğitimin bir sonraki adımında oyuncu butonlara bastığında belirli bir ışık kümesini nasıl açıp kapatacağını öğreneceksin.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page