4. Butonlarla Işıkları Açıp Kapatma

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.

4. Butonlarla Işıkları Açıp Kapatma
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 oyuncunun etkileşime girdiği butona göre bir ışık grubunu nasıl açıp kapatacağını öğreneceksin.

Işıkları Açma/Kapatma

Oyuncu butonla etkileşime girdiğinde bir buton ile butonun açıp kapatacağı ışık grubu arasında eşleştirme yapman gerekir. Bunu yapmak için her bir butonu Lights dizisindeki ışık dizinleriyle eşleştirebilirsin.

Bu örnek, butonlar ile ışıklar arasında aşağıdaki eşleştirmeyi kullanır:

  • Buton 1, dizin 0’daki ışık ve dizin 3’teki ışık ile eşleştirilir
  • Buton 2, dizin 0’daki ışık, dizin 1’deki ışık ve dizin 2’deki ışık ile eşleştirilir
  • Buton 3, dizin 0’daki ışık ve dizin 1’deki ışık ile eşleştirilir
  • Buton 4, dizin 1’deki ışık ile eşleştirilir

Bu eşleştirmeyi ButtonsToLights adlı bir diziyle gösterebilirsin. Burada ButtonsToLights dizisinin her bir öğesi ışıkların dizinlerini tutan başka bir dizidir. ButtonsToLights dizisinin türü bu durumda ButtonsToLights dizisinin tamsayı dizilerinden oluşan bir dizi olduğunu belirtmek üzere [][]int olur.

Dizin 0 1 2 3
Öğe array{0, 3} array{0, 1, 2} array{0, 1} array{1}

Işıkları açıp kapatmak için şu adımları izle:

  1. Tamsayı dizilerinden oluşan ButtonsToLights adlı bir dizi oluştur ve yukarıdaki tabloda açıklanan buton-ışık dizinleri eşleştirmesi ile başlat. 
     ButtonsToLights : [][]int = array{array{0, 3}, array{0, 1, 2}, array{0, 1}, array{1}}

    Bir dizinin dizinleri (indeksleri) 0’dan başlar ve öğe sayısının 1 eksiğine kadar yükselir. Bu nedenle ButtonsToLights dizisinin ilk öğesi dizin 0’da, son öğesi ise dizin 3’tedir.
  2. tagged_lights_puzzle sınıfına ToggleLights() adlı yeni bir metot ekle. Bu metot, fonksiyona bir tamsayı dizisi olarak verilen dizinlere göre (ButtonsToLights dizisinin öğeleriyle eşleştirmek için) Lights dizinindeki ışıkları açar/kapatır ve LightsState içindeki aynı dizinlerde bulunan öğeleri günceller.
    1. LightIndices : []int parametresini ToggleLights() metoduna ekle ve for ifadesini kullanarak her bir dizini çıktı günlüğüne yazdır. 
       ToggleLights(LightIndices : []int) : void =
 for:
     LightIndex : LightIndices
 do:
     Logger.Print("Toggling light at {LightIndex}")
    2. Yöntemi oluştururken test etmek için OnBegin() içinde ToggleLights() yöntemini çağır. ButtonsToLights dizisinin ilk öğesini test olarak kullan. Dizi içinde dizin oluşturmak bir başarısız olabilir ifade olduğundan diziye bir hata bağlamından erişmen gerekecektir. Bu örnek, hata bağlamı için if ifadesini kullanır.
     OnBegin<override>()<suspends> : void =
     SetupPuzzleLights()

     # ToggleLights yöntemini test etmek için ButtonsToLights dizisinin ilk öğesini kullan
     if (LightIndices : []int = ButtonsToLights[0]):
         ToggleLights(LightIndices)
  3. Artık LightIndex dizinini elde ettiğinde göre dizindeki Lights ve LightsState dizilerine erişerek özelleştirilebilir ışık cihazı referansını ve geçerli durumunu elde edebilirsin. Bir ışığı açıp kapatmak şu anlama gelir: Işık açıksa ışığı kapat, ışık kapalıysa ışığı aç. Işığın yeni durumunun ne olacağını söylemek için yazdırma durumunu güncelle. 
     ToggleLights(LightIndices : []int) : void =
     for:
         LightIndex : LightIndices
         Light := Lights[LightIndex]
         IsLightOn := LightsState[LightIndex]
     do:
         Logger.Print("Turning light at {LightIndex} {if (IsLightOn?) then "Off" else "On"}")
  4. Şimdi özelleştirilebilir ışık cihazının durumunu hem oyun içinde hem de LightsState dizisinde güncelle.
    1. IsLightOn değeri false ise TurnOn() çağrısı yap, IsLightOn değeri true ise TurnOff() çağrısı yap. Bir kod bloğundaki son ifade sonuçtur. Bu yüzden son ifade olarak false veya true değerini ayarlamak değerin NewLightState içinde depolanacağı anlamına gelir. 
       ToggleLights(LightIndices : []int) : void =
 for:
     LightIndex : LightIndices
     Light := Lights[LightIndex]
     IsLightOn := LightsState[LightIndex]
 do:
     Logger.Print("Turning light at {LightIndex} {if (IsLightOn?) then "Off" else "On"}")
     NewLightState :=
         if (IsLightOn?):
             Light.TurnOff()
             yanlış
         else:
             Light.TurnOn()
             true
    2. LightIndex dizinindeki LighsState öğesini NewLightState durumundaki değerle güncelle. Dizi dizini oluşturma başarısız olabilir bir ifade olduğundan LightsState bir hata bağlamında paketlenmelidir. Bu örnekte hata bağlamı if ifadesidir. Durumun güncellendiğini çıktı günlüğüne yazdır. 
       ToggleLights(LightIndices : []int) : void =
 for:
     LightIndex : LightIndices
     IsLightOn := LightsState[LightIndex]
     Light := Lights[LightIndex]
 do:
     Logger.Print("Turning light at {LightIndex} {if (IsLightOn?) then "Off" else "On"}")
     NewLightState :=
         if (IsLightOn?):
             Light.TurnOff()
             yanlış
         else:
             Light.TurnOn()
             true
     if (set LightsState[LightIndex] = NewLightState):
         Logger.Print("Updated the state for light at {LightIndex}")

    Hata bağlamlarını kullanırken çıktı günlüğüne yazdırmak iyi bir fikirdir. Herhangi bir ifade hata bağlamında başarısız olursa hata bağlamında yapılan tüm değişiklikler hiç yapılmamış gibi geri alınır. Çıktı günlüğüne yazdırırsan değişikliğin başarılı olup olmadığını doğrulamak için sadece oyun içi duruma bağlı kalmadan, metnin çıktı günlüğünde görünüp görünmediğine bakarak değişikliğin yapılıp yapılmadığını ikinci bir kez kontrol edebilirsin.

Butona Basmayı Işıkları Açıp Kapatmaya Bağlama

Işıkları nasıl açıp kapatacağını artık belirlediğine göre bir sonraki adım, butona basma işlemlerini ışıkları açmaya veya kapatmaya bağlamaktır.

Butonun InteractedWithEvent olayına abone olarak bunu yapabilirsin. Olay aboneliği hakkında daha ayrıntılı bilgi için Cihaz Etkileşimlerinin Kodlanması bölümüne bakabilirsin.

InteractedWithEvent bir InPlayer : agent parametresi ve void dönüş türüne sahip bir olay işleyici bekler ancak olay işleyicinin ToggleLights() yöntemini çağırabilmesi için olayları gönderen butonun hangi ışıklara bağlı olduğunu bilmesi ve aynı zamanda tagged_lights_puzzle adlı Verse cihazının bir referansını bulundurması gerekir.

Tüm bu bilgileri, abone olmak için dizinleri ve işlevi içeren yeni bir sınıf oluşturarak bir özel objede paketleyebilirsin. Bu şekilde her buton, bu yeni sınıfla temsil edilen kendi kişisel durumuna ve olay işleyicisine sahip olur.

Olay işlemeye yönelik özel bir obje oluşturmak için aşağıdaki adımları izle:

  1. button_event_handler adlı yeni bir sınıf oluştur. Sınıf tanımı aşağıdakileri içermelidir:
    1. Indices adlı bir tamsayı dizisi.
    2. ToggleLights() yöntemini çağırabilmen için Verse cihazının referansı olan PuzzleDevice adlı bir tagged_lights_puzzle alanı.
    3. InPlayer : agent parametresine ve void dönüş türüne sahip olup PuzzleDevice cihazında ToggleLights() çağrısı yapan OnButtonPressed() adlı bir yöntem. 
       button_event_handler := class():
 # Bu butonun kontrol ettiği ışıklara erişmek için kullanılan konumlar.
 Indices : []int

 # Üzerinde fonksiyonlar çağırabilmemiz için bu button_event_handler işleyicisini oluşturan tagged_lights_puzzle.
 PuzzleDevice : tagged_lights_puzzle
    
 OnButtonPressed(InPlayer : agent) : void =
     # PuzzleDevice cihazına bu butonun kontrolündeki konumlarda bulunan ışıkları açıp kapatmasını söyler.
     PuzzleDevice.ToggleLights(Indices)
  2. Oyuncunun etkileşimde bulunabileceği butonlara referans vermek için tagged_lights_puzzle sınıfında düzenlenebilir bir button_device dizi alanı oluştur: 
     @editable
 Buttons : []button_device = array{}
  3. Şimdi tagged_lights_puzzle sınıfındaki OnBegin() değerini güncelleyerek her bir buton için bir button_event_handler örneği oluştur. Button_event_handler aşağıdaki bilgilere ihtiyaç duyar:
    • for ifadesi tarafından sağlanan ButtonIndex dizinini kullanarak ButtonsToLights dizisinden alabileceğin, butonla ilişkili ışıkların dizinleri. Bunu tüm Buttons aracılığıyla yinelemek için kullanılan for ifadesinin filtre koşulu olarak alabilirsin. Bu aynı zamanda kodun geçersiz verilerin dizinini oluşturmasını önleyen bir koruma olarak görev yapar. Dizin oluşturma başarısız olursa başarısız olan yineleme atlanacağı için program yine de geçerli olacaktır (ButtonsToLights sayısını Buttons sayısı ile eşleştirmeyi unutursan bu hata oluşabilir).
    • tagged_lights_puzzle Verse cihazının örneğine bir referans. Bir sınıf tanımının içinden geçerli objenin referansını almak için Self işlevini kullanabilirsin.
    • Bu verilerle bir button_event_handler objesi oluşturma işlemi aşağıdaki gibi görünür: 
       OnBegin<override>()<suspends> : void =
  SetupPuzzleLights()
    
  for:
      ButtonIndex -> Button : Buttons
      LightIndices := ButtonsToLights[ButtonIndex]
  do:
      button_event_handler{Indices := LightIndices, PuzzleDevice := Self}
  4. Şimdi yeni oluşturulan işleyicinin OnButtonPressed() işlevini kullanarak Buton cihazının InteractedWithEvent olayına abone olabilirsin. OnButtonPressed() işlevi çağrıldığında ışık dizinlerine erişime ve oyuncunun etkileşimde bulunduğu butonla ilişkili tagged_lights_puzzle cihazının referansına sahip olursun. 
     OnBegin<override>()<suspends> : void =
     SetupPuzzleLights()
    
     for:
         ButtonIndex -> Button : Buttons
         LightIndices := ButtonsToLights[ButtonIndex]
     do:
         Button.InteractedWithEvent.Subscribe(button_event_handler{Indices := LightIndices, PuzzleDevice := Self}.OnButtonPressed)
  5. Kodu Visual Studio Code içinde kaydet.
  6. UEFN araç çubuğunda Verse Kodları Oluştur seçeneğine tıklayarak bölümdeki Verse cihazını yeni kodunla güncelleyebilirsin.
  7. Anahat Düzenleyicisi menüsünden tagged_lights_puzzle cihazını seçerek Ayrıntılar panelini aç.
  8. Ayrıntılar panelinde Buttons dizisine dört öğe ekle ve her biri için farklı bir buton ata. Kod, diğer özellikleri dolduracağı için başka bir özelliği değiştirmen gerekmez.
  9. UEFN araç çubuğunda Oyna butonuna tıklayarak bölüme oynanış testi uygula.

Artık bölümünün oynanış testini yaptığında butonlarla etkileşime girebilmelisin ve her buton ButtonsLightsIndices ayarına göre farklı bir ışık kümesini açıp kapatmalı. GetCreativeObjectsWithTag() işlevinin belirli bir sırayı garanti etmediğini, bu nedenle koddaki sıraya göre açılıp kapatılan ışıkların bölümde gördüğün sırayla eşleşmeyebileceğini aklında bulundur.

Oyuncu butonlara basıyor ve her buton farklı bir ışık kümesini açıp kapatıyor

Sonraki Adım

Bu eğitimin bir sonraki adımında bir eşya oluşturabilmek ve bulmacayla daha fazla etkileşim olmasını önlemek için oyuncunun bulmacayı çözdüğünün nasıl algılanacağını öğreneceksin.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page