Добавление NPC в диалог

Требования

• Создайте персону

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

• Определить в Verse новое npc_behavior.

• Добавить npc_behavior в определение персонажа NPC.

• Добавить определение персонажа NPC в генератор NPC.

• Убедиться, что голосовой чат включён, поскольку он необходим для диалога с NPC, обладающими персоной.

Создание пустого поведения NPC

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

1. В строке меню выберите Verse > Проводник Verse.

2. В проводнике Verse нажмите правой кнопкой мыши по названию вашего проекта и выберите Добавить новый файл Verse в проект, чтобы открыть окно Создание скрипта Verse.

3. В окне Создание скрипта Verse выберите шаблон Базовое поведение NPC.

4. В разделе Настройка назовите поведение NPC persona_npc_behavior.

5. Нажмите Создать, чтобы создать файл Verse.

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

Поведение NPC определяется в Verse посредством наследования от базового класса npc_behavior. Подробнее о поведении NPC см. на странице Общие сведения о поведении NPC.

Изменение поведения NPC с персоной

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

В следующих разделах скрипт Verse определяет persona_npc_behavior. Чтобы добавить этот код Verse в пустой файл persona_npc_behavior, выполните следующие действия:

• В строке меню выберите Verse > Открыть проект в VS Code…

• Когда откроется VS Code, найдите файл persona_npc_behavior.verse в Проводнике VS Code.

• Скопируйте приведённое ниже содержимое файла persona_npc_behavior.verse и вставьте его в файл Verse своего проекта.

• Скомпилируйте код Verse на панели инструментов UEFN или в VS Code.

С помощью Verse также можно создавать проекты, в которых команда игроков взаимодействует с агентами БЯМ. Verse обрабатывает взаимодействие нескольких игроков с агентами БЯМ с помощью функций CreateAudioTeamAndAddPlayers(), AddMember() и AddChatChannel().  

Пошаговый разбор скрипта Verse приведён в разделе Объяснение скрипта.

 persona_npc_behavior.verse

using { /Fortnite.com/AI }
using { /Fortnite.com/Devices }
using { /Fortnite.com/Playspaces }

using { /UnrealEngine.com/Conversations }
using { /UnrealEngine.com/Temporary/Diagnostics }

using { /Verse.org/Chat }
using { /Verse.org/SceneGraph }
using { /Verse.org/Simulation }

Объяснение скрипта

1. TeamName — это название создаваемого голосового канала. Переменная OptionAgentGroup содержит группу агентов, добавляемых в голосовой канал (TeamName). Переменная OptionVoiceChannel содержит сам голосовой канал, к которому подключены игроки и NPC.   

   Verse

       #Team name for the Team Voice Channel we are creating.
       TeamName<localizes>:message = "Persona Chat"
   
   
       #Variable that stores the agent group we are using to create the voice channel. We can use this group to create new channels or get current players in a conversation.
       var OptionAgentGroup:?agent_group(team_member_info) = false
   
   
       #Variable that stores the Voice Channel that our players and NPC will be inside of. This is what actually holds the conversation.
       var OptionVoiceChannel:?voice_channel(team_member_info) = false

   Copy full snippet(10 lines long)

2. AddPlayersAsConversationTarget создаёт голосовой диалог в реальном времени между NPC и всеми игроками в его игровом пространстве. Сначала функция собирает все необходимые данные. Только если это удаётся, она создаёт группу агентов и голосовой канал, подключает к ним игроков и NPC, а затем регистрирует игроков в качестве целей диалога.  

   Сначала создаётся новая agent_group с типом team_member_info, которая содержит всех участников диалога. Затем создаётся voice_channel, также с типом team_member_info. Ему присваивается имя TeamName, а его параметру Group — только что созданная группа агентов. По этому каналу передаётся звук диалога.

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

   После этого вызывается SimEntity.AddChatChannel(TeamVoiceChannel), чтобы зарегистрировать голосовой канал в системе звукового чата и перевести его в активное состояние. Наконец, функция снова перебирает игроков и для каждого вызывает SetConversationTarget, чтобы через этот канал назначить persona_component NPC целью диалога.

   На последнем этапе группа и канал сохраняются в переменных OptionAgentGroup и OptionVoiceChannel, обёрнутых в option{}, чтобы вспомогательные функции могли в дальнейшем обращаться к диалогу или изменять его без повторного создания.

   Verse

   
      # Add the Player as a conversation target for this NPC
       AddPlayersAsConversationTarget():void=
           if:
               NPCEntity := GetEntity[]
               Playspace := NPCEntity.GetPlayspaceForEntity[]
               NPCAgent := GetAgent[]
               Players := NPCEntity.GetPlayspaceForEntity[].GetPlayers()
               SimEntity := Players[0].GetSimulationEntity[]
               PersonaComponent := NPCEntity.GetComponent[persona_component]
   
   Expand code Copy full snippet(34 lines long)

3. RemovePlayerAsConversationTarget удаляет одного игрока из диалога с NPC. Функция принимает один аргумент типа player и вызывает ClearConversationTarget(), отсоединяя игрока от назначенной ему цели диалога. Это действие, обратное вызову SetConversationTarget в функции AddPlayersAsConversationTarget.  

   Verse

       # Remove Player as a conversation target
       RemovePlayerAsConversationTarget(Player:player):void=
           Player.ClearConversationTarget()
           Logger.Print("Removed from NPC conversation", ?Level := log_level.Debug)

   Copy full snippet(4 lines long)

4. OnBegin добавляет структурированный вывод в сеанс и назначает игроку цель диалога. Если игроки могут присоединяться к игре после её начала, добавляйте их при возникновении PlayerAddedEvent или когда игрок подходит к NPC и активирует триггер.    

   Verse

       OnBegin<override>()<suspends>:void=
           AddPlayersAsConversationTarget()

   Copy full snippet(2 lines long)

5. В OnEnd Conversation очищается и удаляется у всех игроков. Это рекомендуемый подход.  

   Verse

       OnEnd<override>():void=
           for (Player : GetEntity[].GetPlayspaceForEntity[].GetPlayers()):
               RemovePlayerAsConversationTarget(Player)

   Copy full snippet(3 lines long)

Добавление поведения NPC в определение неигрового персонажа

Чтобы добавить persona_npc_behavior в определение неигрового персонажа, выполните следующие действия:

1. Перейдите к PersonaNPCDefinition на панели ресурсов.

   

2. Выберите PersonaNPCDefinition, чтобы открыть его для редактирования.

3. В разделе Поведение неигрового персонажа выберите Поведение Verse > persona_npc_behavior.

   

4. Перед закрытием вкладки обязательно сохраните изменения в определении неигрового персонажа.

Когда определение неигрового персонажа будет добавлено в генератор неигровых персонажей, персона этого NPC автоматически станет доступна игроку для диалога.

Добавление генератора неигровых персонажей с определением персонажа NPC

Чтобы создать NPC с настроенной персоной, добавьте на уровень генератор неигровых персонажей и PersonaNPCDefinition. Чтобы добавить устройство «Генератор неигровых персонажей», перетащите PersonaNPCDefinition из Панели ресурсов в окно просмотра.

Диалог с NPC

Чтобы поговорить с NPC, запустите сеанс и начните игру. Нажмите указанную на экране клавишу или кнопку устройства ввода и поговорите с NPC!

Далее

• 

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

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