1. Epic GamesDeveloper
  3. 3. Поиск лампочек в среде выполнения по тегам игрового процесса

3. Поиск лампочек в среде выполнения по тегам игрового процесса

Используйте устройство на Verse, чтобы создать головоломку, в которой игроку требуется найти правильную комбинацию включённых лампочек для получения предмета.

3. Поиск лампочек в среде выполнения по тегам игрового процесса
Prerequisite topics

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

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

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

  1. Откройте Проводник Verse и дважды щёлкните по файлу tagged_lights_puzzle.verse, чтобы открыть его в Visual Studio Code.
  2. В верхней части файла:
    • Добавьте строку using { /Verse.org/Simulation/Tags }, чтобы добавить ссылку на класс tag и получить доступ к функции GetCreativeObjectsWithTag().
    • Добавьте строку using { /Verse.org/Simulation }, чтобы получить возможность создавать редактируемые свойства.
     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 добавьте новый подкласс с названием puzzle_light, который будет наследоваться от класса tag. Название подкласса станет пользовательским тегом игрового процесса, который вы сможете использовать на любом устройстве творческого режима.

     # Наследуется от класса `tag` из модуля Verse.org/Simulation/Tags для создания нового тега игрового процесса.
 puzzle_light := class(tag){}

 log_tagged_lights_puzzle := class(log_channel){}
  4. На панели инструментов UEFN нажмите на Создать сценарии Verse, чтобы скомпилировать код и новый тег игрового процесса puzzle_light для проекта.
  5. Чтобы открыть панель Сведения устройства, выберите Настраиваемое освещение в разделе Окно сборки в UEFN.
  6. На панели «Сведения»:
    1. Нажмите на Добавить новый компонент и выберите Разметка тегов Verse.
    2. Выберите компонент Разметка тегов Verse, чтобы отобразить его настройки на панели Сведения.
    3. В разделе Теги игрового процесса отредактируйте свойство Теги и добавьте тег puzzle_light.
    Добавление компонента VerseTagMarkup и тега puzzle_light

    К одному устройству можно добавить сразу несколько тегов, поэтому каждое устройство может одновременно принадлежать к нескольким группам. Например, устройство с тегами tag1 и tag2 будет найдено как при вызове GetCreativeObjectsWithTag(tag1{}), так и при вызове GetCreativeObjectsWithTag(tag2{}).
  7. В определении класса tagged_lights_puzzle добавьте два массива переменных:
    • Редактируемый массив переменных типа logic с именем LightsState для представления текущего состояния всех лампочек (включены/выключены). Он также используется для того, чтобы задать начальное состояние лампочек, поэтому количество его элементов должно соответствовать количеству лампочек с тегом puzzle_light. В этом примере все лампочки по умолчанию не горят, поэтому начальное значение для них будет false. 
       @editable
 var LightsState : []logic = array{false, false, false, false}
    • Редактируемый массив переменных Lights типа customizable_light_device для хранения всех устройств «Настраиваемое освещение» с тегом игрового процесса puzzle_light. 
       @editable
 var Lights : []customizable_light_device = array{}
  8. Когда игра начинается, устройство должно настроить лампочки в соответствии с начальной конфигурацией, указанной в массиве LightsState, а также сохранить ссылки в массиве Lights, чтобы их можно было обновлять при изменении состояния игры. Эта задача будет выполняться в методе SetupPuzzleLights() : void и вызываться в методе OnBegin() для подготовки лампочек в момент запуска игры. 
     SetupPuzzleLights() : void =
     Logger.Print("Подготавливаю лампочки в игре")
    
 OnBegin<override>()<suspends> : void =
     SetupPuzzleLights()
  9. В SetupPuzzleLights() мы находим все устройства с тегом puzzle_light путём вызова GetCreativeObjectsWithTag(puzzle_light{}) и сохранения их в массив TaggedActors. Так как массив TaggedActors изменяться не будет, а его область видимости находится в пределах SetupPuzzleLights(), вам не нужно явно указывать тип массива, так как в данном контексте он определяется логически. 
     SetupPuzzleLights() : void =
     Logger.Print("Подготавливаю лампочки в игре")
     TaggedActors := GetCreativeObjectsWithTag(puzzle_light{})

    Различные вызовы функции GetCreativeObjectsWithTag() могут расположить устройства в получаемом массиве в разном порядке: всё потому, что нет определённого порядка при получении акторов с тегами игрового процесса.
  10. После того, как мы собрали все устройства с тегом puzzle_light, необходимо убедиться, что каждая лампочка соответствует начальному состоянию, указанному в массиве LightsState. Для этого мы можем воспользоваться циклом for. 
     for:
     ActorIndex -> TaggedActor : TaggedActors
 do:
     TaggedActor
  11. Функция GetCreativeObjectsWithTag() возвращает массив объектов типа creative_object_interface. В этом примере нам будет необходимо взаимодействовать с каждым актором TaggedActor как с объектом customizable_light_device для включения/выключения лампочки.
    • Вы можете преобразовать класс в один из его подклассов (это называется приведение типов), используя синтаксис NewDeviceReference := device_type_to_cast_to[DeviceReference], где device_type_to_cast_to — это нужный вам тип устройства, в качестве которого в данном примере выступает customizable_light_device. Здесь используется выражение с возможностью ошибкой, поскольку приведение типов может не выполниться, если устройство невозможно будет привести к данному типу (например если это устройство другого типа). 
       LightDevice := customizable_light_device[TaggedActor]

    Функция GetCreativeObjectsWithTag() возвращает тип []creative_object_interface: она может возвращать различные типы акторов, поэтому возвращаемый ей тип объекта — это интерфейс, который должен быть реализован во всех акторах, что и позволит возвращать соответствующий объект в GetCreativeObjectsWithTag(). Более подробно это описано в разделе, посвящённом тегам игрового процесса.
    • С конструкциями for можно использовать выражения с возможной ошибкой в качестве фильтра и создавать новые переменные, которые затем можно будет использовать в блоке кода for. В этом случае к выражению итерации добавьте преобразование типа к customizable_light_device из предыдущего шага. 
       for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
 do:
      LightDevice
    • Последнее выражение в блоке кода — это результат блока кода. Выражение for возвращает результат блока кода для каждой итерации в массиве, поэтому результатом этого выражения с for будет являться массив ссылок на объекты customize_light_device с тегом puzzle_light. Это означает, что вы можете напрямую обновить массив Lights при помощи результата выражения for. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
 do:
      LightDevice
    • В этом цикле for для лампочек также должны вызываться методы TurnOn() / TurnOff(), чтобы обеспечить соответствие их начальному состоянию LightsState, установленному в редакторе. Выражение for может возвращать индекс, используемый для получения текущего устройства с тегом (в нашем примере — ActorIndex), который вы можете использовать для обращения к массиву LightsState, чтобы узнать, должна ли лампочка быть включена или выключена. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
      ShouldLightBeOn:= LightsState[ActorIndex]
 do:
      LightDevice
    • Далее вызовите метод TurnOn() / TurnOff() в зависимости от того, каким является значение ShouldLightBeOn (true / false). Вы можете использовать выражение с if для выполнения различных выражений на основе условия (в частности, это относится к выражениям с возможной ошибкой). В этом случае для выражения с возможной ошибкой можно использовать оператор запроса ? с IsLightOn, которое успешно выполнится, если ShouldLightBeOn будет возвращать true (и будет вызван метод TurnOn()), либо не выполнится, если ShouldLightBeOn будет false (и будет вызван метод TurnOff()). 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[TaggedActor]
      ShouldLightBeOn := LightsState[ActorIndex]
 do:
      if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
      LightDevice
    • Также будет полезно выводить на экран индекс лампочки и её начальное значение, чтобы убедиться, что код работает должным образом, а также сравнить с тем, что мы видим на уровне.
    • При использовании фигурных скобок {} в середине строки выражение между ними рассчитывается первым и его значение добавляется к строке. Таким образом, вы можете использовать выражение if в середине строки для добавления значений при соблюдении условия. 
       set Lights = for:
      ActorIndex -> TaggedActor : TaggedActors
      LightDevice := customizable_light_device[ActorIndex]
      ShouldLightBeOn := LightsState[ActorIndex]
 do:
      Logger.Print("Добавляю лампочку с индексом {ActorIndex} и состоянием:{if (ShouldLightBeOn?) then "Вкл." else "Выкл."}")
      if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
      LightDevice
  12. Метод SetupPuzzleLights() теперь должен выглядеть следующим образом: 
     SetupPuzzleLights() : void =
     TaggedActors := GetCreativeObjectsWithTag(puzzle_light{})
     <#
     Проверяем, относится ли каждое устройство с тегом puzzle_light к типу customizable_light_device путём приведения типов.
     Если это так, получаем его начальное состояние LightState, чтобы включить (TurnOn()) или выключить (TurnOff()) устройство LightDevice.
     Сохраняем все объекты customizable_light_device с тегом в массив Lights.
     #>
     set Lights = for:
             ActorIndex -> TaggedActor : TaggedActors
             LightDevice := customizable_light_device[TaggedActor]
             ShouldLightBeOn := LightsState[ActorIndex]
     do:
             Logger.Print("Добавляю лампочку с индексом {ActorIndex} и состоянием:{if (ShouldLightBeOn?) then "Вкл." else "Выкл."}")
             if (ShouldLightBeOn?) then LightDevice.TurnOn() else LightDevice.TurnOff()
             LightDevice
  13. Сохраните сценарий в Visual Studio Code.
  14. На панели инструментов UEFN нажмите на Создать сценарии Verse, чтобы скомпилировать код.
  15. Нажмите Играть на панели инструментов UEFN, чтобы протестировать уровень.

Во время тестирования уровня вы должны увидеть, что каждая лампочка в массиве Lights выводится в журнале выходных данных вместе с её начальным состоянием.

Что дальше

Дальше вы узнаете, как переключать определённую комбинацию лампочек по нажатию кнопки игроком.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page