Proje Hakkında
Ekrana bakmadan da oynanabilen bir yapay zekâ macerası: telefon sahneyi sesli anlatıyor, sen sesle ya da yazıyla cevap veriyorsun. Projenin asıl fikri şu: yapay zekâ hikâyeyi anlatır, ama oyunun kurallarını ve durumunu (sağlık, envanter, para, konum) uygulama yönetir. Böylece model yanlış bir şey uydursa bile oyun bozulmaz.
Mobil uygulama → Backend API → Yapay zekâ servisi → doğrulanmış yanıt → Mobil uygulama
Oyun Deneyimi
- Ana ekranda tür seçimi kartları, seçilen dünyanın özeti, sunucu durumu ve "Devam et" kartı
- Oyun ekranı: anlatıcı kartı, üç seçenek, serbest metin eylemi, sağlık/bölüm/konum göstergesi (HUD) ve envanter-para çubuğu
- Oyuncu türe uygun bir eşyayla (örneğin fener ya da iksir) başlar; envanterden eşya kullanılabilir
- Her eylemden sonra sağlık, para ve eşyada gerçekte ne değiştiği gösterilir
- Konuşma tanıma ile Türkçe sesli cevap ve sesli anlatım
- Her sahne cihazda kaydedilir; uygulama kapatılıp açılınca kaldığın yerden devam edersin
- İlk açılışta kısa bir marka girişi; ilk kullanımda kullanım, gizlilik, yapay zekâ içeriği, mikrofon ve yerel kayıt bilgilendirmeleri onaylanır (ana ekrandaki "YASAL" düğmesinden tekrar okunabilir)
Güvenilir Oyun Durumu
Model yalnızca etki önerir; sunucu bunları doğrular ve sınırlar:
- Sağlık, para, envanter, konum ve olaylar sunucuda kırpılır; model uç değerler önerse bile geçersiz sonuç uygulanmaz
- Envanterde olmayan bir eşyayı kullanma isteği reddedilir
- Kaynak etkileri anlatıma, satın almaya, hasara/iyileşmeye, ödüle ve eşya kullanımına bağlanır
Sunucu Güvenliği ve Maliyet Koruması
- Yapay zekâ servisinin anahtarı yalnızca sunucuda durur, mobil pakete girmez
- Oyun başlatma, eylem ve sesli anlatım uçlarında küçük gövde sınırları, IP başına ve oyun başına hız sınırları
- Oyuncu metni modele gitmeden önce yaygın "prompt injection" kalıplarına karşı denetlenir; oyuncu/durum/geçmiş alanları sistem isteminde güvenilmeyen veri olarak işlenir
- İsteğe bağlı paylaşılan uygulama anahtarı (yalnızca ek bir kapı; APK içindeki değerler çıkarılabileceği için gerçek kimlik doğrulama sayılmaz)
Teknik Yapı
- Mobil: Expo ve React Native, Expo Router ekranları, TypeScript; bileşen, hook, servis, store ve yardımcı katmanları ayrı
- Backend: Fastify;
POST /api/game/start,POST /api/game/actionveGET /healthuçları - Yayın: API, Coolify üzerinde Docker konteyneri olarak sağlık kontrolüyle çalışır; Android uygulaması EAS ile APK olarak üretilir. Gerçek mikrofon ve konuşma tanıma için Expo Go yetmez, yerel derleme gerekir
Bu Projeden Öğrendiklerim
Büyük dil modelini güvenilmeyen bir bileşen gibi ele alıp sonuçlarını sunucuda doğrulamak, sesli arayüz tasarlamak ve istemciye gizli anahtar koymadan mobil uygulama mimarisi kurmak.
