Neocortex Logo

Unity'de NPC'lerin ChatGPT ile Konuşmasını Sağlama

Unity'de NPC'lerin ChatGPT ile konuşmasını sağlayın: UnityWebRequest ile OpenAI API'sini çağırın, size neyin kaldığını görün ve sesli bir karakteri daha hızlı yolla ekleyin.

Sercan AltundasFounder of Neocortex

· 9 dk okuma

Unity'de NPC'lerin ChatGPT ile konuşmasını sağlayın: UnityWebRequest ile OpenAI API'sini çağırın, size neyin kaldığını görün ve sesli bir karakteri daha hızlı yolla ekleyin.

"ChatGPT NPC", çoğu Unity geliştiricisinin bir AI karakterini ilk kez hayal ettiği biçimdir: oyuncunun yazdığını bir dil modeline gönderin, cevabı NPC'nin başının üstünde gösterin. Bu rehber tam olarak bunu OpenAI API'si ile kurar, sonra size neyi çözmenin kaldığını gösterir ve aynı NPC'nin Neocortex Unity SDK'sıyla nasıl göründüğünü anlatır.

1. yol: OpenAI API'sini kendiniz çağırın

Bir OpenAI API anahtarına ve bir Unity projesine ihtiyacınız var. NPC bir mesaj listesi tutar; karakterin kim olduğunu anlatan bir sistem prompt'u ile başlar ve oyuncu her konuştuğunda tüm listeyi gönderir:

using System;
using System.Collections;
using System.Collections.Generic;
using System.Text;
using UnityEngine;
using UnityEngine.Networking;

public class ChatGptNpc : MonoBehaviour
{
    [Serializable] class Message { public string role; public string content; }
    [Serializable] class ChatRequest { public string model; public Message[] messages; }
    [Serializable] class Choice { public Message message; }
    [Serializable] class ChatResult { public Choice[] choices; }

    [SerializeField] private string apiKey; // for local testing only, never ship it
    private readonly List<Message> history = new()
    {
        new Message { role = "system", content = "You are Brannoch, a gruff village blacksmith. Answer in one or two sentences." }
    };

    public IEnumerator Ask(string playerLine)
    {
        history.Add(new Message { role = "user", content = playerLine });
        string body = JsonUtility.ToJson(new ChatRequest { model = "MODEL_NAME", messages = history.ToArray() });

        using var request = new UnityWebRequest("https://api.openai.com/v1/chat/completions", "POST");
        request.uploadHandler = new UploadHandlerRaw(Encoding.UTF8.GetBytes(body));
        request.downloadHandler = new DownloadHandlerBuffer();
        request.SetRequestHeader("Content-Type", "application/json");
        request.SetRequestHeader("Authorization", "Bearer " + apiKey);
        yield return request.SendWebRequest();

        if (request.result != UnityWebRequest.Result.Success) { Debug.LogWarning(request.error); yield break; }
        Message reply = JsonUtility.FromJson<ChatResult>(request.downloadHandler.text).choices[0].message;
        history.Add(reply);
        Debug.Log(reply.content); // show it in your dialogue UI
    }
}

MODEL_NAME yerine OpenAI'nin dokümanlarındaki güncel bir modeli yazın, StartCoroutine(npc.Ask("Got any work?")) çağrısını yapın ve Brannoch cevap verir. Bu, yaklaşık kırk satırlık çalışan bir prototip.

Prototipin size bıraktıkları

İlk konuşma kolay kısım. Bunu yayımlamak için şunları çözmeniz gerekir:

  • Anahtar. Bir build içindeki OpenAI anahtarı herkes tarafından çıkarılabilir ve tüm hesabınızın harcamasını tüketebilir. Oyun ile API arasında kendi sunucunuza ihtiyacınız var.
  • Ses. Oyuncu için konuşma-metin dönüşümü, cevap için metin-konuşma dönüşümü ve ikisi arasında streaming; yoksa her cevap ikisinin de bitmesini bekler. Ses hattı rehberimiz bunu parça parça anlatıyor.
  • Duygu ve eylemler. Cevap düz metin. Animasyonu ya da oynanışı sürmek için JSON istemeniz, onu ayrıştırmanız ve bozuk geldiği durumları ele almanız gerekir.
  • Geçmiş. Liste her satırla büyür ve maliyet ile gecikme de onunla birlikte büyür. Kırpma ya da özetleme gerekir.
  • Karakterde kalmak. Oyuncular zorladığında yalnızca bir sistem prompt'u çabuk bozulur. AI NPC'leri karakterde nasıl tutarsınız yazısına bakın.
  • Maliyet kontrolü. Hiçbir şey bir oyuncunun faturanızda bütün gün konuşmasını engellemez.

2. yol: Aynı NPC'yi Neocortex ile kurun

Neocortex ile Brannoch'u bir kez tarayıcı editöründe tasarlarsınız: kişilik, dünya, bilgi tabanı, ses ve eylemler. Gerisini Unity SDK'sı halleder:

  1. Unity'de paketi git URL'sinden ekleyin: https://github.com/neocortex-link/neocortex-unity-sdk.git
  2. API anahtarınızı Tools > Neocortex > Settings bölümüne yapıştırın.
  3. Hierarchy'ye sağ tıklayın ve Neocortex > Complete Voice Chat seçeneğini seçin, sonra Smart Agent'ın açılır listesinden Brannoch'u seçin.
  4. Play'e basın ve konuşun.

Koddan, sesli cevaplı bir metin sorusu tek bir çağrıdır:

agent.TextToAudio("Got any work?"); // agent is a NeocortexSmartAgent

Her cevap, her biri bir duyguyla gelen satırlar olarak gelir; ayrıca hedef aldıkları nesnenin kimliğiyle birlikte eylemler de gelir. Böylece animasyon ve oynanış ayrıştırılmış metne değil Unity olaylarına bağlanır. Adım adım Unity AI karakter eğitimimiz tüm kurulumu gösteriyor.

Yan yana

OpenAI API doğrudanNeocortex Unity SDK
İlk metin cevabıYaklaşık 40 satır kodKod yok
Giriş ve çıkışta sesKendiniz kurun: STT, TTS, streamingAkışla çalışan tek bileşen
Satır başına duyguBunu isteyin ve ayrıştırınYerleşik, 17 duygu
EylemlerJSON isteyin ve doğrulayınEditörde tanımlanır, veri olarak gönderilir
Anahtar korumasıKendi sunucunuzHer anahtar için oyuncu ve karakter başına limitler
WebGL mikrofonuUnity'de yokDahil şablon
Karakter tasarımıBir sistem prompt'uTarayıcıda test edilebilen görsel editör

Kendin yap yolunda sık karşılaşılan sorular

  • "Cevap yarım kalıyor." Model çıktı limitine ulaştı. Sistem prompt'unda kısa cevaplar isteyin; bu aynı zamanda daha iyi diyalog demek.
  • "Konuştuğumuzu unuttu." Her seferinde tüm geçmişi göndermeniz gerekir. Bir dil modeli istekler arasında hiçbir şeyi hatırlamaz.
  • "WebGL build olarak yayımlayabilir miyim?" Anahtar içindeyken hayır: tarayıcının ağ sekmesinde herkes onu okuyabilir. İstekleri kendi sunucunuz üzerinden gönderin.

Sonraki adımlar

Unity'de Neocortex ile daha ileri gitmek için sesli sohbet ve betikli satırlar için metin-konuşma yazılarına bakın. Prototip yaparken bir modeli kendi makinenizde çalıştırmak isterseniz, Unity'de bir LLM'i yerel olarak nasıl çalıştırırsınız yazısını okuyun. Tüm eğitimler AI NPC kurma rehberinde yer alıyor.

Kasım 2026'da kontrol edildi. Neocortex, OpenAI ile bağlantılı değildir.

Sık sorulan sorular

Unity'de NPC'ler için ChatGPT kullanabilir miyim?

Evet. Unity'den UnityWebRequest ve karakteri anlatan bir sistem prompt'u ile OpenAI API'sini çağırabilirsiniz. Sesi, duyguları, eylemleri ve anahtar limitlerini kendiniz kurmadan istiyorsanız, Neocortex Unity SDK'sı üzerinden tam bir karakter elde edersiniz.

Bir Unity oyununa OpenAI API anahtarı koymak güvenli mi?

Hayır. Bir build içindeki her şey çıkarılabilir ve bir OpenAI anahtarı hesabınızın harcamasına tam erişim verir. OpenAI'yi doğrudan çağırıyorsanız istekleri kendi sunucunuzdan geçirin. Neocortex anahtarları, sunucularımızın uyguladığı oyuncu ve karakter başına kullanım limitleri taşıyabilir ve bir anahtarı panelden devre dışı bırakabilirsiniz.

ChatGPT ile çalışan bir NPC'yi karakterde nasıl tutarım?

Belirli bir sistem prompt'u yazın, dünyayı anlatın, karakterin bildiklerini sınırlayın ve karakteri bozmaya çalışan oyuncularla test edin. Neocortex karakterleri dünyası, bilgi tabanı ve eylemleriyle bir editörde kurulur ve anlattığınız dünyanın içinde kalır.

ChatGPT ile çalışan bir NPC'yi nasıl konuşturabilirim?

Oyuncu için konuşma-metin dönüşümüne, cevap için metin-konuşma dönüşümüne ve bekleme süresini kısa tutmak için ikisi arasında streaming'e ihtiyacınız var. Neocortex Unity SDK'sı bu üçünü tek bir bileşenden yapar.

Benzer yazılar

Okumaya devam et