Skip to main content

Test ve Simülasyon

Bu kılavuz, oyununuzu mobil cihazlara derlemeden (Build almadan), Unity editörü üzerinde RemoteNex Simülatörü ile nasıl test edeceğinizi anlatır.

Bu süreç, geliştirdiğiniz oyunun kontrolcü entegrasyonunu saniyeler içinde doğrulamanızı sağlar.

1. Sahne Kurulumu (Environment Setup)​

Test ortamını hazırlamak için sahnenize gerekli SDK bileşenlerini eklemeniz gerekmektedir.

A. Simülatör Yöneticisinin Eklenmesi​

  1. Unity projenizde Assets/RemoteNexSDK/Prefabs klasörünü açın.
  2. RemoteNexManager isimli prefabı sahnenize (Hierarchy penceresine) sürükleyip bırakın.
Bu Obje Ne Yapar?
  • Yerel bir web sunucusu (localhost:8080) başlatır.
  • Web tarayıcınızda Simülatör Dashboard'unu otomatik olarak açar.
  • Tarayıcıdan gelen verileri Unity oyununa aktarır.

B. HTML Dosyalarının Kontrolü​

Sahneye eklediğiniz RemoteNexManager objesine tıklayın ve Inspector panelini kontrol edin. Aşağıdaki alanların dolu olduğundan emin olun:

  • Simulator Html File: simulator.html
  • Master Html File: master.html.txt (Veya sizin özel master dosyanız)
  • Normal Html File: normal.html.txt (Veya sizin özel normal dosyanız)

2. Oyun Bağlantısı (Relay Sistemi)​

RemoteNexSDK, oyun kodunuzda (GameManager) herhangi bir değişiklik yapmadan çalışabilmek için "Röle (Relay)" sistemini kullanır.

A. Röle Scriptinin Eklenmesi​

  1. Sahnenizdeki oyun yönetici objesini seçin (Örn: GameManager, PongManager veya LevelController).
  2. Inspector panelinde Add Component butonuna tıklayın.
  3. Arama kutusuna RemoteNexRelay yazın ve scripti ekleyin.

B. Olay Bağlantısı (Kritik Adım)​

Röle scripti, simülatörden gelen veriyi sizin kodunuza yönlendirir. Bu bağlantıyı doğru yapmak çok önemlidir.

  1. RemoteNexRelay bileşenindeki "On Input Received (String)" listesinin altındaki (+) Artı butonuna basın.
  2. None (Object) kutusuna, GameManager scriptinizin bulunduğu objeyi (yani kendi üzerine eklediğiniz objeyi) sürükleyip bırakın.
  3. No Function açılır menüsüne tıklayın ve şu yolu izleyin:
    • SizinManagerSınıfınız (Örn: PongManager) -> HandleInput
⚠️ ÇOK ÖNEMLİ: Doğru Fonksiyon Seçimi

Listede iki adet HandleInput göreceksiniz.

  • Üstteki (Dynamic String): BUNU SEÇMELİSİNİZ. (Yanında yazı kutusu çıkmaz).
  • Alttaki (Static Parameters): Bunu seçmeyin. (Yanında yazı kutusu çıkar).

3. Test ve Simülasyon​

Kurulum tamamlandıktan sonra test aşamasına geçebilirsiniz.

A. Başlatma​

Unity editöründe **Play ** tuşuna basın. Varsayılan web tarayıcınız otomatik olarak açılacak ve RemoteNex Dashboard yüklenecektir.

B. Oyuncu Ekleme ve Kontrol​

Dashboard ekranında:

  1. (+) Oyuncu Ekle butonuna basın.
  2. Ekranda sanal bir telefon belirecektir. Bu işlem oyuna "Yeni Oyuncu Katıldı" sinyali gönderir.
  3. Sanal telefon üzerindeki butonlara (Mouse ile tıklayarak) bastığınızda, oyununuzdaki karakterin hareket ettiğini gözlemleyebilirsiniz.

C. Çoklu Oyuncu ve Cihaz Testi​

  • Birden fazla kez (+) Oyuncu Ekle diyerek 2., 3. oyuncuları oyuna dahil edebilirsiniz.
  • Üst menüdeki Cihaz Seçici (Device Selector) ile iPhone, iPad, Pixel gibi farklı ekran boyutlarında arayüzünüzün nasıl göründüğünü test edebilirsiniz.
  • Döndürme (Rotate) butonu ile yatay/dikey mod testlerini yapabilirsiniz.

Sorun Giderme (Troubleshooting)​

SorunÇözüm
Tarayıcı açılmıyorRemoteNexManager objesinde "Auto Open Browser" kutucuğunun işaretli olduğundan emin olun.
Veri gelmiyor ama hata da yokRemoteNexRelay bağlantısında HandleInput fonksiyonunu Static bölümden seçmiş olabilirsiniz. Dynamic String bölümünden seçtiğinizden emin olun.
Karakter hareket etmiyorGameManager scriptinizdeki ID eşleştirme mantığını kontrol edin. Simülatör ilk oyuncuyu her zaman SimPlayer_1 ID'si ile gönderir.