Tobias Hoffmann

Posted on Apr 21 • Originally published at apidog.com

Oyun Sunucu Arka Uç Ekipleri için API Aracı

ÖZET

Oyun sunucusu arka uçları, doğası gereği protokol çeşitliliği ile çalışır: REST (oyuncu hesapları ve eşleştirme), WebSocket (gerçek zamanlı oyun durumu), gRPC (dahili hizmet iletişimi). Çoğu API aracı sadece REST desteği sunarken, oyun ekiplerinin tam ihtiyacını karşılamakta yetersiz kalır. Bu yazıda, oyun arka uç ekiplerinin ideal API aracında nelere ihtiyaç duyduğunu, Apidog'un WebSocket ve gRPC testinde nasıl devreye girdiğini ve gecikme duyarlılığı gereksinimlerinin nasıl test edilebileceğini adım adım aktaracağız.

Apidog'u bugün deneyin

💡 Apidog ücretsiz, hepsi bir arada bir API geliştirme platformudur. Oyun sunucusu arka uç ekipleri için Apidog, tek bir çalışma alanında REST, WebSocket ve gRPC testini destekler. Böylece oyununuzun dayandığı tüm protokol yığınını, araç değiştirmeden, merkezi bir yerden test edebilirsiniz. Apidog'u ücretsiz deneyin, kredi kartı gerekmez.

Giriş

Oyun sunucusu arka uç geliştirme, çoğu API aracının göz ardı ettiği birden fazla protokol desteğine ihtiyaç duyar. REST uç noktaları; oyuncu profili, envanter ve eşleştirme kuyruklarını yönetir. WebSocket; gerçek zamanlı oyun durumu, konum güncellemeleri ve sohbet için gereklidir. gRPC ise sunucu içi hizmetler arasında hızlı ve tip güvenli iletişim sağlar.

Postman gibi araçlar REST desteğinde iyiyken, WebSocket ve özellikle gRPC için kullanışsız veya ayrı araçlara ihtiyaç duyarsınız. Oyun arka ucunu test etmek için birden fazla aracı yönetmek, geliştirme ve hata ayıklama iş akışını zorlaştırır.

Bir diğer önemli zorluk da, gecikme duyarlılığıdır. Oyun arka uçlarında, klasik API test yaklaşımlarıyla görülmeyen sıkı gecikme gereksinimleri vardır. REST’te 200ms kabul edilebilirken, WebSocket mesajında aynı gecikme oyunu bozabilir.

Bu makale, çok oyunculu arka uç geliştiren oyun stüdyoları ve bağımsız geliştiriciler için, yığınlarının protokol gerçekliğine uygun API testleri yapmaya odaklanır.

Oyun arka uç protokol yığını

Her protokolün oyun arka uçlarındaki tipik kullanım desenlerini anlamak, doğru test kurulumunu oluşturmak için şarttır.

REST: Yönetim Katmanı

REST, durumsuz ve önbelleğe alınabilir işlemler için kullanılır:

Oyuncu kimlik doğrulama ve oturum yönetimi
Oyuncu profilleri ve hesap işlemleri
Envanter ve ekonomi uç noktaları (satın alma, bakiye, vs.)
Eşleştirme kuyruğu işlemleri
Liderlik tabloları ve istatistikler
Oyun yapılandırma alma (haritalar, oyun modları, vb.)

Bu uç noktalar genellikle düşük frekanslı, gecikmeye toleranslıdır ve standart REST test araçlarıyla kolayca test edilebilir.

WebSocket: Gerçek Zamanlı Oyun Durumu

WebSocket, yüksek frekanslı, çift yönlü iletişim için gereklidir:

Oyuncu konumu ve hareket güncellemeleri (saniyede 20-60 mesaj)
Oyun durumu senkronizasyonu
Oyun içi sohbet ve bildirimler
Eşleştirme durumu güncellemeleri
Sunucudan istemciye olaylar

WebSocket testinde, kalıcı bağlantı kurmalı, belirli formatta mesajlar göndermeli, zaman içinde gelen mesajları kayıt altına almalı ve sıralı mesaj akışlarını gözlemlemelisiniz.

gRPC: Dahili Hizmetler

Servis odaklı mimaride, dahili iletişim için genellikle gRPC kullanılır:

Oturum yöneticisi ↔ oyun mantığı sunucusu
Kimlik doğrulama hizmeti ↔ oyun sunucusu
Analitik olay alımı
Dahili liderlik tablosu güncellemeleri

gRPC testi için .proto dosyalarının içe aktarılması, türlenmiş yüklerle yöntem çağrılması gerekir. REST'ten farklı olarak, serbest JSON yerine tip güvenli mesajlarla çalışılır.

Oyun arka uçlarının API araçlarından genellikle kullanmadığı protokoller

İkili WebSocket çerçeveleri
MQTT (IoT benzeri oyunlar hariç)
UDP (oyuna özel protokoller)

Çoğu araç bu protokolleri desteklemez, bu yüzden özel test yardımcı programları gerekebilir.

Oyun arka uçları için REST testi

REST uç noktalarını test etmek temel ihtiyaçtır. Oyun sektöründe aşağıdaki konulara özellikle dikkat etmelisiniz:

Ortam yönetimi: Yerel, geliştirme, hazırlık ve üretim ortamlarına karşı test yapacaksınız. Temel URL'ler, kimlik doğrulama jetonları ve uç noktalar ortama göre değişir. Ortam değişkeni desteği (environment variables) şarttır.

Kimlik doğrulama başlığı yönetimi: JWT veya özel oturum jetonları çoğunlukla kullanılır. Jeton yenilemeyi otomatikleştirmek için ön istek betiği (pre-request script) ile jeton alıp, sonraki isteklere otomatik ekleyin.

Zincirleme istekler: Eşleştirme gibi akışlar, birden fazla sıralı isteğe (oyuncu oluştur, kuyruğa ekle, durum sorgula, maç detayını al) ihtiyaç duyar. Bir isteğin çıktısını diğerine aktarmalısınız.

Test onaylamaları: Yanıtların doğru içerik ve sırada geldiğini, hata kodlarının beklendiği gibi döndüğünü doğrulamak için assertion/script yazmalısınız.

Apidog ile nasıl yapılır?

Apidog, istek öncesi/sonrası JavaScript betikleri, ortam değişkeni enjeksiyonu, assertionlar ve zincirleme istek iş akışlarını ek bir ücret olmadan destekler.

Oyun arka uçları için WebSocket testi

REST’e kıyasla WebSocket testinde daha fazlasına ihtiyaç var.

İyi WebSocket testi nasıl yapılır?

Kimlik doğrulama ve özel başlıklarla WebSocket sunucusuna bağlanın
Belirli mesaj veya mesaj dizisini gönderin
Gelen tüm mesajları zaman içinde gözlemleyin
Belirli eylemler sonrası belirli mesajların geldiğini doğrulayın
Yeniden bağlantı, kalp atışı, bağlantı kesilmesi senaryolarını test edin

Apidog'un WebSocket desteği

Apidog, özel bir WebSocket test arayüzü sunar. Kullanımı:

ws:// veya wss:// ile WebSocket URL’sini girin, kimlik doğrulama başlıklarını ekleyin.
Bağlantı kurulduktan sonra mesaj gönderin, gelen mesajları anlık olarak sohbet görünümünde izleyin.
JSON mesajları için örnek:

  { "type": "join_room", "room_id": "abc123" }

mesajını gönderip, yanıtı anında görebilirsiniz.

İkili mesaj desteği: WebSocket üzerinden protobuf gibi ikili mesajlara ihtiyacınız varsa, Apidog ham gövde (binary body) göndermeye izin verir. Hex veya base64 olarak yük gönderebilir, ikili çerçeveler alabilirsiniz.
Bağlantı başlıkları: El sıkışma sırasında başlık veya query parametresi ile kimlik doğrulama gereksinimlerini karşılar.

Sınırlama: Apidog’da WebSocket testleri, manuel ve etkileşimli olarak yapılır. Mesaj dizisi otomasyonu (ör: A mesajını gönder, 500ms içinde B mesajı gelmeli) yoktur. Bu tür otomasyon için doğrudan WebSocket kütüphanesiyle özel test kodu yazmalısınız.

Oyun arka uçları için gRPC testi

gRPC testleri, hizmet tanımlarınıza göre yapılır. Apidog ile adımlar:

İş Akışı

.proto dosyalarınızı Apidog’a içe aktarın.
Apidog, RPC yöntemlerini otomatik olarak gösterir.
Test etmek istediğiniz yöntemi seçin, alanları doldurun (form olarak gelir).
İsteği gönderin, yanıtı inceleyin.

Böylece Go veya C++’ta gRPC test kodu yazmanıza gerek kalmaz, REST gibi hızlıca test edebilirsiniz.

Akış RPC’leri: Apidog, tekli ve sunucu tarafı akışını destekler. İstemci ve çift yönlü akış desteği kısıtlıdır. En güncel durum için Apidog belgelerini kontrol edin.
TLS: Çoğu üretim gRPC servisi TLS gerektirir. Apidog, TLS üzerinden gRPC’yi ve sertifika doğrulama ayarlarını destekler.

Gecikme testi hususları

Klasik API test araçları oyun özelinde gecikme gereksinimlerini doğrudan çözmez. Apidog da doğrudan bir gecikme testi aracı değildir. Ancak pratik yöntemler kullanabilirsiniz.

Apidog’da yanıt süresi ölçümü

Her REST isteğinde yanıt süresini görebilirsiniz. Aynı isteği art arda çalıştırıp, gecikme değişimini gözlemleyin.
WebSocket için, mesajlarınıza zaman damgası ekleyin, sunucudan gelen yanıtla farkı manuel hesaplayın.

Apidog'un yerine geçmediği noktalar

Ciddi performans ve yük testi için aşağıdaki araçları kullanın:

REST yük testi: k6, Locust
WebSocket bağlantı ve yük testi: WebSocketBenchmark, özel araçlar
Senaryo tabanlı test: Gatling
Protokole özel gecikme ölçümü: Custom testler

Apidog, geliştirme ve hata ayıklama için uygundur; gerçekçi oyuncu yüküyle test için yük test araçları gereklidir.

Oyun arka uçları için pratik bir test kurulumu

Tipik bir Apidog çalışma alanı şu şekilde yapılandırılabilir:

Klasör yapısı:

Her alt sistem için klasörler: auth, eşleştirme, envanter, liderlik-tabloları, oyuncu-profilleri
WebSocket testleri için: websocket-bağlantıları
gRPC için: dahili-hizmetler
Ortamlar: local, dev, staging, prod

Ortam değişkenleri örneği:

BASE_URL = http://localhost:3000
WS_URL = ws://localhost:3000/game
GRPC_HOST = localhost:50051
PLAYER_TOKEN = {{generated via pre-request script}}
TEST_PLAYER_ID = player_001
TEST_ROOM_ID = room_test_001

Kimlik doğrulama otomasyonu:

Koleksiyon düzeyinde, kimlik doğrulama uç noktasına istek atan ve JWT'yi ortam değişkenine kaydedip, tüm isteklerde otomatik kullanan bir pre-request script yazın.

WebSocket oturum akışları:

Her ana akış için WebSocket bağlantı dokümanı oluşturun: oyun-oturumuna-katıl, eşleştirme-akışı, yeniden-bağlantı-testi. Her dokümanda doğru başlıklarla bağlantı kurun, mesaj dizisi ve beklenen akışları not edin.

gRPC hizmet testi:

.proto dosyalarını doğrudan içe aktarın. Her RPC yöntemini, başarılı ve hata durumlarıyla test edin. Özellikle geçersiz oyuncu kimliği veya oturum jetonu gibi hata kodlarını kontrol edin.

Sıkça Sorulan Sorular

Apidog, özel ikili protokollerle çalışan oyun motorlarında WebSocket ikili çerçevelerini destekler mi?

Evet, WebSocket mesajlarında ham ikili gövde gönderebilirsiniz. Hex veya base64 kodlu yükleri destekler; ancak tamamen özel çerçeveleme için özel bir test aracına ihtiyaç duyabilirsiniz.

Apidog, gRPC çift yönlü akışı test edebilir mi?

Tekli ve sunucu tarafı akışı destekler. Tam çift yönlü akış için güncel destek durumunu Apidog belgelerinden kontrol edin. Ayrıca grpcurl veya BloomRPC gibi araçlar kullanılabilir.

Oyun sunucusu bölgeleri arasında test nasıl yönetilir?

Her bölge için ayrı ortam tanımlayın (temel URL ve sunucu adresleri ile). Aynı testleri farklı ortamlarla çalıştırarak, bölgesel dağıtımları kolayca doğrulayabilirsiniz.

Birden fazla oyuncu istemcisine bağlı eşleştirme akışlarını nasıl test ederiz?

Apidog, tek seferde bir istemciyi test eder. Çoklu istemci senaryoları için iki Apidog oturumu açabilir veya entegrasyon testlerini kendi kodunuzla yazmalısınız.

Apidog, WebSocket kimlik doğrulama başlıklarını destekliyor mu?

Evet. Bağlantı kurmadan önce özel başlıklar (örn. JWT) ekleyebilirsiniz.

Apidog’da WebSocket mesaj dizisini otomatik tekrar oynatmak mümkün mü?

Hayır, bu özellik yok. Otomatikleştirilmiş WebSocket testi için özel araçlar veya Playwright, ws (Node.js), websockets (Python) gibi kütüphanelerle test kodu yazmalısınız.

Oyun arka uç ekipleri, protokol yığınlarının gerçekliğine uygun araçlara ihtiyaç duyar. REST, WebSocket ve gRPC’yi tek arayüzde birleştiren Apidog, günlük geliştirme ve hata ayıklama için ciddi zaman kazancı sağlar. Yük testi ve en düşük seviyeli protokol hata ayıklaması için ayrı araçlar gerekse de, merkezi test ve doğrulama iş akışı için Apidog yeterli ve pratiktir.

DEV Community