Шаблон для клуба стендап-комиков

Этот урок дополняет Шаблон для стендап-шоу на Verse, в котором демонстрируется, как использовать устройства, поддерживающие социальное взаимодействие и кинематографичность во время представления в комедийном клубе:

• Использование детализированных ресурсов аниматора персонажей MetaHuman с Устройствами персонажей

• Запуск событий игрового процесса по привязкам ввода от игрока с помощью Устройств «Активация при нажатии»

• Фиксирование положения игрока в одном месте для просмотра с помощью Устройства «Стул»

Устройство Verse используется для запуска шоу: основные концепции и код Verse представлены ниже.

Шаблон «Комедия» на Verse находится в разделе Демонстрация возможностей в UEFN (Unreal Editor для Fortnite).

Используемые устройства:

• 1 устройство «Стул»

• 4 устройства «Активация при нажатии»

• 4 персонажа

• 6 последовательностей внутриигрового видео

Концепции Verse, используемые в этом уроке:

• Подписки

• Условный оператор If

• Массивы

• Последовательности внутриигрового видео

• API устройства «Стул»

• API устройства «Активация при нажатии»

Параметры острова

Здесь представлены изменённые настройки острова для шаблона стендап-шоу на Verse:

Стул

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

Здесь находятся изменённые Пользовательские настройки устройства «Стул»:

Устройства «Активация при нажатии»

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

В устройстве предусмотрено двенадцать вариантов ввода. Выбрав один из вариантов, вы можете добавить описание HUD-интерфейса, чтобы было понятно, для чего используется ввод.

Ниже вы найдёте Пользовательские настройки для этого устройства. Каждое из устройств получит свою привязку и описание HUD-интерфейса, так как они связаны со своими отдельными устройствами «Последовательность внутриигрового видео».

Устройства «Персонаж»

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

Здесь находятся изменённые Пользовательские настройки устройства «Персонаж»:

Главный персонаж сидит на ступеньках за кулисами, а остальные персонажи ожидают в небольшой комнате сзади.

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

Устройства «Последовательность внутриигрового видео»

Шесть устройств «Внутриигровое видео» позволяют игроку смотреть шоу под разными углами, сидя на устройстве «Стул».

Процесс создания последовательностей внутриигрового видео на этой странице подробно не рассматривается. Дополнительная информация приведена на странице Sequencer и Регулятор каркаса. Более подробно об этом можно узнать в разделе Как создавать фильмы в Unreal Engine.

Это устройство изменяется только за счёт загрузки последовательности внутриигрового видео.

Как шоу работает на Verse

Этот шаблон использует Verse для запуска шоу в момент, когда игрок садится на устройство «Стул», а также для переключения его камеры на кинематографический просмотр, который называется ТВ-режим. Кроме того, он позволяет игроку для разнообразия переключаться между несколькими камерами и возвращаться в ТВ-режим или Свободный обзор.

Создайте новое устройство Verse в своём проекте и назовите его show_template_device.verse с помощью проводника Verse, после чего перетащите устройство в шаблон. Дважды нажмите на файл Verse, чтобы открыть его в Visual Studio Code.

В шаблоне вы создали устройства, которые позволяют воспроизводить стендап-шоу. Теперь давайте добавим ссылки на них в вашем коде.

Добавьте следующие поля в файл show_template_device:

1. Для начала перед определением класса show_template_device добавьте log_channel с названием log_show_template_device.

   Verse

        # Create a custom log channel for the show_template_device. This helps with log filtering in complex games with lots of log sources.
        log_show_template_device := class(log_channel){}
   		
        # A Verse-authored creative device that can be placed in a level
        show_template_device := class(creative_device):
   

   Copy full snippet(5 lines long)

2. Теперь в верхней части определения класса show_template_device добавьте регистратор журналов, который будет использовать канал log_show_template_device, чтобы было понятно, какие команды Print() поступают от этого устройства.

   Verse

        # A Verse-authored creative device that can be placed in a level
        show_template_device := class(creative_device):
   		
            # Logger that uses custom log channel.
            Logger:log = log{Channel := log_show_template_device}
   

   Copy full snippet(5 lines long)

3. Редактируемое устройство «Стул» с названием TheChair. Именно на этот стул игроки садятся, чтобы началось стендап-шоу.

   Verse

        # The chair device the player should sit in.
        @editable
        TheChair:chair_device = chair_device{}
   

   Copy full snippet(3 lines long)

4. Два редактируемых устройства «Последовательность внутриигрового видео» с названиями MainSequence и TVModeSequence. MainSequence — это последовательность внутриигрового видео, которая воспроизводит стендап-шоу, подключает анимацию и звуковое сопровождение для устройства персонажа на этом уровне. TVModeSequence переключает камеру игрока на режим просмотра, в котором удерживается внимание на MainSequence, с переключением от одного угла просмотра к другому.

   Verse

        # The sequence that drives animation and audio on the character device in the level.
        @editable
        MainSequence:cinematic_sequence_device = cinematic_sequence_device{}
        # The sequence that drives the TV mode sequence for viewing in the level.
        @editable
        TVModeSequence:cinematic_sequence_device = cinematic_sequence_device{}
   

   Copy full snippet(6 lines long)

5. Редактируемый массив элементов cinematic_sequence_device с названиями CameraSwitches. Этот массив содержит ссылки на каждую из камер, между которыми игроки могут переключаться.

   Verse

        # A list of alternative camera sequences that are provided to view from during the main sequence.
        @editable
        CameraSwitches:[]cinematic_sequence_device = array{}
   

   Copy full snippet(3 lines long)

6. Четыре редактируемых устройства input_trigger_device. Каждое из этих устройств принимает ввод от игрока и переключается между различными режимами камеры. Триггер ReturnToFreeLook возвращает игрока к камере по умолчанию, а ReturnToTVMode — к TVModeSequence. Камера NextCamera и PreviousMode переключает игрока между различными последовательностями внутриигрового видео в массиве CameraSwitches.

   Verse

        # An input trigger that will return us to free look while in the chair.
        @editable
        ReturnToFreeLook:input_trigger_device = input_trigger_device{}
   		
        # An input trigger that will return us to TV mode when appropriate in the chair.
        @editable
        ReturnToTVMode:input_trigger_device = input_trigger_device{}
   		
        # An input trigger that will choose the next camera while in the chair.
        @editable
   
   Expand code Copy full snippet(15 lines long)

7. Необязательная переменная устройства «Последовательность внутриигрового видео» с названием CurrentSequence. При воспроизведении такой последовательности внутриигрового видео, как TVModeSequence, эта настройка сохраняет ссылку на неё. Мы не будем воспроизводить для персонажа сразу несколько последовательностей внутриигрового видео, поэтому эту настройку можно использовать для выключения текущей последовательности при переключении на новую.

   Verse

        # The alternative camera sequence that is playing if valid.
        var CurrentSequence:?cinematic_sequence_device = false
   

   Copy full snippet(2 lines long)

8. Две логические переменные: MainSequencePlaying и InTvMode. Они позволяют отслеживать момент воспроизведения MainSequence или TVModeSequence.

   Verse

        # Helps us track when the main sequence on the character device is playing.
        var MainSequencePlaying:logic = false
   		
        # When we are in TV mode.
        var InTVMode:logic = false
   

   Copy full snippet(5 lines long)

9. Целочисленная переменная CurrentCameraIndex. Позволяет отслеживать индекс последовательности внутриигрового видео в массиве CameraSwitches, которая в данный момент воспроизводится.

   Verse

        # Keeps track of what camera we are viewing when using other cameras besides TV Mode.
        var CurrentCameraIndex:int = -1
   

   Copy full snippet(2 lines long)

10. Пять необязательных отменяемых переменных, позволяющих отслеживать подписки на все события, на которые ссылается этот шаблон. Различные функции, которые требуется запускать, когда игрок переключается между камерами, возвращается к свободному обзору или ТВ-режиму, либо покидает устройство «Стул». Далее мы подпишем эти функции на события, которые их запускают, и сохраним ссылку на каждую из подписок, чтобы их можно было отменить, когда они больше не будут нужны.

    Verse

         # Subscriptions to all the events we listen for while running.
         var ReturnToFreeLookSubscription:?cancelable = false
         var NextCameraSubscription:?cancelable = false
         var PrevCameraSubscription:?cancelable = false
         var ReturnToTVModeSubscription:?cancelable = false
         var ChairExitSubscription:?cancelable = false
    

    Copy full snippet(6 lines long)

11. Сохраните сценарий в Visual Studio Code и скомпилируйте его, чтобы обновить Verse-устройство на уровне.

12. В шаблоне выберите show_template_device. На панели Сведения присвойте ссылку каждого устройства в сценарии соответствующему устройству на уровне, включая все устройства «Активация при нажатии» и последовательности внутриигрового видео.

    

Запуск последовательности

Шоу запускается в момент, когда игрок садится на устройство «Стул». Требуется, чтобы последовательность внутриигрового видео начала воспроизводиться после того, как игрок сядет на стул. Выполните действия ниже для запуска основной последовательности после того, как игрок сядет на стул, а также для включения ТВ-режима, чтобы игрок мог начать просмотр.

1. Добавьте новую функцию RunSequence() в класс show_template_device. Эта функция принимает агента, который запустил шоу, и запускает как MainSequence, так и TVModeSequence. Добавьте модификатор к функции RunSequence(), чтобы она выполнялась асинхронно. Требуется это для того, чтобы параллельно с ней выполнялся другой код, а сам игрок мог переключать ракурсы камер без прерывания выполнения RunSequence().

   Verse

        # Handles running the main sequence which runs the character and TV mode sequences for viewing and then calls a function to await finishing.
        RunSequence(Agent:agent)<suspends>:void =

   Copy full snippet(2 lines long)

2. В RunSequence() на одну секунду вызовите функцию Sleep(), чтобы анимация сидящего на стуле игрока завершилась до начала шоу. Затем вызовите Play() в MainSequence и установите для MainSequencePlaying значение true.

   Verse

        # Sleep for a second because we just entered the chair and the animation to sit takes a moment.
        Sleep(1.0)
   		
        # Run the Main sequence on the character device and the TV mode viewing sequence.
        Logger.Print("Main Sequence Playing")
        set MainSequencePlaying = true
        MainSequence.Play()
   

   Copy full snippet(7 lines long)

3. Вызовите функцию Play() для TVModeSequence, передав запустившего шоу агента для смены камеры на кинематографический вид. Установите для InTVMode значение true и вызовите новую функцию, ожидающую окончания MainSequence, под названием AwaitMainSequenceEnding(), передав в неё агента. Эту функцию вы настроите на следующем шаге. Готовый код RunSequence() должен выглядеть следующим образом:

   Verse

        # Handles running the main sequence which runs the character and TV mode sequences for viewing and then calls a function to await finishing.
        RunSequence(Agent:agent)<suspends>:void =
   
            # Sleep for a second because we just entered the chair and the animation to sit takes a moment.
            Sleep(1.0)
   
            # Run the Main sequence on the character device and the TV mode viewing sequence.
            Logger.Print("Main Sequence Playing")
            set MainSequencePlaying = true
            MainSequence.Play()
   
   Expand code Copy full snippet(16 lines long)

4. Добавьте новую функцию AwaitMainSequecingEnding() в класс show_template_device, которая будет принимать агент из RunSequence(). Этой функции также нужен модификатор <suspends>, так как она должна выполняться в фоновом режиме и срабатывать при завершении MainSequence.

   Verse

        # When the main sequence finishes, we clear the flag so that if the player sits back down, it will play again.
        AwaitMainSequencingEnding(Agent:agent)<suspends>:void =

   Copy full snippet(2 lines long)

5. В AwaitMainSequencingEnding() вызовите Await() для MainSequence.StoppedEvent(). При завершении MainSequence установите для MainSequencePlaying значение false и заставьте игрока встать со стула, используя функцию стула Eject(). В конечном итоге функция AwaitMainSequencingEnding() должна выглядеть следующим образом:

   Verse

        # When the main sequence finishes, we clear the flag so that if the player sits back down, it will play again.
        AwaitMainSequencingEnding(Agent:agent)<suspends>:void =
            MainSequence.StoppedEvent.Await()
            Logger.Print("Main Sequence Ended")
            set MainSequencePlaying = false
   
            # Kick the player out of the chair after the performance
            TheChair.Eject(Agent)

   Copy full snippet(8 lines long)

6. Добавьте две новые функции DoReturnToTVMode() и DoReturnToFreeLook() в класс show_template_device. Эти функции обрабатывают логику событий, когда игрок возвращается в ТВ-режим или к свободному обзору, но пока их нужно оставить пустыми: мы завершим их чуть позже.

   Verse

        # Returns us to our TV viewing mode sequence by checking where the main sequence is and aligning our playback to that point.
        DoReturnToTVMode(Agent:agent):void =
            Logger.Print("Return to TV Mode")
   		
        # Determine if we are in TV mode or another camera sequence and return control to the main player camera.
        DoReturnToFreeLook(Agent: agent):void =
            Logger.Print("Return to Free Look")
   

   Copy full snippet(7 lines long)

7. Добавьте новую функцию OnSeated() в класс show_template_device, которая будет принимать агента, который сидел на TheChair.

   Verse

        # This function handles the player sitting down and starting up the performance if it isn't already running and setting up the input triggers.
        OnSeated(Agent:agent):void =
            Logger.Print("Player sat down")
   

   Copy full snippet(3 lines long)

8. В OnSeated(), если MainSequence ещё не воспроизводится, создайте функцию RunSequence(), передав в неё агента, который сел на устройство «Стул». В противном случае вызовите DoReturnToTVMode() с тем же агентом.

   Verse

        # This function handles the player sitting down and starting up the performance if it isn't already running and setting up the input triggers.
        OnSeated(Agent:agent):void =
            Logger.Print("Player sat down")
   		
            # If the main sequence is not playing on the character device in the level, run it, otherwise if it is running then just return to the TV mode viewing experience.
            if (MainSequencePlaying = false):
                spawn{RunSequence(Agent)}
            else:
                DoReturnToTVMode(Agent)
   

   Copy full snippet(9 lines long)

9. Добавьте новую функцию OnChairExited() в класс show_template_device, которая будет принимать игрока, вставшего со стула. Логику для этой функции мы добавим позднее.

   Verse

        # Handles the player leaving the chair and removing access to the input triggers that are available while in the chair.
        OnChairExited(Agent:agent):void =
            Logger.Print("Player got up")
   

   Copy full snippet(3 lines long)

10. В OnBegin() подпишите TheChair.SeatedEvent на функцию OnSeated(). Теперь, когда игрок сядет на TheChair, начнётся воспроизведение шоу.

    Verse

         # Runs when the device is started in a running game.
         OnBegin<override>()<suspends>:void =
             Logger.Print("Standup Template device started")
             TheChair.SeatedEvent.Subscribe(OnSeated)

    Copy full snippet(4 lines long)

Сохраните код в Visual Studio Code, скомпилируйте его и нажмите Запуск сеанса на панели инструментов UEFN, чтобы протестировать шаблон. Если во время игры сесть на устройство «Стул», должно начаться шоу, а камера игрока переведётся на кинематографический режим. При завершении шоу игрок должен встать со стула.

Переключение камер

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

1. Добавьте новую функцию DoCameraSwitch() в класс show_template_device. Эта функция принимает агента, камеру которого вы переключаете, и значение int, соответствующее индексу последовательности внутриигрового видео в CameraSwitches.

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
   

   Copy full snippet(2 lines long)

2. В DoCameraSwitch(), в блоке if, получите последовательность внутриигрового видео по индексу Value в массиве CameraSwitches. Затем остановите любые воспроизводимые в данный момент последовательности, проверив, содержит ли CurrentSequence последовательность внутриигрового видео, и вызвав для неё Stop().

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
            if (CameraSwitch := CameraSwitches[Value]):
                Logger.Print("Switching Cameras to {Value}")
   		
                # Stop any currently playing other camera sequence.
                if (PlayingSequence := CurrentSequence?):
                    PlayingSequence.Stop(Agent)
   

   Copy full snippet(8 lines long)

3. Запустите воспроизведение новой последовательности внутриигрового видео, вызвав Play() для CameraSwitch. Затем настройте CurrentSequence так, чтобы она указывала, какая последовательность воспроизводится в данный момент. Наконец, зарегистрируйте agent при помощи Register(), камеру которого вы переключаете с помощью устройств «Активация при нажатии» ReturnToTVMode и ReturnToFreeLook, чтобы они могли вернуться в эти режимы при просмотре через другие камеры. В конечном итоге функция DoCameraSwitch() должна выглядеть следующим образом:

   Verse

        # Switches us between camera sequences that have been specified by stopping any current ones and moving to the next appropriate one on the list.
        DoCameraSwitch(Agent:agent, Value:int):void =
            if (CameraSwitch := CameraSwitches[Value]):
                Logger.Print("Switching Cameras to {Value}")
   		
                # Stop any currently playing other camera sequence.
                if (PlayingSequence := CurrentSequence?):
                    PlayingSequence.Stop(Agent)
   		
                # Start up the new camera viewing sequence.
   
   Expand code Copy full snippet(16 lines long)

4. Для перехода к следующей или предыдущей камере зададим две похожие функции — DoNextCamera() и DoPreviousCamera(). Сначала добавим логику для следующей камеры, для чего в класс show_template_device мы добавим новую функцию DoNextCamera(). Эта функция принимает агента (agent), камеру которого вы переключаете.

   Verse

        # Switches to the next camera on our list, or the first if we are in TV mode.
        DoNextCamera(Agent:agent):void =
            Logger.Print("Next Camera")
   

   Copy full snippet(3 lines long)

5. В DoNextCamera() проверьте, находится ли игрок в данный момент в ТВ-режиме. Если да, остановите TVModeSequence при помощи `Stop(), для InTVMode установите значение false, а для CurrentCameraIndex — значение –1. Значение –1 используется по той причине, что требуется перейти к индексу следующей последовательности внутриигрового видео в массиве CameraSwitches, чей индекс будет равен 0.

   Verse

        # If we are currently viewing from TV Mode, end that sequence and clear associated values.
        if (InTVMode?):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
            set CurrentCameraIndex = -1
   

   Copy full snippet(5 lines long)

6. Затем нужно определить, на какую камеру переключиться далее с учётом индекса текущей камеры. Для этого новой переменной NextCameraValue присвойте значение остатка от деления (Mod) CurrentCameraIndex + 1 на CameraSwitches.Length. Благодаря этому NextCameraValue будет присваиваться значение в пределах от 0 до длины CameraSwitches без возможности случайно получить для NextCameraValue значение за пределами массива CameraSwitches. Получив значение NextCameraValue, задайте для CurrentCameraValue значение NextCameraValue и вызовите DoCameraSwitch(), передав агента (agent) и CurrentCameraIndex. В конечном итоге функция DoNextCamera() должна выглядеть следующим образом:

   Verse

        # Switches to the next camera on our list, or the first if we are in TV mode.
        DoNextCamera(Agent:agent):void =
            Logger.Print("Next Camera")
   		
            # If we are currently viewing from TV Mode, end that sequence and clear associated values.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
                set CurrentCameraIndex = -1
   		
   
   Expand code Copy full snippet(14 lines long)

7. Для переключения на предыдущую камеру в класс show_template_device добавьте новую функцию DoPreviousCamera(). Скопируйте в эту функцию код из DoNextCamera(). При проверке, находится ли игрок в ТВ-режиме, установите для CurrentCameraIndex значение 0 вместо –1. Кроме того, измените значение NextCameraValue на остаток от деления (Mod) CurrentCameraIndex – 1 на CameraSwitches.Length. В конечном итоге функция DoPreviousCamera() должна выглядеть следующим образом:

   Verse

        # Switches us to the previous camera on the list or last camera if we are leaving TV mode.
        DoPreviousCamera(Agent:agent):void =
            Logger.Print("Prev Camera")
   		
            # If we are currently viewing from TV Mode, end that sequence and clear associated values.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
                set CurrentCameraIndex = 0
   		
   
   Expand code Copy full snippet(14 lines long)

Когда игрок сидит на стуле (TheChair) и смотрит через другую камеру в CameraSwitches, он может вернуться либо в ТВ-режим, либо к свободному обзору. Вы уже задали функции DoReturnToFreeLook() и DoReturnToTVMode() ранее, так что теперь пора заполнить их логику.

1. В функции DoReturnToFreeLook() проверьте, находится ли игрок в данный момент в ТВ-режиме. Если да, остановите TVModeSequence при помощи Stop() и для InTVMode установите значение false. Проделайте то же самое для CurrentSequence, проверив, содержит ли CurrentSequence последовательность внутриигрового видео, вызвав Stop() и, если это так, установив для него значение false.

   Verse

        # If TV Mode is active, stop it.
        if (InTVMode?):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
   		
        # If we are playing another viewing experience, stop it.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
            set CurrentSequence = false
   

   Copy full snippet(9 lines long)

2. Теперь выполняем Register() для агента с триггером активации при нажатии ReturnToTVMode и Unregister() с триггером ReturnToFreeLook, так как не требуется, чтобы игрок вернулся в режим свободного обзора, если этот режим уже включён. В конечном итоге функция DoReturnToFreeLook() должна выглядеть следующим образом:

   Verse

        # Determine if we are in TV mode or another camera sequence and return control to the main player camera.
        DoReturnToFreeLook(Agent: agent):void =
            Logger.Print("Return to Free Look")
   		
            # If TV Mode is active, stop it.
            if (InTVMode?):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
   		
            # If we are playing another viewing experience, stop it.
   
   Expand code Copy full snippet(17 lines long)

3. Функцию DoReturnToTVMode() нужно дополнить, поскольку при возврате в ТВ-режим нужно запустить TVModeSequence с текущего момента MainSequence. Сначала проверьте, находится ли игрок уже в ТВ-режиме при вызове этой функции. Если да, достаточно использовать return, так как более ничего делать не нужно. Затем проверьте содержит ли CurrentSequence последовательность внутриигрового видео, вызвав Stop() и, если это так, задайте для него значение false.

   Verse

        # If we are already in TV mode no need to return to it.
        if (InTVMode?):
            return
   		
        # If we have another camera sequence playing, stop it and clear associated values.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
            set CurrentSequence = false
   

   Copy full snippet(8 lines long)

4. Теперь нужно определить, в каком месте воспроизведения находится MainSequence, чтобы запустить TVModeSequence с того же места. Получите время воспроизведения MainSequence, вызвав GetPlayBackTime(), и сохраните его в переменной CurrentSeekTime. Для TVModeSequence установите время воспроизведения на CurrentSeekTime с помощью SetPlaybackTime(), после чего запустите воспроизведения последовательности с помощью Play(), передав в неё агента. Затем установите для InTVMode значение true.

   Verse

        # Figure out where the main sequence is in its playback and start up the TV mode sequence at the same spot to provide the proper viewing experience.
        CurrentSeekTime := MainSequence.GetPlaybackTime()
        TVModeSequence.SetPlaybackTime(CurrentSeekTime)
        TVModeSequence.Play(Agent)
        set InTVMode = true
   

   Copy full snippet(5 lines long)

5. Наконец, выполните отмену регистрации агента для триггера активации при нажатии ReturnToTVMode при помощи Unregister() и зарегистрируйте его с триггером ReturnToFreeLook при помощи Register(). В конечном итоге функция DoReturnToTVMode() должна выглядеть следующим образом:

   Verse

        # Returns us to our TV viewing mode sequence by checking where the main sequence is and aligning our playback to that point.
        DoReturnToTVMode(Agent:agent):void =
            Logger.Print("Return to TV Mode")
   		
            # If we are already in TV mode no need to return to it.
            if (InTVMode?):
                return
   		
            # If we have another camera sequence playing, stop it and clear associated values.
            if (TempSeq := CurrentSequence?):
   
   Expand code Copy full snippet(22 lines long)

Объединение системы воедино

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

1. В OnSeated() зарегистрируйте агента в триггерах активации при нажатии ReturnToFreeLook, NextCamera и PreviousCamera при помощи Register(): это те самые триггеры, к которым сначала будет обращаться игрок, когда первый раз сядет на стул. Затем настройте ReturnToFreeLookSubscription, NextCameraSubscription и PreviousCameraSubscription, подписав каждый триггер на связанную с ним функцию. Аналогично настройте ReturnToTVModeSubscription и ChairExitSubscription.

   Verse

        # Register for the input trigger for free look and subscribe to the pressed event when sitting.
        ReturnToFreeLook.Register(Agent)
        set ReturnToFreeLookSubscription = option{ReturnToFreeLook.PressedEvent.Subscribe(DoReturnToFreeLook)}
   		
        # Register for the input trigger for the next camera and subscribe to the pressed event when sitting.
        NextCamera.Register(Agent)
        set NextCameraSubscription = option{NextCamera.PressedEvent.Subscribe(DoNextCamera)}
   		
        # Register for the input trigger for the previous camera and subscribe to the pressed event when sitting.
        PreviousCamera.Register(Agent)
   
   Expand code Copy full snippet(17 lines long)

2. Добавьте новую функцию CancelSubscription(), которая принимает необязательное отменяемое значение, в класс show_template_device. В CancelSubscription() проверьте, есть ли в Subscription какое-нибудь значение. Если да, то отмените его при помощи Cancel(). В конечном итоге функция CancelSubscription() должна выглядеть следующим образом:

   Verse

        # Cancel a subscription if it is valid.
        CancelSubscription(Subscription:?cancelable):void =
            if (SubscriptionToCancel := Subscription?):
                SubscriptionToCancel.Cancel()
   

   Copy full snippet(4 lines long)

3. В момент, когда игрок встаёт со стула, нужно остановить любые воспроизводимые для него последовательности, а также отменить все подписки на триггеры активации при нажатии, для которых он был зарегистрирован. В функции OnChairExited(), как и в случае с DoReturnToFreeLook(), проверьте, включён ли для игрока ТВ-режим, а также содержит ли CurrentSequence последовательность внутриигрового видео. Если это так, вызовите Stop() для каждой последовательности и задайте для InTVMode значение false, если для игрока включён ТВ-режим. Затем задайте для CurrentSequence значение false.

   Verse

        # Stop the TV camera view when we leave the chair if it is active.
        if (InTVMode = true):
            TVModeSequence.Stop(Agent)
            set InTVMode = false
   		
        # Stop the camera sequence we were using if it is active when we leave the chair.
        if (TempSeq := CurrentSequence?):
            TempSeq.Stop(Agent)
   		
        # Clear whatever the current sequence was when we leave the chair.
   
   Expand code Copy full snippet(11 lines long)

4. Теперь отмените все подписки игрока, передав каждую из них функции CancelSubscription(). Кроме того, при помощи Unregister() отмените регистрацию для игрока в каждом триггере активации при нажатии, поскольку такие триггеры не должны получать доступ к тем кнопкам, когда игрок встаёт со стула. В конечном итоге функция OnChairExited() должна выглядеть следующим образом:

   Verse

        # Handles the player leaving the chair and removing access to the input triggers that are available while in the chair.
        OnChairExited(Agent:agent):void =
            Logger.Print("Player got up")
   		
            # Stop the TV camera view when we leave the chair if it is active.
            if (InTVMode = true):
                TVModeSequence.Stop(Agent)
                set InTVMode = false
   		
            # Stop the camera sequence we were using if it is active when we leave the chair.
   
   Expand code Copy full snippet(28 lines long)

Сохраните код в Visual Studio Code, скомпилируйте его и нажмите Запуск сеанса на панели инструментов UEFN, чтобы протестировать шаблон. Во время игрового теста, если сесть на устройство «Стул», должно начаться шоу. Во время шоу должна быть возможность переключаться между ТВ-режимом, свободным обзором и просмотром под разными углами через камеры. При возврате в ТВ-режим последовательность ТВ-режима должна совпадать с основной последовательностью. Когда шоу завершится, камера должна вернуться в режим свободного обзора, и вы встанете со стула.