2. Определение зон подбора и доставки

Зона — это участок карты (представленный устройством), где игрок может подбирать предметы или куда он может их доставлять. По завершении этого раздела урока Гонка на время: доставка пиццы вы узнаете, как создавать зоны подбора и доставки, а также деактивировать и активировать их для игрока.

Использование абстракции для создания класса зоны

Абстракция — это принцип в программировании, когда от пользователя скрываются более сложные детали, поскольку для него нет необходимости в их понимании. Абстракция описывает то, чем что-то является, без объяснения, как это работает. К примеру, вы можете купить кофе в автомате, не вникая в принципы его работы.

В игре Гонка на время: доставка пиццы есть два вида зон: зоны подбора, в которых используется устройство Генератор предметов, и зоны доставки, в которых используется устройство Область захвата. Поскольку поведение этих зон является аналогичным даже несмотря на то, что это разные устройства (то есть оба могут быть активированы и деактивированы), вы можете создать класс, чтобы абстрагировать это поведение через стандартный объект зоны, который будет обрабатывать взаимодействие с конкретным устройством.

Ниже пошагово описан процесс создания класса зоны:

1. Создайте новый пустой файл Verse с именем pickup_delivery_zone.verse и откройте его в Visual Studio Code.

2. В файле Verse создайте новый класс с именем base_zone со спецификатором public и добавьте следующее:

   • Константу creative_object_interface с именем ActivatorDevice и спецификатором public для хранения устройства, используемого в зоне.

   • Событие ZoneCompletedEvent со спецификатором public для сигнализации о взаимодействии игрока с этой зоной (подбор или доставка предмета).

   • Функцию ActivateZone(), возвращающую значение типа void и имеющую спецификатор public, для активации устройства, используемого в зоне.

   • Функцию DeactivateZone(), возвращающую значение типа void и имеющую спецификатор public, для деактивации устройства, используемого в зоне.

     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)

     Если класс и его члены имеют спецификатор public, то они всегда доступны из других частей кода. Более подробно это описано в разделе Спецификаторы и атрибуты.

3. В функции ActivateZone() проверьте, является ли ActivatorDevice устройством «Область захвата» или «Генератор предметов», путём приведения типа ActivatorDevice к другим типам и вызова функции Enable() для уже преобразованного устройства. Выполните то же самое с функцией DeactivateZone(), только в этом случае вызовите функцию Disable().

   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. Создайте функцию с именем WaitForZoneCompleted() со спецификаторами private и suspends. Эта функция инициирует событие ZoneCompletedEvent при возникновении события для конкретного устройства. Благодаря такому подходу коду в других местах будет достаточно дождаться ZoneCompletedEvent без необходимости проверять, какое конкретно событие используется задействованным устройством.

   Verse

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

   Copy full snippet(4 lines long)

   Чтобы иметь возможность вызова DeviceEvent.Await(), данная функция должна иметь эффект suspends.

5. Обновите ActivateZone(), добавив выражение spawn, которое вызывает функцию WaitForZoneCompleted() с соответствующим событием устройства для игрока, взаимодействующего с устройством, — AgentEntersEvent для устройства «Область захвата» и ItemPickedUpEvent для устройства «Генератор предметов». WaitForZoneCompleted ожидает параметр option (на что указывает ?) типа awaitable(agent), поэтому мы можем передать параметр любого типа, в котором реализован ожидаемый интерфейс awaitable, с параметрическим типом, эквивалентным agent. Как CaptureArea.AgentEntersEvent, так и ItemSpawner.ItemPickedUpEvent отвечают данному условию, поэтому мы можем использовать их в качестве параметра. Это ещё один пример абстракции.

   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. Добавьте ещё одно событие ZoneDeactivatedEvent со спецификатором protected. Это событие необходимо для завершения функции WaitForZoneCompleted(), если зона деактивируется до того, как игрок её завершит. Сообщите об этом событии внутри функции DeactivateZone().

   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() выражение race, чтобы функция ожидала либо завершения зоны игроком, либо деактивации зоны. При использовании выражения race асинхронный вызов функции ZoneDeactivatedEvent.Await(), а также блочное выражение с событием устройства и сигналом ZoneCompletedEvent будут выполняться одновременно, при этом выполнение выражения, которое не завершится первым, будет отменено. 

   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. Наконец, создайте конструктор для класса base_zone, который будет инициализировать поле ActivatorDevice. 

   Verse

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

   Copy full snippet(1 line long)

9. Ниже приведён полный код класса base_zone.

   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)

Поиск зон в среде выполнения с помощью тегов игрового процесса

Теперь, когда у нас есть возможность создавать зоны и активировать/деактивировать их, добавим способ инициализации всех зон на уровне, которым вы присвоили теги, а также способ выбора следующей зоны для активации.

Рассмотрим это ниже на примере класса, отвечающего за создание зон и выбор следующей зоны для активации.

Ниже пошагово описан процесс создания класса для создания и выбора зон:

1. Создайте новый класс с именем tagged_zone_selector в файле pickup_delivery_zone.verse. Добавьте массив переменных для хранения всех зон на уровне. tagged_zone_selector<public> := class: var Zones<protected> : []base_zone = array{}

2. Добавьте метод InitZones() со спецификатором public и параметром tag, чтобы найти все зоны, связанные с этим тегом игрового процесса, и кэшировать их. 

   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. Добавьте метод с именем SelectNext() со спецификаторами decides и transacts, чтобы метод либо находил другую зону, либо завершался с ошибкой. Выберите зону со случайным индексом в массиве при помощи GetRandomInt(0, Zones.Length - 1).

   Verse

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

   Copy full snippet(2 lines long)

4. Теперь файл pickup_delivery_zone.verse должен выглядеть следующим образом:

   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)

Тестирование зон подбора и доставки

Мы успешно создали два класса, поэтому хорошо бы протестировать написанный код и убедиться, что выбор зоны работает, как задумано.

Внесите следующие изменения в файл game_coordinator_device.verse:

1. Добавьте константу для селектора зоны доставки и массив переменных для селекторов зон подбора в game_coordinator_device. Поскольку в дальнейшем игра будет повышать уровень подбора после каждого подбора пиццы, вам понадобится один tagged_zone_selector для каждого уровня подбора, который должен быть в игре, в связи с чем мы и используем массив PickupZoneSelectors. Каждый селектор зоны содержит все зоны подбора определённого уровня. Это должна быть переменная, так как при её создании учитывается количество тегов pickup_zone_tag в массиве PickupZoneLevelTags.

2. Используйте следующий способ для увеличения количества уровней подбора, внеся минимум изменений в код: достаточно будет добавить в PickupZoneLevelTags дополнительные теги, производные от pickup_zone_tag, а затем присвоить соответствующие теги устройствам в редакторе. 

   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() и вызовите его в OnBegin():

   • Задайте для метода спецификатор private и тип возвращаемого значения void.

   • Инициализируйте селектор зоны доставки тегом delivery_zone_tag.

   • Создайте теги уровней зоны подбора и инициализируйте селекторы зоны подбора.

     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(), который будет выбирать следующую зону подбора, активировать её, ожидать, когда игрок завершит зону, после чего деактивировать зону.

   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, скомпилируйте код и протестируйте уровень в игре.

Когда вы запустите игровой тест уровня, в начале игры активируется одно из устройств «Генератор предметов». После того как вы подберёте предмет, устройство «Генератор предметов» будет деактивировано, а затем активируется устройство «Область захвата». Данный цикл будет работать, пока вы не завершите игру вручную.

Следующий шаг

• 

  3. Создание игрового цикла

  Создайте игру на Verse, в которой игрокам нужно будет забирать и доставлять пиццу до того, как истечёт время!