2. Festlegen der Abhol- und Lieferzonen

Eine Zone ist ein Bereich auf der Karte (dargestellt durch ein Gerät), in dem der Spieler Gegenstände abholen oder abgeben kann. Wenn du diesen Schritt im Tutorial Time Trial: Pizza Pursuit abgeschlossen hast, weißt du, wie du diese Abhol- und Lieferzonen erstellst und sie für den Spieler aktivierst bzw. deaktivierst.

Verwendung der Abstraktion zur Erstellung einer Zonenklasse

Abstraktion ist ein Programmierprinzip, bei dem unnötige Details vor einem Benutzer verborgen werden, wobei der Benutzer die verborgenen Komplexitäten nicht verstehen muss. Abstraktion beschreibt, was etwas ist, ohne zu wissen, wie es funktioniert. Du kannst beispielsweise Geld in einen Verkaufsautomaten stecken und ein Leckerli herausholen, ohne zu verstehen, wie die Mechanik funktioniert.

Pizza PursuitIn Time Trial: Pizza Pursuit gibt es zwei Arten von Zonen: Abholpunktzonen, die das Gegenstands-Spawnpunkt-Gerät verwenden, und Lieferzonen, die das Eroberungsgebiet-Gerät verwenden. Da sich diese Zonen gleich verhalten, obwohl es sich um unterschiedliche Geräte handelt, d. h. beide können aktiviert und deaktiviert werden, kannst du eine class erstellen, die dieses Verhalten in ein generisches Zonenobjekt abstrahiert, das die spezifischen Geräteinteraktionen verarbeitet.

Befolge diese Schritte, um diese Zonenklasse zu erstellen:

1. Erstelle eine neue leere Verse-Datei mit dem Namen pickup_delivery_zone.verse und öffne sie in Visual Studio Code.

2. Erstelle in der Verse-Datei eine neue Klasse mit dem Namen base_zone mit dem Bezeichner public und füge hinzu:

   • Eine creative_object_interface-Konstante namens ActivatorDevice mit dem Bezeichner public, um das in der Zone verwendete Gerät zu speichern.

   • Ein Event mit dem Namen ZoneCompletedEvent mit dem Bezeichner public, um zu signalisieren, wenn der Spieler mit dieser Zone interagiert, z.B. Gegenstände aufhebt oder abliefert.

   • Eine Funktion mit dem Namen ActivateZone(), die den Rückgabetyp void und den Bezeichner public hat, um das für die Zone verwendete Gerät zu aktivieren.

   • Eine Funktion mit dem Namen DeactivateZone(), die den Rückgabetyp void und den Bezeichner public hat, um das für die Zone verwendete Gerät zu deaktivieren.

     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)

     Wenn eine Klasse und ihre Mitglieder den Bezeichner public haben, dann sind sie von anderem Code aus allgemein zugänglich. Weitere Einzelheiten findest du hier: Specifiers and Attributes.

3. Überprüfe in der Funktion ActivateZone(), ob es sich bei dem ActivatorDevice um ein Eroberungsgebiet-Gerät oder ein Gegenstands-Spawnpunkt-Gerät handelt, indem du das ActivatorDevice in die verschiedenen Typen umwandelst und die Funktion Enable() für das umgewandelte Gerät aufrufst. Mach dasselbe mit der Funktion DeactivateZone(), außer dass du die Funktion Disable() aufrufst.

   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. Erstelle eine Funktion mit dem Namen WaitForZoneCompleted(), die den Bezeichner private und den Bezeichner suspends hat. Diese Funktion signalisiert das ZoneCompletedEvent, wenn das gerätespezifische Ereignis eintritt. Diese Konfiguration bedeutet, dass anderer Code nur auf das ZoneCompletedEvent warten muss und sich nicht darum kümmert, welche Art von Event das zugrunde liegende Gerät verwendet.

   Verse

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

   Copy full snippet(4 lines long)

   Diese Funktion muss den Effekt suspends haben, um DeviceEvent.Await() aufrufen zu können.

5. Aktualisiere ActivateZone() mit einem spawn-Ausdruck, der WaitForZoneCompleted() mit dem entsprechenden Geräteevent für den Spieler aufruft, der mit dem Gerät interagiert: AgentEntersEvent für das Eroberungsgebiet-Gerät und ItemPickedUpEvent für das Gegenstands-Spawnpunkt-Gerät. WaitForZoneCompleted erwartet einen option-Parameter (gekennzeichnet durch ?) des Typs awaitable(agent), so dass jeder Typ, der die Schnittstelle awaitable implementiert und dessen Parametertyp gleich agent ist, übergeben werden kann. Sowohl CaptureArea.AgentEntersEvent als auch ItemSpawner.ItemPickedUpEvent erfüllen diese Bedingung, so dass wir sie als Parameter verwenden können. Dies ist ein weiteres Beispiel für Abstraktion.

   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. Füge ein weiteres Ereignis mit dem Namen ZoneDeactivatedEvent mit dem Bezeichner protected hinzu. Dieses Ereignis ist notwendig, um die Funktion WaitForZoneCompleted() zu beenden, wenn die Zone deaktiviert wird, bevor der Spieler sie beendet hat. Melde dieses Ereignis in der Funktion 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. Aktualisiere WaitForZoneCompleted() mit einem race-Ausdruck, so dass die Funktion entweder darauf wartet, dass der Spieler die Zone abschließt, oder dass die Zone deaktiviert wird. Mit dem race-Ausdruck werden der asynchrone Funktionsaufruf ZoneDeactivatedEvent.Await() und der block-Ausdruck mit dem Geräte-Event und dem Signal ZoneCompletedEvent gleichzeitig ausgeführt, aber der Ausdruck, der nicht zuerst beendet wird, wird abgebrochen. 

   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. Erstelle schließlich einen Constructor für die Klasse base_zone, der das Feld ActivatorDevice initialisiert. 

   Verse

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

   Copy full snippet(1 line long)

9. Es folgt der vollständige Code für die Klasse 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)

Zonen zur Laufzeit mit Gameplay-Tags finden

Da du nun eine Möglichkeit hast, Zonen zu erstellen und sie zu aktivieren/deaktivieren, lass uns eine Möglichkeit hinzufügen, alle Zonen, die du im Level markiert hast, zu initialisieren und lernen, wie du die nächste zur Aktivierung auswählst.

Dieses Beispiel zeigt, wie man dies mit einer Klasse macht, die für die Erstellung der Zonen und die Auswahl der nächsten zu aktivierenden Zone verantwortlich ist.

Befolge diese Schritte, um die Klasse für die Erstellung und Auswahl von Zonen zu erstellen:

1. Erstelle eine neue Klasse mit dem Namen tagged_zone_selector in der Datei pickup_delivery_zone.verse. Füge ein Variablen-Array hinzu, um alle Zonen des Levels zu speichern. tagged_zone_selector<public> := class: var Zones<protected> : []base_zone = array{}

2. Füge eine Methode mit dem Namen InitZones() hinzu, die den public-Bezeichner und einen tag-Parameter hat, um alle Zonen zu finden, die mit diesem Gameplay-Tag verbunden sind, und sie zwischenzuspeichern. 

   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. Füge eine Methode mit dem Namen SelectNext() hinzu, die die Bezeichner decides und transacts enthält, so dass die Methode entweder eine andere Zone findet oder fehlschlägt. Wähle die Zone an einem zufälligen Index im Array mit GetRandomInt(0, Zones.Length - 1) für den Index.

   Verse

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

   Copy full snippet(2 lines long)

4. Der vollständige Code der Datei pickup_delivery_zone.verse sollte nun wie folgt aussehen:

   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)

Testen von Abhol- und Lieferzonen

Nachdem du nun zwei Klassen erstellt hast, ist es eine gute Idee, deinen Code zu testen und sicherzustellen, dass deine Zonenauswahl so funktioniert, wie du es erwartest.

Befolge diese Schritte, um deine Datei game_coordinator_device.verse zu aktualisieren:

1. Füge eine Konstante für den Lieferzonen-Selektor und ein Variablen-Array für die Abholzonen-Selektoren zum game_coordinator_device hinzu. Da das Spiel später den Abholpunkt-Level nach jedem Pizzasammeln erhöht, brauchst du einen tagged_zone_selector für jeden Abholpunkt-Level, den du im Spiel haben willst, daher das PickupZoneSelectors-Array. Jeder Zonen-Selektor enthält alle Abholpunkt-Zonen einer bestimmten Ebene. Er muss eine Variable sein, weil seine Einrichtung durch die Anzahl der pickup_zone_tags in PickupZoneLevelTags bestimmt wird.

2. Benutze dieses Setup, um die Anzahl der Abholpunkt-Ebenen mit minimalen Änderungen am Code zu erweitern: Du musst nur die PickupZoneLevelTags mit zusätzlichen, von pickup_zone_tag abgeleiteten, aktualisieren und dann die Geräte im Editor taggen. 

   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. Füge eine Methode namens SetupZones() hinzu und rufe die Methode in OnBegin() auf:

   • Richte die Methode so ein, dass sie den Bezeichner private und einen Rückgabetyp void hat.

   • Initialisiere den Lieferzonen-Selektor mit dem delivery_zone_tag.

   • Erstelle die Abhol-Zonen-Leveltags und initialisiere die Abhol-Zonen-Selektoren.

     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. Erstelle eine Schleife in OnBegin(), die die nächste Abholzone auswählt, sie aktiviert, darauf wartet, dass der Spieler die Zone abschließt, und dann die Zone wieder deaktiviert.

   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. Speichere deine Verse-Dateien, kompiliere deinen Code und teste dein Level.

Wenn du dein Level testest, wird eines der Gegenstands-Spawnpunkt-Geräte zu Beginn des Spiels aktiviert. Sobald du den Gegenstand aufgesammelt hast, wird das Gegenstands-Spawnpunkt-Gerät deaktiviert und ein Gerät für das Eroberungsgebiet aktiviert. Das geht so lange, bis du das Spiel manuell beendest.

Nächster Schritt

• 

  3. Die Spielschleife erstellen

  Erstelle ein Spiel mit Verse, bei dem die Spieler Pizzas abholen und ausliefern müssen, bevor die Zeit abläuft!