Unreal Engine Pixel Streaming kurulumu: Projeyi tarayıcıya aktarma

Bu rehberde ne öğreneceksiniz?

Unreal Engine Pixel Streaming, uygulamanın görüntü ve sesini uzaktaki bir cihaza aktarırken o cihazdan giriş alınmasına da imkân verir. Böylece Unreal Engine projesi bir web sayfasında görüntülenebilir; masaüstü veya mobil cihazdaki kullanıcılar klavye, fare ya da dokunmatik girişle uygulamayla etkileşebilir. Tarayıcı tarafında ek bir yazılım kurulumu gerekmez.

Bu rehberde projenin yayın için hazırlanması, sunucu bileşenlerinin çalıştırılması ve aynı yerel ağdaki tarayıcıdan bağlantı kurulması anlatılıyor. Epic Games’in başlangıç kılavuzu Windows üzerinden örnek veriyor; Linux ve Mac için sunucu betiklerinin farklı bir klasörde bulunduğunu belirtiyor.

Gereksinimler ve hazırlık

Pixel Streaming eklentisi video kodlamayı Windows, Linux veya Mac işletim sistemli bilgisayarlarda, desteklenen belirli GPU donanımlarıyla yapabiliyor. Kaynak kılavuz uyumlu donanım türlerinin ayrıntıları için Pixel Streaming Reference belgesine yönlendiriyor. Burada belirli GPU modelleri sıralanmadığından, yayın öncesinde uyumluluk ayrıca kontrol edilmeli.

Yerel ağdaki başlangıç kurulumu için 80 ve 8888 numaralı ağ bağlantı noktalarının iletişime açık olması gerekiyor. Bilgisayarda başka web sunucuları çalışıyorsa kılavuz, kuruluma geçmeden önce bunların durdurulmasını öneriyor. İnternet üzerinden veya farklı ağlar arasında bağlantı kurulacaksa ek ağ yapılandırması gerekebilir. İlk denemeyi aynı bilgisayarda, localhost ya da 127.0.0.1 adresiyle yapmak daha basit bir başlangıç sağlar.

Kılavuzda kullanıcı hesabı gereksiniminden söz edilmiyor. Sunucu altyapısı, Epic Games’in GitHub’daki Pixel Streaming Infrastructure deposundan ediniliyor. Proje, paketlenmiş uygulama olarak ya da Unreal Editor içinden Standalone Game seçeneğiyle çalıştırılmalı; eklentinin kullanımı bu iki başlatma biçimi üzerinden açıklanıyor.

Kurulum: projeyi ve sunucuları hazırlama

1. Projeyi Unreal Editor’da açın. Ana menüden Edit > Plugins yolunu izleyin; Graphics kategorisinde Pixel Streaming veya Pixel Streaming 2 eklentisini etkinleştirip projeyi yeniden başlatın. Karakter içeren bir projede mobil dokunmatik kontrol gerekiyorsa Edit > Project Settings altında Engine > Input kategorisindeki Always Show Touch Interface seçeneği kullanılabilir. Bu ayar zorunlu değil; karakterin Player Controller bileşeninin de dokunmatik girişi desteklemesi gerekiyor.

2. Projeyi çalıştırma parametresini belirleyin. Edit > Editor Preferences... içinden Level Editor > Play kategorisindeki Additional Launch Parameters alanına yerel bağlantı adresini ekleyin:

-PixelStreamingURL=ws://127.0.0.1:8888

Bu parametre, uygulamanın Pixel Streaming sunucusuna bağlanacağı adresi belirtir. Projeyi Windows için paketliyorsanız Unreal Editor menüsünden Files > Package Project > Windows (64-bit) yolunu izleyin ve çıktı klasörünü seçin. Uygulama her başlatıldığında aynı parametreyi almalıdır. Kılavuz, parametreyi çalıştırma kısayolunun Target alanına ekleme seçeneğini de açıklıyor.

1. Pixel Streaming sunucu bileşenlerini edinin. Kılavuz, altyapıyı GitHub deposundan doğrudan alabileceğinizi veya tercih ettiğiniz terminalde aşağıdaki komutu kullanabileceğinizi belirtiyor. Örnekteki UEX.Y yerine kullanılacak dal yazılır; belgede örnek olarak 5.7 veriliyor.

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

Alternatif olarak Unreal Engine kurulumundaki \Engine\Plugins\Media\PixelStreaming\Resources\WebServers klasörüne gidip Windows’ta .bat, Linux veya Mac’te .sh uzantılı get_ps_servers betiğini çalıştırabilirsiniz. Bu işlem ilgili altyapı dalını klasöre alır.

1. Windows örneğinde, indirilen altyapının SignallingWebServer klasöründeki kurulum betiğini yönetici olarak açılmış PowerShell’de çalıştırın:

SignallingWebServer\platform_scripts\cmd\setup.bat

Kurulum tamamlandıktan sonra aynı klasör yapısındaki sunucu başlatma betiğini çalıştırın:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

Linux ve Mac’te kılavuz, SignallingWebServer\platform_scripts\bash klasöründeki betiklerin kullanılacağını belirtiyor. Sunucu hazır olduğunda konsolda 8888 numaralı bağlantı noktasında yayıncı bağlantısı, 80 numaralı bağlantı noktasında oyuncu bağlantısı ve HTTP hizmetiyle ilgili dinleme mesajları görülmeli.

Uygulamayı başlatma ve tarayıcıdan bağlanma

Sunucular çalışırken paketlenmiş uygulamayı Pixel Streaming bağlantı adresi parametresiyle başlatın. Örnek komut:

MyPixelStreamingApplication.exe -PixelStreamingURL=ws://127.0.0.1:8888

MyPixelStreamingApplication.exe örnek bir dosya adıdır; kendi paketlenmiş uygulamanızın adı kullanılmalı. Uygulama sunucuya bağlandığında sunucu konsolunda Streamer connected mesajı görülmesi beklenir.

Aynı bilgisayarda desteklenen bir tarayıcı açıp http://127.0.0.1 adresine gidin. Epic’in kılavuzu Google Chrome ve Mozilla Firefox’u uygun seçenekler olarak anıyor. Sayfaya tıklayıp ardından oynat düğmesine basarak akışı başlatın. Varsayılan oyuncu sayfası klavye, fare ve dokunmatik girişleri Unreal Engine uygulamasına iletebilir.

Aynı yerel ağdaki başka bir bilgisayar veya mobil cihazdan bağlanmak için tarayıcıya yayın yapan bilgisayarın IP adresi girilir. Bu yöntemde tüm bağlı cihazlar aynı Unreal Engine örneğinin aynı sahne görünümünü izler; varsayılan ayarda cihazlardan gelen girişler de aynı uygulamaya yönlendirilir. İnternet veya farklı alt ağlardan bağlantı için daha ileri ağ yapılandırması gerekebilir. Kaynak kılavuz, bu tür bağlantılarda STUN/TURN sunucusu ayarlarından söz ediyor.

Yaygın sorunlar ve mimari iş akışındaki yeri

Bağlantı kurulmadığında önce sunucu bileşenlerinin çalıştığını, uygulamanın doğru PixelStreamingURL parametresiyle açıldığını ve 80 ile 8888 numaralı bağlantı noktalarının erişilebilir olduğunu kontrol edin. Başka bir web sunucusunun aynı bilgisayarda çalışması da başlangıç kurulumunu etkileyebilir. Uygulama penceresi küçültüldüğünde giriş akışı kesilirse kılavuz, -RenderOffScreen parametresinin uygulamayı görünür bir pencere olmadan çalıştırma seçeneği olduğunu belirtiyor.

Mimarlık, iç mimarlık ve archviz iş akışlarında bu kurulum, aynı sahneyi birden fazla bilgisayarda veya mobil cihazda göstermek ve tarayıcı üzerinden etkileşimli sunum yapmak isteyen ekipler için yararlı olabilir. Render, uygulamanın çalıştığı ana bilgisayarda üretilir; bağlı cihazlar aynı görünümü alır. Bu nedenle ana bilgisayarın GPU uyumluluğu ve ağ yapılandırması önem taşır. Kılavuz, çözünürlük, ekran boyutu, IP adresleri ve bağlantı noktaları gibi ayarların yapılandırılabildiğini bildiriyor. Kaynaklarda ürünün lisans ve ücret koşulları ya da belirli bir archviz yazılımıyla uyumluluğu açıklanmıyor.

Sonraki adımlar

Temel yayın çalıştıktan sonra oyuncu web sayfası projeye göre özelleştirilebilir. Giriş gönderecek kullanıcıların kontrol edilmesi veya sayfaya HTML5 arayüz öğeleri eklenmesi de mümkün. Epic, kalite, gecikme ve bağlantı dayanıklılığı arasındaki ayarları ele alan bir akış optimizasyon kılavuzu sunuyor. Birden fazla sunucu, farklı istemciler veya internet üzerinden hizmet verme gibi ihtiyaçlar için Hosting and Networking Guide incelenebilir.

Altyapı dosyalarında değişiklik yapılacaksa kılavuz, paket klasöründeki kopya yerine özgün kurulum konumunun düzenlenmesini öneriyor. Paket klasöründeki dosyalar değiştirilirse sonraki paketleme işlemi bu değişikliklerin üzerine yazabilir. İlk kurulumu yerel ağda tamamladıktan sonra, daha kapsamlı bağlantı senaryolarına geçmeden önce proje gereksinimlerini ve kullanılacak ağ ayarlarını gözden geçirmek gerekir.

Kaynak ve lisans

Bu rehber, Epic Games’in Unreal Engine Pixel Streaming belgesi ile Pixel Streaming başlangıç kılavuzundaki bilgilere dayanılarak Türkçeye uyarlanmıştır. Her iki kaynak da serbest lisanslı olarak sağlanmıştır.