Unreal Engine Pixel Streaming kurulumu: projeyi tarayıcıya aktarma rehberi

Unreal Engine Pixel Streaming, paketlenmiş bir Unreal Engine uygulamasının görüntü ve sesini web tarayıcısına aktarırken kullanıcı girdilerini de uygulamaya iletebiliyor. Epic Games’in resmi rehberleri, sistemin yerel ağda kurulup bilgisayar ve mobil cihazlardan kullanılmasını adım adım açıklıyor. Aşağıdaki anlatım, öncelikle tek bilgisayarda çalışan bir uygulamayı aynı ağdaki tarayıcılara açmaya odaklanıyor.

Bu rehberde ne öğreneceksiniz?

Kurulum tamamlandığında bir Unreal Engine projesi kendi bilgisayarında çalışırken, başka cihazlar bu uygulamaya tarayıcı üzerinden bağlanabiliyor. Görüntü ve ses uzaktaki cihaza aktarılıyor; varsayılan oyuncu sayfası klavye, fare ve dokunmatik girdi iletimini destekliyor. Böylece mimari sunum, etkileşimli sahne incelemesi veya proje demosu için uygulamanın her cihaza ayrı ayrı kurulması gerekmiyor.

Bu yöntem, uygulamayı buluta taşımakla aynı şey değil: resmi başlangıç rehberi, önce yerel ağda veya VPN’de deneme yapılmasını öneriyor. Bu nedenle adımlar önce tek bilgisayar ve aynı ağdaki istemciler için uygulanmalı. İnternet üzerinden ya da farklı alt ağlardan erişim için ek ağ yapılandırması gerekebilir.

Gereksinimler ve hazırlık

Pixel Streaming eklentisi, video kodlama için Windows, Linux veya Mac işletim sistemlerinde ve belirli GPU donanımıyla çalışabiliyor. Kaynak, desteklenen GPU ayrıntıları için Pixel Streaming Reference belgesine yönlendiriyor; dolayısıyla donanım uyumluluğu kurulumdan önce kontrol edilmeli. Rehber belirli bir Unreal Engine sürümünü zorunlu tutmuyor. Sunucu altyapısı için örnek dal adı olarak 5.7 verilmiş olsa da bu, tüm projeler için sürüm şartı olarak sunulmuyor.

Başlangıç rehberindeki örnek paketleme adımları Windows içindir. Yerel ağ iletişimi için 80 ve 8888 numaralı portların açık olması, bilgisayarda çalışan diğer web sunucularının ise kurulum sırasında durdurulması isteniyor. Aynı bilgisayarda deneme yaparken localhost veya 127.0.0.1 kullanılabilir. Başka cihazlardan bağlanmak için uygulamanın ve Signalling Server’ın çalıştığı bilgisayarın ağ IP adresi gerekir. Kaynaklarda ücretli hesap gereksinimi belirtilmiyor.

Kurulum ve bağlantı adımları

1. Eklentiyi etkinleştirin. Projeyi Unreal Editor’da açın, Edit > Plugins menüsüne gidin ve Graphics kategorisindeki Pixel Streaming ya da Pixel Streaming 2 eklentisini etkinleştirin. Değişikliğin uygulanması için projeyi yeniden başlatın.

2. Başlatma adresini ayarlayın. Edit > Editor Preferences... bölümünde Level Editor > Play kategorisini bulun. Additional Launch Parameters alanına yerel bağlantı adresini ekleyin:

-PixelStreamingURL=ws://127.0.0.1:8888

Karakter içeren projelerde telefon veya tablet üzerinden dokunmatik kontrol isteniyorsa, Edit > Project Settings içindeki Engine > Input kategorisinde Always Show Touch Interface etkinleştirilebilir. Bu ayar isteğe bağlıdır ve projenin Player Controller bileşeninin dokunmatik girdiyi desteklemesine bağlıdır.

1. Projeyi paketleyin. Kaynaktaki Windows örneğinde Files > Package Project > Windows (64-bit) seçilerek uygulama paketleniyor. Eklenti, paketlenmiş uygulamayla veya Unreal Editor’dan Standalone Game seçeneğiyle çalıştırılan projeyle kullanılabiliyor; editörün normal görünümünde çalıştırma, rehberde belirtilen bu seçeneklerin yerine geçmiyor. Paketlenmiş uygulamayı her başlatışta aynı bağlantı parametresini iletin.

2. Pixel Streaming altyapısını alın. Web sunucusu ve ön yüz bileşenleri, Pixel Streaming Infrastructure adlı ayrı bir depoda bulunuyor. Epic’in rehberi bu altyapıyı Git deposundan edinme veya Unreal Engine kurulumundaki get_ps_servers komutunu çalıştırma seçeneklerini sıralıyor. Depoyu klonlama yolunu tercih edenler, kaynakta örnek olarak verilen dal biçimini kullanabilir:

git clone --branch UEX.Y https://github.com/EpicGamesExt/PixelStreamingInfrastructure.git

UEX.Y değeri, seçilen dal adıyla değiştirilmeli; rehber örnek olarak 5.7 dalını gösteriyor. Windows’ta sunucuyu hazırlamak için SignallingWebServer\platform_scripts\cmd\setup.bat, başlatmak için SignallingWebServer\platform_scripts\cmd\start_with_stun.bat çalıştırılıyor. Linux ve Mac’te rehber, aynı işlemin SignallingWebServer\platform_scripts\bash altındaki betiklerle yapıldığını belirtiyor.

1. Uygulamayı sunucuya bağlayın. Signalling Server çalışırken paketlenmiş uygulamayı, önceki adımda belirlenen parametreyle açın. Sunucu penceresinde Streamer connected mesajının görünmesi, uygulamanın sunucuya bağlandığını gösteriyor.

2. Tarayıcıdan erişin. Aynı bilgisayarda desteklenen bir tarayıcı açıp http://127.0.0.1 adresine gidin; sayfada bağlantıyı ve ardından oynatmayı başlatın. Ağdaki başka bir bilgisayar veya mobil cihazdan bağlanırken 127.0.0.1 yerine yayın yapan bilgisayarın IP adresini kullanın. Varsayılan sayfa klavye, fare ve dokunmatik girdileri aktarır; bağlı cihazlar aynı sahneyi görür ve varsayılan olarak uygulamaya ortak girdi gönderir.

Sık karşılaşılan sorunlar ve sonraki adımlar

Bağlantı kurulmazsa önce uygulamanın paketlenmiş olarak ya da Standalone Game biçiminde çalıştığını, eklentinin etkin olduğunu ve başlatma parametresinin doğru eklendiğini kontrol edin. Ardından 80 ve 8888 portlarının iletişime açık olup olmadığını, başka bir web sunucusunun portları kullanıp kullanmadığını gözden geçirin. Tarayıcıda 127.0.0.1 yalnızca aynı bilgisayara işaret eder; başka bir cihazda yayın bilgisayarının IP adresi kullanılmalıdır.

Uygulama penceresi yanlışlıkla küçültüldüğünde girdi akışı durabiliyor. Rehber, bunu önlemek için uygulamanın başlatma parametrelerine -RenderOffScreen ekleme seçeneğini de veriyor. Birden çok ağ veya internet üzerinden erişim planlanıyorsa daha ileri ağ yapılandırması gerekebilir; farklı ağlardan bağlantıda Signalling Server için STUN/TURN ayarları gündeme gelebiliyor. Oyuncu sayfası ayrıca özelleştirilebiliyor; HTML5 arayüzü eklemek ve hangi istemcilerin girdi göndereceğini belirlemek için resmi özelleştirme belgeleri izlenebilir.

Mimarlık, iç mimarlık ve archviz iş akışına etkisi

Pixel Streaming, etkileşimli bir Unreal Engine sunumunu tarayıcı üzerinden paylaşmak isteyen mimarlık ve görselleştirme ekiplerine yarar sağlayabilir. Görüntü, uzaktaki uygulamadan aktarılır; istemcilerin ayrıca uygulama kurması gerekmez. Öte yandan sahneyi çalıştıran bilgisayarın işletim sistemi ve GPU uyumluluğu, ağ bağlantısı ve port ayarları önceden doğrulanmalı. Kaynak, kalite, gecikme ve dayanıklılık arasında ayar tercihleri bulunduğunu da belirtiyor; bu nedenle gerçek sunum koşullarında deneme yapmak önemli. Daha geniş ölçekli veya internet üzerinden kullanım, temel yerel ağ kurulumundan farklı ağ ve sunucu hazırlığı gerektirebilir.

Kaynak ve lisans

Bu rehber, Epic Games’in resmi “Pixel Streaming in Unreal Engine” ve “Getting Started with Pixel Streaming in Unreal Engine” belgelerindeki adımlar temel alınarak Türkçeye uyarlanmıştır. Kaynaklar serbest lisanslı olarak işaretlenmiştir; ancak sağlanan metinlerde lisansın özel adı belirtilmemektedir.