Переход точки зрения игрока с помощью камер

Камеры играют ключевую роль во внешнем виде и атмосфере игры. Камеры от третьего лица могут дать игрокам более реальное ощущение пространства, а камеры от первого лица позволяют ближе рассмотреть игровой мир. Переключение камер во время игры может вызывать различные чувства, а переход между разными камерами может разнообразить игровой процесс. Например, вы можете создать забавное платформенное испытание, используя фиксированную камеру для создания секции с боковой прокруткой.

В UEFN вы можете использовать Verse для программирования изменений камеры. Используя устройства для прослушивания событий, вы можете добавить камеру к игроку, чтобы изменить его вид при активации события. В этом примере в конце внутриигрового видео мы добавим к игроку устройство «Вращающаяся камера». Вы можете изменить настройки камеры кругового вращения, чтобы имитировать вид от первого лица, а добавив камеру в конце внутриигрового видео, вы можете создать плавный переход от третьего лица к первому. Чтобы разнообразить игровой процесс, в этом примере игрок берёт оружие и размахивает им у двери, запуская внутриигровое видео. Вы можете адаптировать этот пример к вашим потребностям: например, игрок может вращать гаечный ключ, чтобы починить неисправную дверь корабля, или размахивать молотком, чтобы разбить валун и открыть секретную область. Вы также можете более широко применять эти концепции для создания интересных игровых моментов, таких как широкий план при входе в новую зону, переключение на вид сверху вниз, когда игроку нужно решить головоломку, или вид от первого лица для создания пугающей атмосферы.

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

В данном примере используются следующие возможности языка:

• Класс: в этом примере создаётся класс Verse, активирующий внутриигровое видео, когда игрок открывает дверь.

• Option: вы можете хранить события, на которые можно подписаться, в переменных типа option, и отменять подписку на эти события в дальнейшем.

В данном примере используются следующие API:

• С возможностью подписаться: подписка на события выполняется, чтобы узнавать, когда игрок входит в область рядом с дверью, а также чтобы предоставлять игрокам предмет при взаимодействии с кнопкой.

Подготовка уровня

В данном примере используются следующие устройства:

• 1 устройство «Кнопка»: при взаимодействии с кнопкой игрок будет получать меч от устройства выдачи предметов.

• 1 «Устройство выдачи предметов»: устройство выдачи предметов выдаёт игроку меч, необходимый для прохождения через дверь.

• 1 устройство «Кнопка с условием»: требуемое оружие устанавливается как предмет-ключ для кнопки с условием, в связи с чем игрок не сможет пройти через дверь, если у него не окажется необходимого меча.

• 1 устройство «Активация при нажатии»: открывает дверь, когда игрок атакует, прослушивая действие ввода атаки. Это происходит только тогда, когда игрок находится внутри устройства области, если у игрока есть меч, а дверь ещё не открыта.

• 1 устройство «Область»: поскольку дверь не должна открываться при любом триггере атаки мечом, устройство области перед открытием двери будет проверять, что игрок находится непосредственно рядом с дверью.

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

• 1 устройство «Вращающаяся камера»: для создания вида от первого лица будет использоваться вращающаяся камера, расположенная в груди персонажа, что позволит имитировать вид от первого лица. Это изменение вида происходит только после видео, когда игрок открывает дверь.

• 1 устройство «Замок»: удерживает дверь в запертом состоянии, чтобы игрок не смог открыть её без необходимого оружия.

• 1 устройство «Указатель на карте»: отображает расположение двери на мини-карте, когда игрок берёт в руки оружие.

Выполните следующие действия, чтобы настроить уровень:

Кнопка и устройство выдачи предметов

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

1. Добавьте одно устройство выдачи предметов на уровень.

2. Выберите устройство выдачи предметов в окне Структура. На панели Сведения устройства в разделе Пользовательские настройки задайте следующие значения:

   

   Настройка	Значение	Пояснение
   Определение предмета	Меч	Это оружие, которым игрок открывает дверь.
   Использовать полученный предмет	Истина	В этом примере игрок берёт оружие и сразу же вооружается им.

3. Добавьте одно устройство Кнопка на уровень.

4. Выберите кнопку на панели Структура. На панели Сведения устройства в разделе Пользовательские настройки задайте следующие значения:

   

   Настройка	Значение	Пояснение
   Текст при взаимодействии	«Взять»	Этот текст предлагает игроку взаимодействовать с кнопкой.
   Количество срабатываний	1-й	В этом примере игрок может взять оружие только один раз.

Активация при нажатии

Чтобы узнать, когда игрок взмахивает оружием, вы можете использовать активацию при нажатии, которая прослушивает определённое действие. Когда игрок взмахивает оружием, происходит активация при нажатии. Выполните следующие шаги, чтобы добавить активацию при нажатии.

1. Добавьте одно устройство активации при нажатии на уровень.

2. Выберите активацию при нажатии на панели Структура. На панели Сведения устройства в разделе Пользовательские настройки задайте следующие значения:

   

   Настройка	Значение	Пояснение
   Способ ввода	Стандартное действие	Срабатывание — это стандартное действие, которое должна прослушивать активация при нажатии, чтобы узнать, когда игрок взмахивает оружием.
   Стандартный ввод	выстрел;	Срабатывание — это действие, которое должна прослушивать активация при нажатии, чтобы узнать, когда игрок взмахивает оружием.
   Показывать в интерфейсе	Ложь	Это действие не нужно показывать в интерфейсе.

Область

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

1. Добавьте дверь где-нибудь на вашем уровне. Эту дверь игрок будет открывать с помощью оружия.

2. Добавьте одно устройство Область на уровень. Это устройство области должно перекрывать небольшую область перед дверью или область, которую игрок должен атаковать.

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

   

Запереть

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

1. Добавьте устройство Замок и закрепите его на двери.

2. Выберите замок на панели Структура. На панели Сведения, в разделе Пользовательские настройки, для параметра Отображать в игре установите значение false.

   

Указатель на карте

Когда место, куда игроку нужно добраться, находится далеко от места, где он взял оружие, игрокам полезно показать, куда нужно идти, с помощью указателя на карте. Соответствующее изображение отображается на их карте и мини-карте. При этом можно активировать пульсацию цели с указанием непосредственно на дверь. Чтобы добавить указатель на карте, выполните следующие действия.

1. Добавьте на уровень устройство Указатель на карте, спрятанное под дверью.

2. Выберите Указатель на карте на панели Структура. На панели Сведения, в разделе Пользовательские настройки:

   

   Настройка	Значение	Пояснение
   Включить в начале игры	ложь	Указатель на карте включается только после того, как игрок берёт оружие.
   Маленький значок	Выберите значок	Выберите значок, который хотите отобразить на мини-карте.
   Крупный значок	Выберите значок	Выберите значок, который хотите отобразить на карте.

Кнопка с условием для предмета

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

1. Добавьте на уровень одно устройство Кнопка с условием для предмета.

2. Выберите кнопку с условием для предмета на панели Структура. На панели Сведения устройства в разделе Пользовательские настройки задайте следующие значения:

   

   Настройка	Значение	Пояснение
   Удалять предметы-ключи	Ложь	Не нужно удалять оружие игрока после открытия двери.
   Определение предмета 1: «Предмет-ключ»	Оружие	Это оружие, с помощью которого игрок должен открыть дверь.

Вращающаяся камера

Чтобы симулировать вид от первого лица, вы можете использовать вращающуюся камеру, позволяющую изменить перспективу игрока. Выполните следующие шаги, чтобы добавить вращающуюся камеру.

1. Добавьте на уровень одно устройство Камера кругового вращения.

2. Выберите кнопку вращающейся камеры на панели Структура. На панели Сведения, в разделе Камера, задайте следующие значения:

   Настройка	Значение	Пояснение
   Расстояние	0,0 см	Параметры, необходимые для вида от первого лица
   Смещение X	27,0 см	Параметры, необходимые для вида от первого лица
   Смещение Y	0,0 см	Параметры, необходимые для вида от первого лица
   Смещение Z	76,0 см	Параметры, необходимые для вида от первого лица
   Горизонтальная скорость	0,0 см/с	Параметры, необходимые для вида от первого лица

3. На панели Сведения, в разделе Переход, задайте следующие значения:

   

   Настройка	Значение	Пояснение
   Время приближения	0,0 с	Параметры, необходимые для вида от первого лица
   Время отдаления	0,1 с	Параметры, необходимые для вида от первого лица
   Тип отдаления	Медленное отдаление	Параметры, необходимые для вида от первого лица

Внутриигровое видео

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

1. Добавьте на уровень устройство Последовательность внутриигрового видео.

2. В Каталоге ресурсов создайте последовательность внутриигрового видео, которую хотите использовать на уровне. В последовательности внутриигрового видео используется камера вращения, которую вы установили ранее. Она должна показывать открытие двери при переходе камеры от первоначального ракурса к виду от первого лица. Дополнительная информация о создании собственных последовательностей внутриигрового видео приведена в разделе «Создание видеороликов и заставок».

3. На панели Структура выберите последовательность внутриигрового видео. Затем на панели Сведения, в разделе Пользовательские настройки, присвойте для Последовательности вашу последовательность внутриигрового видео.

   

   Нажмите на изображение, чтобы увеличить его.

Внутриигровое видео открытия двери с использованием Verse

Для обработки логики воспроизведения видео и открытия двери будет использоваться устройство Verse. Это устройство прослушивает событие взмаха оружием внутри устройства области, затем воспроизводит последовательность внутриигрового видео, открывает дверь и переводит игрока в режим от первого лица.

Настройка полей

Чтобы создать устройство Verse:

1. Создайте новое устройство Verse с помощью проводника Verse и назовите его door_open_cinematic_manager.

2. Над определением класса door_open_cinematic_manager добавьте канал записи для вывода в журнал сообщений, относящихся к этому устройству. Затем добавьте диспетчер журналов в определение класса для использования с каналом записи в журнал.

   Verse

   door_open_channel := class(log_channel){}
   		
        # A Verse-authored creative device that can be placed in a level
        door_open_cinematic_manager := class(creative_device):
            Logger:log = log{Channel := door_open_channel}

   Copy full snippet(5 lines long)

3. Добавьте следующие поля в определение класса door_open_cinematic_manager:

   • Редактируемое устройство области под названием DoorVolume. Это область, внутри которой должен находиться игрок, чтобы открыть дверь.

     Verse

     # The volume the player needs to be inside of to open the door.
       @editable
       DoorVolume:volume_device = volume_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство активации при нажатии с названием FireTrigger. Оно прослушивает использование игроком своего оружия внутри DoorVolume.

     Verse

     # The input trigger that listens for the player swinging their weapon
       # when inside the DoorVolume.
       @editable
       FireTrigger:input_trigger_device = input_trigger_device{}

     Copy full snippet(4 lines long)

   • Редактируемое устройство «Кнопка с условием» с названием ConditionalButton. Оно проверяет, есть ли у игрока правильное оружие, когда он находится внутри устройства области.

     Verse

     # The Conditional Item Button that checks that the player has the correct weapon.
       @editable
       ConditionalButton:conditional_button_device = conditional_button_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство «Замок» с названием DoorLock. Оно позволит держать дверь запертой, если у игрока нет подходящего оружия.

     Verse

     # The lock device that prevents the door from being opened.
       @editable
       Door:lock_device = lock_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство «Последовательность внутриигрового видео» с названием CinematicSequence. Оно воспроизводит видео, ведущее к переходу камеры при открытии двери.

     Verse

     # The cinematic sequence device that plays the cinematic when opening the door.
       @editable
       CinematicSequence:cinematic_sequence_device = cinematic_sequence_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство «Указатель на карте» с названием ObjectiveMarker. Оно отображает расположение двери на мини-карте, когда игрок берёт в руки оружие.

     Verse

     # The map indicator device that shows the location of the door.
       @editable
       ObjectiveMarker:map_indicator_device = map_indicator_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство выдачи предметов с названием ItemGranter. Даёт игроку оружие, необходимое для продвижения.

     Verse

     # The item granter device that grants the player the weapon they need.
       @editable
       ItemGranter:item_granter_device = item_granter_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство «Кнопка» с названием ItemGrantButton. Активирует ItemGranter, чтобы выдать игроку необходимое оружие.

     Verse

     # The button that activates the ItemGranter granter.
       @editable
       ItemGrantButton:button_device = button_device{}

     Copy full snippet(3 lines long)

   • Редактируемое устройство «Вращающаяся камера» с названием FPSCamera. Симулирует вид от первого лица и добавляется к игроку после окончания видео.

     Verse

     # The orbit camera that simulates a first-person view.
       @editable
       FPSCamera:gameplay_camera_orbit_device = gameplay_camera_orbit_device{}

     Copy full snippet(3 lines long)

   • Переменная logic с названием IsDoorOpen. Это поле отслеживает, открыта ли дверь. Если открыта, последовательность не воспроизводится.

     Verse

     # A variable that tracks whether the door is already open.
       var IsDoorOpen:logic = false

     Copy full snippet(2 lines long)

   • Отменяемая переменная option с названием FireSubscription. Хранит подписку на PressedEvent для FireTrigger. Эта последовательность внутриигрового видео должна срабатывать только тогда, когда игрок находится рядом с дверью. Эта отменяемая подписка гарантирует отписку игрока от FireTrigger, если тот уйдёт слишком далеко.

     Verse

     # A cancelable subscription to the FireTrigger device.
       var FireSubscription:?cancelable = false

     Copy full snippet(2 lines long)

Воспроизведение внутриигрового видео

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

1. Добавьте новый метод PlayCinematic() к определению класса door_open_cinematic_manager. Добавьте новый метод PlayCinematic() к определению класса door_open_cinematic_manager. Эта функция действует на игроке, открывающем дверь. Затем она воспроизводит внутриигровое видео и открывает дверь с помощью устройства замка.

   Verse

   # Plays a cinematic and unlocks the door.
        PlayCinematic(Agent:agent):void=

   Copy full snippet(2 lines long)

2. В PlayCinematic() сначала воспроизводим внутриигровое видео из CinematicSequence, затем снимаем замок, после чего дверь открывается с помощью Unlock() и Open() соответственно.

   Verse

   # Plays a cinematic and unlocks the door.
        PlayCinematic(Agent:agent)<suspends>:void=
   		
            Logger.Print("Player is holding item, playing cinematic...")  
            CinematicSequence.Play()
   		
   		
            # Unlock the door, then open it.
            Door.Unlock(Agent)
            Door.Open(Agent)
   
   Expand code Copy full snippet(11 lines long)

3. Наконец, измените для игрока вид от третьего лица на вид от первого, добавив к нему камеру вращения с помощью AddTo(), затем отключите маркер цели. Готовая функция PlayCinematic() должна выглядеть следующим образом:

   Verse

   # Plays a cinematic and unlocks the door.
        PlayCinematic(Agent:agent)<suspends>:void=
   		
            Logger.Print("Player is holding item, playing cinematic...")  
            CinematicSequence.Play()
   		
            # Unlock the door, then open it.
            Door.Unlock(Agent)
            Door.Open(Agent)
            set IsDoorOpen = true
   
   Expand code Copy full snippet(18 lines long)

4. Внутриигровое видео должно воспроизводиться только тогда, когда игрок держит нужный предмет, и не должно воспроизводиться вновь, если дверь уже открыта. Чтобы обработать эту логику, добавьте новый метод CheckCinematic() к определению класса door_open_cinematic_manager. Эта функция принимает игрока в DoorVolume и проверяет, есть ли у него необходимые предметы.

   Verse

   # Check if the player has the required item and the door isn't already open.
        CheckCinematic(Agent:agent):void=

   Copy full snippet(2 lines long)

5. В CheckCinematic() проверьте, держит ли игрок предмет, зарегистрированный в ConditionalButton с помощью IsHoldingItem[]. Также проверьте, имеет ли IsDoorOpen значение false, чтобы убедиться, что дверь ещё не открыта. Если это так, используйте spawn{} для создания функции PlayCinematic(), передающей игрока, открывающего дверь. Готовая функция CheckCinematic() должна выглядеть следующим образом:

   Verse

   # Check if the player has the required item and the door isn't already open.
        CheckCinematic(Agent:agent):void=
            if:
                ConditionalButton.IsHoldingItem[Agent] and not IsDoorOpen?
            then:
                spawn{PlayCinematic(Agent)}

   Copy full snippet(6 lines long)

Отслеживание игрока и выдача предметов

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

1. Добавьте новый метод OnPlayerEntersVolume() к определению класса door_open_cinematic_manager. Эта функция принимает агента и регистрирует его с помощью FireTrigger, когда он входит в DoorVolume.

   Verse

   # Registers the Agent with the FireTrigger when they enter the DoorVolume.
        OnPlayerEntersVolume(Agent:agent):void=
            Logger.Print("Agent entered DoorVolume")

   Copy full snippet(3 lines long)

2. В OnPlayerEntersVolume() зарегистрируйте агента с FireTrigger, вызвав Register(). Затем установите для FireSubscription результат подписки FireTrigger.PressedEvent на PlayCinematic(). Готовая функция OnPlayerEntersVolume() должна выглядеть следующим образом:

   Verse

   # Registers the Agent with the FireTrigger when they enter the DoorVolume.
        OnPlayerEntersVolume(Agent:agent):void=
   		
            Logger.Print("Agent entered DoorVolume")
   		
            FireTrigger.Register(Agent)
   		
            # Subscribe the PressedEvent to PlayCinematic, and store that subscription in FireSubscrition.
            set FireSubscription = option{(FireTrigger.PressedEvent.Subscribe(PlayCinematic))}

   Copy full snippet(9 lines long)

3. Когда игрок выходит из DoorVolume, вам необходимо прекратить отслеживание подписки на FireTrigger.PressedEvent, поскольку игрок должен быть в состоянии активировать внутриигровое видео только в том случае, если он не находится внутри области. Чтобы обработать эту логику, добавьте новый метод OnPlayerExitsVolume() к определению класса door_open_cinematic_manager.

   Verse

   # Unregister the Agent with the FireTrigger when they leave the DoorVolume.
        OnPlayerExitsVolume(Agent:agent):void=

   Copy full snippet(2 lines long)

4. В OnPlayerExitsVolume() сначала отмените регистрацию агента с помощью Unregister() для FireTrigger. Затем получите подписку внутри FireSubscription и отмените её. Готовый метод OnPlayerExitsVolume() должен выглядеть следующим образом:

   Verse

   # Unregister the Agent with the FireTrigger when they leave the DoorVolume.
        OnPlayerExitsVolume(Agent:agent):void=
   		
            Logger.Print("Agent exited DoorVolume")
   		
            FireTrigger.Unregister(Agent)
   		
            # Cancel the subscription to the FireSubscription.
            if (SubscriptionToCancel := FireSubscription?):
                SubscriptionToCancel.Cancel()

   Copy full snippet(10 lines long)

5. Когда игрок взаимодействует с ItemButton, ему выдаётся оружие, необходимое для продвижения. На мини-карте также появляется маркер цели, который показывает путь к двери, если игрок ещё не нашёл её. Чтобы обработать эту логику, добавьте к определению класса door_open_cinematic_manager новый метод GrantItem(), который будет принимать агента. Внутри GrantItem() вызовите GrantItem для переданного агента и включите маркер цели. Готовый метод GrantItem() должен выглядеть следующим образом:

   Verse

   # Grants the Agent an item when they interact with the ItemGrantButton
        # and enables the ObjectiveMarker.
        GrantItem(Agent:agent):void=
            ItemGranter.GrantItem(Agent)
            ObjectiveMarker.Enable()

   Copy full snippet(5 lines long)

Связывание всех элементов

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

1. В OnBegin() подпишите событие ItemGrantButton.InteractedWithEvent на функцию GrantItem(). Затем подпишите DoorVolume.AgentEntersEvent и DoorVolume.AgentExitsEvent на связанные с ними функции. Ваша функция OnBegin() должна выглядеть следующим образом:

   Verse

   # Runs when the device is started in a running game
        OnBegin<override>()<suspends>:void=
   		
            # Subscribe each event to its associated function.
            ItemGrantButton.InteractedWithEvent.Subscribe(GrantItem)
            DoorVolume.AgentEntersEvent.Subscribe(OnPlayerEntersVolume)
            DoorVolume.AgentExitsEvent.Subscribe(OnPlayerExitsVolume)

   Copy full snippet(7 lines long)

2. Сохраните свой код и скомпилируйте его.

3. В UEFN выберите устройство DoorOpenCinematicManager на своём уровне. На панели Структура назначьте каждую редактируемую ссылку устройству на уровне.

   

   Нажмите на изображение, чтобы увеличить его.

4. Нажмите Запустить сеанс на панели инструментов UEFN, чтобы выполнить игровой тест уровня. При игровом тестировании уровня взаимодействие с кнопкой предмета должно предоставлять игроку необходимое оружие и добавлять маркер цели на его мини-карту. Когда игрок использует оружие внутри области двери, должно запуститься внутриигровое видео, дверь должна открыться, а игрок должен перейти в вид от первого лица.

Полный код

using { /Fortnite.com/Devices }
using { /Verse.org/Simulation }
using { /UnrealEngine.com/Temporary/Diagnostics }

# See https://dev.epicgames.com/documentation/en-us/uefn/create-your-own-device-in-verse for how to create a verse device.
door_open_log := class(log_channel){}

door_open_cinematic_manager := class(creative_device):

    Logger:log = log{Channel := door_open_log}

Самостоятельная работа

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

Используя полученные знания, попробуйте выполнить следующее:

• Можете ли вы выполнить другие типы перехода камеры, например переход к виду для сайд-скроллера?

• А как насчёт специальной кнопки для изменения угла камеры? Сможете разработать уровень, для прохождения которого потребуется несколько ракурсов камеры?

• Можете ли использовать активацию при нажатии для отрицательных штрафов, например, предлагая игрокам пройти через какой-либо участок без прыжков, и воспроизводить видео, если им не будет удаваться это сделать?