Unreal Engine Remote Control ile mimari sahneye web paneli kurma rehberi

Bu rehberde ne öğreneceksiniz?

Unreal Engine Remote Control, proje içeriğinin belirli özelliklerini ve işlevlerini editör arayüzünün dışından yönetmeye yarıyor. Epic’in dokümantasyonuna göre sistem, Unreal Engine içinde çalışan bir web sunucusu üzerinden HTTP isteklerini ve WebSocket mesajlarını kabul ediyor. Remote Control Web Interface ise dışa açılan özellikleri, kod yazmadan web arayüzündeki widget’lara bağlamayı sağlıyor.

Bu rehberde eklenti için gerekenleri, tarayıcı arayüzünün nasıl açılacağını ve bir özelliğin panele nasıl ekleneceğini adım adım ele alıyoruz. Mimari görselleştirme açısından örnek kullanım; sahne için dışa açılmış bir parametreyi, örneğin bir PostProcessVolume içindeki Contrast özelliğini, tarayıcıdan değiştirmektir. Bu, bütün sahne ayarlarının otomatik olarak erişilebilir olduğu anlamına gelmez: kontrol edilecek özelliklerin Remote Control Preset üzerinden açılmış olması gerekir.

Gereksinimler ve dikkat edilmesi gerekenler

• Unreal Editor’da açılmış bir proje gerekir.

Dokümantasyon belirli bir Unreal Engine sürüm numarası, donanım gereksinimi ya da ürün fiyatı vermiyor. Bu nedenle mevcut proje ve kurum ortamındaki uyumluluk ayrıca doğrulanmalı; kaynakta bulunmayan bir sürüm veya donanım varsayımı yapılmamalıdır. Remote Control, paketlenmiş projelerde veya oyun çalışırken varsayılan olarak kapalıdır. Bu çalışma biçimlerinde etkinleştirmek için kaynakta belirtilen başlatma işaretleri gerekir.

Web arayüzünü etkinleştirin

1. NodeJS’i bilgisayara kurun ve sürümünün belirtilen aralıkta olduğunu doğrulayın. Ardından Unreal projesini Editor’da açın.

2. Ana menüden Edit > Plugins bölümünü açın. Messaging kategorisindeki Remote Control Web Interface eklentisini etkinleştirin.

3. Unreal Engine’i yeniden başlatın. Arayüzün çalıştığını doğrulamak için Window > Developer Tools > Output Log penceresini açıp “remote control web” ifadesini filtreleyin. Başarılı başlangıç kaydında web uygulamasının çalıştığını ve port bilgisini gösteren bir mesaj görünmelidir; dokümantasyondaki örnek port 7000’dir.

4. Aynı makinede bir tarayıcı açıp 127.0.0.1:7000 adresine gidin. Proje ayarlarından Remote Control Web Interface’in kullandığı port değiştirilebilir. Başka bir bilgisayardan erişim için ek yapılandırma gerektiğini Epic’in Remote Control Quick Start belgesi açıklıyor; burada bu yapılandırmanın ayrıntılarını varsaymayın.

Web sayfası açıldıktan sonra, Unreal oturumunda açık olan Remote Control Preset arayüz tarafından okunur. Yani panelde kullanılacak özellikler, önce preset içinde dışa açılmış olmalıdır. Preset’te hangi parametrelerin kullanılabilir olacağı ve bunların nasıl adlandırılacağı, mimari görselleştirme ekibinin kontrol ihtiyacına göre planlanabilir.

Bir özelliği panele bağlayın

1. Web uygulamasında Control görünümünü Design moduna alın ve Properties sekmesine geçin.

2. Properties panelinde görünen dışa açılmış özelliklerden birini seçip sağ taraftaki çalışma alanına sürükleyin. Bir panel widget’ı yoksa uygulama bunu oluşturur; seçilen özellik için uygun widget da panele eklenir.

3. Örneğin, preset’te dışa açılmış bir Contrast özelliği bir renk seçiciyle temsil edilebilir. Epic’in dokümantasyonunda bu, sahnenin PostProcessVolume bileşenindeki Contrast alanına bağlı örnek olarak veriliyor. Kullanılabilir widget türü özelliğin veri biçimine göre değişebilir.

4. Control moduna dönün, web arayüzündeki değeri değiştirin ve Unreal Editor’daki ilişkili özelliğin güncellendiğini kontrol edin.

5. Düzeninizi korumak için Unreal Editor’da ilgili Remote Control Preset’i kaydedin. Dokümantasyona göre web uygulamasını daha sonra açtığınızda arayüz düzeni son kaydedilen Asset durumuna göre yüklenir.

Arayüzde düğme, renk seçici, kadran, açılır liste, joystick, etiket, liste, panel, kaydırıcı, sekme, metin, anahtar ve vektör gibi widget seçenekleri bulunuyor. Panel, diğer widget’ları içinde tutan kapsayıcıdır. Bir sekmede birden fazla arayüzü listelemek için List widget’ı kullanılabilir. Widget’ların etiketleri ve bağlı oldukları özellikler ayarlanabilir. Vektör gibi bazı veri biçimleri için joystick, kadran veya kaydırıcı gösterimi seçilebilir.

Mimari ve görselleştirme iş akışında kullanım

Mimari sunumlarda veya canlı görselleştirme oturumlarında, sahneye ait dışa açılmış ayarları tarayıcıdan yönetmek farklı bir kontrol arayüzü kurmaya imkân verir. Bir ekip, ihtiyacı olan özellikleri preset’te görünür kılıp bunları anlaşılır etiketlerle panele yerleştirebilir. Aynı web uygulamasına birden fazla istemci bağlanabilir; bir istemcide yapılan değişiklikler diğerlerine web sunucusu üzerinden iletilir. Bu, ortak bir canlı oturumda yararlı olabilir.

Remote Control Web Interface içinde Level Snapshots ve Sequencer için özel sekmeler de yer alır. Level Snapshots işlevi için ilgili eklentinin etkin olması gerekir. Sequencer sekmesi projedeki sekansları görüntüleyip adlarına göre filtrelemeye ve mevcut seviyedeki sekansları başlatmaya veya sürdürmeye yarar. Kaynak, listede proje genelindeki sekansların görülebildiğini ancak yalnızca mevcut seviyede bulunanların oynatılabildiğini belirtiyor.

Bir başka önemli nokta, editör arka plandayken güncellemelerin görünmesiyle ilgili. Unreal Editor’da Edit > Editor Preferences bölümünün General > Performance kısmında Use Less CPU when in Background seçeneğini kapatmak, web uygulamasında değiştirilen değerlerin Editor’da görünmesine yardımcı olabilir. Ayrıca HTTP API kullanılacaksa yalnızca Blueprint ve Python tarafından erişilebilir olarak açılmış fonksiyonlar ve özellikler üzerinde işlem yapılabilir. Değişiklikleri geri alınabilir kılmak için API tarafında işlem geçmişine kaydetme seçenekleri bulunur; bu, ekibin çalışma biçimine göre değerlendirilmelidir.

Sık yapılan hatalar ve sonraki adımlar

Web sayfası açılmıyor: Eklentinin etkin olup olmadığını, Unreal Engine’in yeniden başlatıldığını ve Output Log’da başarılı başlangıç mesajı bulunup bulunmadığını kontrol edin. Kaynakta verilen yerel adres ve örnek port 127.0.0.1:7000 şeklindedir; proje ayarlarında portun değiştirilmiş olabileceğini de göz önünde bulundurun.

Properties listesinde beklenen ayar görünmüyor: Web arayüzü açık Remote Control Preset’i okur. Kontrol edilecek özelliğin preset’te dışa açılmış olduğundan emin olun. API üzerinden doğrudan erişimde de her özellik desteklenmez; kaynak, erişim koşullarını özelliğin türüne ve kullanım kipine göre ayrıca sınırlar.

Bir değişiklik diğer istemcilerde görünmüyor: Dokümantasyon birden fazla web istemcisinin kullanılabildiğini ve değişikliklerin sunucu üzerinden yayıldığını belirtir. Bunun için istemcilerin aynı çalışan web uygulamasına bağlı olduğundan emin olun; farklı ağlardan erişim için gerekli yapılandırmayı ayrıca inceleyin.

İlk uygulamada yalnızca birkaç gerekli özelliği panele ekleyip Editor’daki karşılıklarını doğrulayın. Ardından sekmeleri iş akışına göre ayırabilir, Sequencer veya Level Snapshots entegrasyonlarının ihtiyaç duyulup duyulmadığını değerlendirebilirsiniz. Paketlenmiş projelerde Remote Control’un varsayılan olarak kapalı olduğunu ve beta uyarısını dağıtım planına dahil edin.

Kaynak ve lisans

Bu rehber, Epic Games’in “Remote Control for Unreal Engine”, “Remote Control Web Application for Unreal Engine” ve “Remote Control API HTTP Reference for Unreal Engine” resmi dokümantasyonlarından Türkçeye uyarlanmıştır. Kaynaklar lisans=serbest olarak sunulmuştur; içerik yeniden yazılmış, doğrudan alıntı kullanılmamıştır.