2. Alma ve Teslim Bölgelerini Tanımlama

Bölge, oyuncunun eşyaları alabileceği veya teslim edebileceği bir harita alanıdır (bir cihaz ile gösterilir). Time Trial: Pizza Pursuit eğitimindeki bu adımı tamamlayarak bu alma ve teslim bölgelerini nasıl oluşturacağını ve oyuncu için nasıl etkinleştireceğini/devre dışı bırakacağını öğreneceksin.

Bir Bölge Sınıfı Oluşturmak İçin Soyutlama Kullanma

Soyutlama, kullanıcının ilk bakışta görünür olmayan karmaşık konuları anlamasının gerekmediği durumlarda gereksiz ayrıntıların kullanıcıdan gizlendiği bir programlama ilkesidir. Soyutlama, bir şeyin işleyişini öğretmeden o şeyin ne olduğunu açıklar. Örneğin, bir otomata para koyabilir ve teknik ayrıntıların nasıl işlediğini anlamadan güzel bir yiyecek alabilirsin.

Time Trial: Pizza Pursuit’te iki tür bölge vardır: Eşya Çıkma Yeri cihazını kullanan alma bölgeleri ve Ele Geçirme Alanı cihazını kullanan teslim bölgeleri. Bu bölgeler farklı cihazlar olmasına rağmen aynı şekilde davranacağından (yani her ikisi de etkinleştirilebilir ve devre dışı bırakılabilir) bu davranışı belirli cihaz etkileşimlerini işleyen bir genel bölge objesine çıkarmak için bir sınıf oluşturabilirsin.

Bu bölge sınıfını oluşturmak için şu adımları izle:

1. pickup_delivery_zone.verse adlı yeni bir boş Verse dosyası oluştur ve Visual Studio Code ile aç.

2. Verse dosyasında, public belirleyicisi ile base_zone adlı yeni bir sınıf oluştur ve şunları ekle:

   • Bölgede kullanılan cihazı depolamak için public belirleyicisi ile ActivatorDevice olarak adlandırılmış bir creative_object_interface sabiti.

   • Oyuncu eşya alma veya teslim etme gibi eylemlerle bu bölgeyle etkileşime geçtiğinde sinyal vermek için public belirleyicisine sahip ZoneCompletedEvent adlı bir olay.

   • Bölge için kullanılan cihazı etkinleştirmek için void dönüş türüne ve public belirleyicisine sahip ActivateZone() adlı bir fonksiyon.

   • Bölge için kullanılan cihazı devre dışı bırakmak için void dönüş türüne ve public belirleyicisine sahip DeactivateZone() adlı bir fonksiyon.

     Verse

     base_zone<public> := class:
                                   ActivatorDevice<public> : creative_object_interface
                                   ZoneCompletedEvent<public> : event(base_zone) = event(base_zone){}
     								
                                   ActivateZone<public>() : void =
          Print("Zone activated")
     								
                                   DeactivateZone<public>() : void =
          Print("Zone deactivated")
     

     Copy full snippet(9 lines long)

     Bir sınıf ve üyeleri public belirleyicisine sahip olduğunda bu sınıfa ve üyelerine diğer kodlardan evrensel olarak erişilebilir. Daha fazla ayrıntı için Belirleyiciler ve Öznitelikler bölümüne bakabilirsin.

3. ActivateZone() fonksiyonunda ActivatorDevice cihazını farklı türlere dönüştürerek ActivatorDevice cihazının bir Ele Geçirme Alanı cihazı mı yoksa Eşya Oluşturma Yeri cihazı mı olduğunu kontrol et ve dönüştürülen cihazda Enable() fonksiyonunu çağır. Aynı işlemi DeactivateZone() fonksiyonu için de yap ancak Disable() fonksiyonunu çağır.

   Verse

        base_zone<public> := class:
            ActivatorDevice<public> : creative_object_interface
   		
            ActivateZone<public>() : void =
                Print("Zone activated")
                if (CaptureArea := capture_area_device[ActivatorDevice]):
                    CaptureArea.Enable()
                else if (ItemSpawner := item_spawner_device[ActivatorDevice]):
                    ItemSpawner.Enable()
   		
   
   Expand code Copy full snippet(16 lines long)

4. private belirleyicisine ve suspends belirleyicisine sahip WaitForZoneCompleted() adlı bir fonksiyon oluştur. Bu fonksiyon, cihaza özgü olay gerçekleştiğinde ZoneCompletedEvent sinyalini verir. Bu ayar sonucunda diğer kodun ZoneCompletedEvent sinyalini beklemesi ve altta yatan cihazın kullandığı olayın türünü göz ardı etmesi gerekir.

   Verse

        WaitForZoneCompleted<private>(ZoneDeviceCompletionEventOpt : ?awaitable(agent))<suspends> : void =
            if (DeviceEvent := ZoneDeviceCompletionEventOpt?):
                DeviceEvent.Await()
                ZoneCompletedEvent.Signal(Self)
   

   Copy full snippet(4 lines long)

   Bu fonksiyonun DeviceEvent.Await() çağrısı yapabilmek için suspends efektine sahip olması gerekir.

5. ActivateZone() fonksiyonunu, cihazla etkileşimde bulunan oyuncu için uygun cihaz olayını kullanarak WaitForZoneCompleted() çağrısı yapan bir spawn ifadesiyle güncelle: Ele geçirme alanı cihazı için AgentEntersEvent ve eşya çıkma yeri cihazı için ItemPickedUpEvent. WaitForZoneCompleted, awaitable(agent) türünde bir option (? ile gösterilir) parametresi bekler. Böylece awaitable arayüzünü uygulayan herhangi bir türü, bu türün agent değerine eşit parametrik türüyle geçirebiliriz. Hem CaptureArea.AgentEntersEvent hem de ItemSpawner.ItemPickedUpEvent bu koşulla uyumlu olduğu için bunları parametre olarak kullanabiliriz. Bu da soyutlamanın bir diğer örneğidir.

   Verse

        ActivateZone<public>() : void =
            Print("Zone activated")
            if (CaptureArea := capture_area_device[ActivatorDevice]):
                CaptureArea.Enable()
                spawn { WaitForZoneCompleted(option{CaptureArea.AgentEntersEvent})}
            else if (ItemSpawner := item_spawner_device[ActivatorDevice]):
                ItemSpawner.Enable()
                spawn { WaitForZoneCompleted(option{ItemSpawner.ItemPickedUpEvent}) }
   

   Copy full snippet(8 lines long)

6. protected belirleyicisine sahip ZoneDeactivatedEvent adlı başka bir olay ekle. Bu olay, oyuncu tamamlamadan bölge devre dışı bırakılırsa WaitForZoneCompleted() fonksiyonunu sonlandırmak için gereklidir. Bu olayı DeactivateZone() fonksiyonunda bildir.

   Verse

        ZoneDeactivatedEvent<protected> : event() = event(){}
   		
        DeactivateZone<public>() : void =
            Print("Zone deactivated")
            if (CaptureArea := capture_area_device[ActivatorDevice]):
                CaptureArea.Disable()
            else if (ItemSpawner := item_spawner_device[ActivatorDevice]):
                ItemSpawner.Disable()
            ZoneDeactivatedEvent.Signal()
   

   Copy full snippet(9 lines long)

7. WaitForZoneCompleted() fonksiyonunu, oyuncunun bölgeyi tamamlamasını veya bölgenin devre dışı bırakılmasını bekleyecek şekilde bir race ifadesiyle güncelle. race ifadesiyle ZoneDeactivatedEvent.Await() asenkron fonksiyon çağrısı, cihaz olayı ve ZoneCompletedEvent sinyali ile de block ifadesi aynı anda çalışır ancak ilk önce tamamlanmayan ifade iptal edilir. 

   Verse

   WaitForZoneCompleted<private>(ZoneDeviceCompletionEventOpt : ?awaitable(agent))<suspends> : void = if (DeviceEvent := ZoneDeviceCompletionEventOpt?): race: block: DeviceEvent.Await() ZoneCompletedEvent.Signal(Self) ZoneDeactivatedEvent.Await()

   Copy full snippet(1 line long)

8. Son olarak, base_zone sınıfı için ActivatorDevice alanını başlatacak olan bir oluşturucu yap. 

   Verse

   MakeBaseZone<constructor><public>(InActivatorDevice : creative_object_interface) := base_zone: ActivatorDevice := InActivatorDevice

   Copy full snippet(1 line long)

9. base_zone sınıfı için tam kod aşağıdaki gibidir.

   Verse

        # A zone is an area of the map (represented by a device) that can be Activated/Deactivated and that provides events to signal when the zone has been "Completed" (can't be completed anymore until next activation).
        # Zone "Completed" depends on the device type (ActivatorDevice) for the zone.
        # Suggested usage: ActivateZone() -> ZoneCompletedEvent.Await() -> DeactivateZone() #
   		
        base_zone<public> := class:
            ActivatorDevice<public> : creative_object_interface
            ZoneCompletedEvent<public> : event(base_zone) = event(base_zone){}
   		
            GetTransform<public>() : transform =
                ActivatorDevice.GetTransform()
   
   Expand code Copy full snippet(46 lines long)

Oynanış Etiketleriyle Çalışma Zamanında Bölge Bulma

Artık bölgeleri oluşturmanın ve etkinleştirmenin/devre dışı bırakmanın yolunu öğrendiğine göre bölümde etiketlediğin tüm bölgeleri başlatma ve etkinleştirilecek bir sonraki bölgeyi seçmenin bir yolunu ekleyelim.

Bu örnek, bu işlemin bölge oluşturmaktan ve etkinleştirilecek bir sonraki bölgeyi seçmekten sorumlu bir sınıfla nasıl yapılacağını gösteriyor.

Bölge oluşturmak ve seçmek üzere sınıf oluşturmak için şu adımları izle:

1. pickup_delivery_zone.verse dosyasında tagged_zone_selector adlı yeni bir sınıf oluştur. Tüm bölgeleri bölümde depolamak için bir değişken dizisi ekle. tagged_zone_selector<public> := class: var Zones<protected> : []base_zone = array{}

2. Söz konusu Oynanış Etiketiyle ilişkili tüm bölgeleri bulmak ve önbelleğe almak için public belirleyicisine ve bir tag parametresine sahip InitZones() adlı bir metot ekle. 

   Verse

   InitZones<public>(ZoneTag : tag) : void =
    
   # On creation of a zone selector, find all available zones and cache them so we don't consume time searching for tagged devices every time the next zone is selected.
    
   ZoneDevices := GetCreativeObjectsWithTag(ZoneTag) 
   set Zones = 
     for (ZoneDevice : ZoneDevices): MakeBaseZone(ZoneDevice)

   Copy full snippet(7 lines long)

3. Yöntemin başka bir bölge bulması veya başarısız olması için decides ve transacts belirleyicisine sahip SelectNext() adlı bir metot ekle. Dizin için GetRandomInt(0, Zones.Length - 1) kullanarak dizideki rastgele bir dizinde bulunan bölgeyi seç.

   Verse

        SelectNext<public>()<transacts><decides> : base_zone =
            Zones[GetRandomInt(0, Zones.Length - 1)]

   Copy full snippet(2 lines long)

4. pickup_delivery_zone.verse dosyasının tam kodu şu anda böyle görünmelidir:

   Verse

        using { /Verse.org/Simulation }
        using { /Verse.org/Random }
        using { /Verse.org/Concurrency }
        using { /Verse.org/Simulation/Tags }
        using { /UnrealEngine.com/Temporary/SpatialMath }
        using { /Fortnite.com/Devices }
   
        <# A zone is an area of the map (represented by a device) that can be Activated/Deactivated and that provides events
        to signal when the zone has been "Completed" (can't be completed anymore until next activation).
        Zone "Completed" depends on the device type (ActivatorDevice) for the zone.
   
   Expand code Copy full snippet(68 lines long)

Alma ve Teslim Bölgelerini Test Etme

Artık iki sınıf oluşturduğuna göre bölge seçiminin beklediğin gibi çalıştığından emin olmak için kodunu test etmende yarar var.

game_coordinator_device.verse dosyanı güncellemek için şu adımları izle:

1. game_coordinator_device cihazına teslim bölgesi seçici için bir sabit, alma bölgesi seçicileri için de bir değişken dizi ekle. Oyun her pizza alımından sonra alma seviyesini yükselteceğinden oyunda istediğin her alma seviyesi için bir tagged_zone_selector ve dolayısıyla PickupZoneSelectors dizisi gerekecektir. Her bölge seçici, belirli bir seviyenin tüm alma bölgelerini tutar. Bunun bir değişken olması gerekir çünkü ayarı, PickupZoneLevelTags içindeki pickup_zone_tag etiketlerinin sayısına göre belirlenir.

2. Kodda minimum değişiklik yaparak alma seviyelerinin sayısını artırmak için bu ayarı kullan: Tek yapman gereken PickupZoneLevelTags fonksiyonunu pickup_zone_tag etiketinden türetilen etiketlerle güncellemek, ardından editörde cihazları etiketlemek. 

   Verse

   game_coordinator_device<public> := class<concrete>(creative_device): DeliveryZoneSelector<private> : tagged_zone_selector = tagged_zone_selector{} 
   var PickupZoneSelectors<private> : []tagged_zone_selector = array{}

   Copy full snippet(2 lines long)

3. SetupZones() adlı bir metot oluştur ve OnBegin() fonksiyonunda metodu çağır:

   • Metodu private belirleyicisine ve void dönüş türüne sahip olacak şekilde ayarla.

   • Teslim bölgesi seçiciyi delivery_zone_tag ile başlat.

   • Alma bölgesi seviye etiketlerini oluştur ve alma bölgesi seçicileri başlat.

     Verse

     OnBegin<override>()<suspends> : void =
        SetupZones()
     								
     SetupZones<private>() : void =
                                   DeliveryZoneSelector.InitZones(delivery_zone_tag{})
     								
                                   PickupZoneLevelTags : []pickup_zone_tag = array{pickup_zone_level_1_tag{}, pickup_zone_level_2_tag{}, pickup_zone_level_3_tag{}}
     								set PickupZoneSelectors = 
     for(PickupZoneTag : PickupZoneLevelTags):
     PickupZone := tagged_zone_selector{}
     
     Expand code Copy full snippet(12 lines long)

4. OnBegin() içinde bir sonraki alma bölgesini seçen, etkinleştiren, oyuncunun bölgeyi tamamlamasını bekleyen ve sonra bölgeyi devre dışı bırakan bir döngü oluştur.

   Verse

   OnBegin<override>()<suspends> : void =
   SetupZones()
   		
   var PickupLevel : int = 0
   		
   loop:
      if (PickupZone : base_zone = PickupZoneSelectors[PickupLevel].SelectNext[]):
         PickupZone.ActivateZone()
         PickupZone.ZoneCompletedEvent.Await()
         PickupZone.DeactivateZone()
   
   Expand code Copy full snippet(21 lines long)

5. Verse dosyalarını kaydet, kodunu derle ve bölümüne oynanış testi uygula.

Bölümüne oynanış testi uyguladığında oyunun başlangıcında Eşya Oluşturma Yeri cihazlarından biri etkinleşir. Eşya aldıktan sonra Eşya Oluşturma Yeri cihazı devre dışı kalır ve sonra bir Ele Geçirme Alanı cihazı etkinleşir. Bu döngü sen oyunu manuel olarak sonlandırana kadar devam eder.

Sonraki Adım

• 

  3. Oyun Döngüsünü Oluşturma

  Verse ile oyuncuların süre dolmadan önce pizzaları alıp teslim etmesi gereken bir oyun oluştur!