Bir Konuşmaya NPC Ekle

Ön Gereksinimler

• Bir persona oluştur

Artık ilk personanı oluşturup İstem Editör’ünde onunla etkileşim kurarak onun kişiliğinde gereken ayarlamaları yaptığına göre NPC’ni bir konuşmaya ekleyebilirsin. Oyun içinde bir NPC ile konuşmak için şunları yapmalısın:

• Verse’te yeni bir npc_behavior tanımla.

• npc_behavior’ını NPC karakter tanımına ekle.

• NPC karakter tanımını bir Karakter Çıkma Yeri’ne ekle.

• Persona NPC’lerle konuşmak için sesli sohbet gerekli olduğundan sesli sohbetin etkin olduğundan emin ol.

Boş Bir NPC Davranışı Oluştur

Verse’te özel bir NPC davranışı ayarlamak için şu adımları izle:

1. Menü çubuğunda, Verse > Verse Gezgini’ni seç.

2. Verse Gezgini’nde projenin adına sağ tıkla ve Projeye yeni Verse dosyası ekle’yi seçerek Verse Kodu Oluştur penceresini aç.

3. Verse Kodu Oluştur penceresinde NPC Davranış Temeli’ne tıklayarak onu şablon olarak seç.

4. Yapılandır altında NPC davranışını persona_npc_behavior olarak adlandır.

5. Verse dosyanı oluşturmak için Oluştur’a tıkla.

persona_npc_behavior, Verse aracılığıyla bir persona_component tanımlayabileceğin ve bunu NPC’ne ekleyebileceğin yerdir. Karakter Çıkma Yerleri tarafından çıkarılan tüm NPC’ler aracılardır ve ilişkili bir varlığa sahiptirler. Bu ilişkili varlık, persona_component gibi Scene Graph bileşenlerini bir NPC aracısına eklemeni sağlar.

NPC davranışları Verse’te, temel npc_behavior sınıfından devralınma yoluyla tanımlanır. NPC davranışları hakkında daha fazla bilgi için NPC Davranışlarını Anlama sayfasına göz at.

Persona NPC Davranışını Düzenle

NPC personanı oyuncu için bir konuşma hedefi olarak eklemek için Verse gereklidir. NPC’ni oyuncun için bir konuşma hedefi olarak eklemeden NPC personanla konuşamazsın.

Aşağıdaki bölümlerde Verse kodu, persona_npc_behavior’ı tanımlar. Bu Verse kodunu boş persona_npc_behavior’ına eklemek için şu adımları izle:

• Menü çubuğunda Verse > Projeyi VS Code’da Aç…’ı seç.

• VS Code açıldığında, VS Code Gezgini’nde persona_npc_behavior.verse dosyanı bul.

• Aşağıdaki persona_npc_behavior.verse’ün içeriğini kopyalayıp projendeki Verse dosyana yapıştır.

• Verse kodunu UEFN Araç Çubuğu’nda veya VS Code’da derle.

Verse’ü, bir oyuncu takımının LLM aracılarıyla etkileşimde bulunduğu deneyimler oluşturmak için de kullanabilirsiniz. Verse, birden fazla oyuncu ile LLM aracıları arasındaki etkileşimleri, CreateAudioTeamAndAddPlayers()’ı, AddMember()’ı ve AddChatChannel()’ı kullanarak yönetir.  

Verse kodunun adım adım anlatımı için Kod Açıklaması altındaki adımları izle.

 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 }

Kod Açıklaması

1. TeamName oluşturulmakta olan ses kanalının adıdır. OptionAgentGroup ses kanalına (TeamName) gidecek aracı grubunu tutar. OptionVoiceChannel, oyuncuların ve NPC’nin içinde bulunduğu fiili ses kanalının değişkenidir.   

   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 ise NPC ile onun oyun alanındaki her oyuncu arasında canlı bir sesli konuşma kurar. Fonksiyon öncelikle ihtiyaç duyduğu her şeyi toplar ve ancak bunların hepsinin başarılı olması durumunda aracı grubunu ve ses kanalını oluşturur, oyuncuları ve NPC’yi bunlara bağlar ve oyuncuları konuşma hedefleri olarak kaydeder.  

   Öncelikle konuşmadaki herkesi barındıran team_member_info ile yazılmış yeni bir agent_group oluşturur. Daha sonra bir voice_channel (o da team_member_info ile yazılmıştır) oluşturarak onu TeamName olarak adlandırır ve onun grubunu yeni oluşturulan aracı grubuna yönlendirir. Konuşma sesini taşıyan şey, bu kanaldır.

   Ardından grubu doldurur; oyun alanındaki her oyuncuyu döngüden geçirir ve her birini üye olarak ekler, sonra NPC aracısını da ekler, böylece tüm katılımcılar tek bir grubu paylaşır.

   Daha sonra ses kanalını sesli sohbet sistemine kaydetmek için SimEntity.AddChatChannel(TeamVoiceChannel)’ı çağırır ve bu da kanalı çevrimiçi hale getirir. Son olarak, oyuncuları tekrar döngüden geçirir ve her birinde SetConversationTarget’ı çağırarak onların bu kanal aracılığıyla NPC’nin persona_component’ına yönlendirilmesini sağlar.

   Son adımda grup ve kanal, OptionAgentGroup ile OptionVoiceChannel değişkenlerinde (option{} içine sarılmış) depolanır, böylece sonraki yardımcı fonksiyonlar konuşmayı yeniden oluşturmak zorunda kalmadan ona referans verebilir veya onu değiştirebilir.

   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’nin konuşmasından tek bir oyuncuyu kaldırır. Bir tane oyuncu bağımsız değişkenini alır ve bu oyuncuyu, yönlendirildiği konuşma hedefinden ayıran ClearConversationTarget()’ı (AddPlayersAsConversationTarget içinde yapılan SetConversationTarget’ın tersidir) çağırır.  

   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, yapılandırılmış çıktıyı oturuma ekler ve oyuncuyu konuşma hedefi olarak ayarlar. Oyuncuların geç katılabileceği bir oyunda, onları PlayerAddedEvent’te veya bir oyuncu bir tetikleyici aracılığıyla bir NPC'ye yaklaştığında eklediğinden emin olman uygun olacaktır.    

   Verse

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

   Copy full snippet(2 lines long)

5. OnEnd içinde Konuşma temizlenir ve tüm oyunculardan kaldırılır. Bu, iyi bir uygulamadır.  

   Verse

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

   Copy full snippet(3 lines long)

NPC Karakter Tanımına NPC Davranışı Ekle

persona_npc_behavior’ını NPC karakter tanımına eklemek için şu adımları izle:

1. İçerik Çekmecesi’nde PersonaNPCDefinition’ına git.

   

2. Düzenlemek üzere açmak için PersonaNPCDefinition’ı seç.

3. NPC Karakter Davranışı altında Verse Davranışı > persona_npc_behavior’ı seç.

   

4. Sekmeyi kapatmadan önce NPC Karakter Tanımı’nda yaptığın değişiklikleri kaydettiğinden emin ol.

NPC karakter tanımın bir Karakter Çıkma Yeri’ne eklendiğinde NPC personan otomatik olarak oyuncun için bir konuşma hedefi olarak eklenir.

NPC Karakter Tanımı ile Karakter Çıkma Yeri Ekle

Özelleştirilmiş personana sahip bir NPC çıkarmak için bölümüne bir Karakter Çıkma Yeri eklemeli ve PersonaNPCDefinition’ını eklemelisin. Bir Karakter Çıkma Yeri Cihazı eklemek için PersonaNPCDefinition’ını İçerik Çekmecesi’nden Görünüm Penceresi’ne sürükle.

NPC’nle Konuş

NPC’nle konuşmak için bir oturum aç ve oyunu başlat. Girdi cihazında ekranda belirtilen tuşa veya düğmeye bas ve NPC’nle konuş!

Sıradaki

• 

  Yapılandırılmış Çıktı ile Oynanışı Yönlendir

  Verse’ü kullanarak NPC konuşmalarını ve davranışlarını nasıl geliştirebileceğini keşfet.