Unreal Engine Pixel Streaming kurulumu: Mimari projeleri tarayıcıya aktarın

Epic Games’in Unreal Engine belgeleri, Pixel Streaming’in yerel ağda kurulup web tarayıcıları ve mobil cihazlar üzerinden kullanılmasını açıklıyor. Bu rehber, mimari görselleştirme veya etkileşimli sunum amacıyla hazırlanan bir Unreal Engine uygulamasını aynı ağdaki izleyicilere açmak isteyen ekipler için temel kurulum akışını bir araya getiriyor. Adımlar, belgelerde anlatılan Pixel Streaming ve Pixel Streaming 2 eklentileri için geçerli; işletim sistemi ve donanım uyumluluğu kullanılan kurulumla ayrıca doğrulanmalı.

1. Uygulamayı ve eklentiyi hazırlayın

Pixel Streaming, sıradan bir editör penceresini doğrudan paylaşmak yerine paketlenmiş uygulamanın ya da Standalone Game modunda başlatılan projenin görüntüsünü aktarır. Bu nedenle önce projeyi bu iki çalıştırma biçiminden biri için hazırlayın.

1. Unreal Editor’da Edit > Plugins menüsünü açın. Graphics kategorisinde Pixel Streaming veya Pixel Streaming 2 eklentisini etkinleştirin ve editörü yeniden başlatın.

-PixelStreamingURL=ws://127.0.0.1:8888

1. Paketlenmiş uygulama örneği için Files > Package Project > Windows (64-bit) yoluyla Windows paketi oluşturun. Uygulamayı her başlatışta aynı bağlantı parametresinin verilmesi gerekir; belgeler bunu kısayolun hedef satırına ekleyerek kullanmayı da anlatıyor.

Uygulama penceresinin küçültülmesi halinde giriş akışının durması olasılığını önlemek için -RenderOffScreen parametresi de eklenebilir. Bu seçenek uygulamayı görünür pencere olmadan çalıştırır; her proje için zorunlu değildir.

2. Pixel Streaming sunucularını çalıştırın

Web ön yüzü ve sunucu bileşenleri, Unreal Engine uygulamasından ayrı çalışan Pixel Streaming Infrastructure içinde bulunur. Epic’in başlangıç belgesi bu bileşenleri GitHub deposundan almayı veya kurulumdaki get_ps_servers komutunu kullanmayı tarif ediyor. Belgedeki örnekte depo dalı için 5.7 gösteriliyor; bu, her kurulumda aynı dalın seçilmesi gerektiği anlamına gelmez. Kullanılan Unreal Engine sürümüyle uyumlu dalı kontrol edin.

1. Altyapı dosyalarını edinin ve SignallingWebServer klasöründeki sunucu betiklerini bulun.

2. Windows örneğinde PowerShell’i yönetici olarak açıp bağımlılıkları kurmak için şu betiği çalıştırın:

SignallingWebServer\platform_scripts\cmd\setup.bat

1. Ardından sinyal sunucusunu başlatın:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

Sunucunun hazır olduğunda 8888 portunda yayıncı, 80 portunda oyuncu WebSocket bağlantısı dinlediğine ve HTTP hizmetinin 80 portunda çalıştığına dair çıktılar görülür. Başlangıçtan önce aynı bilgisayarda çalışan başka web sunucuları varsa durdurun. Linux ve Mac’te aynı süreç uygulanır; belgede Windows komut dosyaları yerine SignallingWebServer\platform_scripts\bash altındaki betiklerin kullanılması belirtiliyor.

Uygulama ve sunucular çalışır durumdayken tarayıcıda http://127.0.0.1 adresini açın. Oynatıcı sayfasına bağlandıktan sonra sayfaya tıklayıp akışı başlatın. Aynı yerel ağdaki başka bilgisayarlar veya mobil cihazlar, 127.0.0.1 yerine sunucu bilgisayarının ağ IP adresini kullanarak bağlanabilir.

3. Ağ erişimini ve kullanıcı kontrolünü planlayın

İlk denemeyi aynı bilgisayarda veya yerel ağda yapmak, kurulum sorunlarını dış ağ bağlantısından ayırmaya yardımcı olur. Başlangıç belgesinde 80 ve 8888 portlarının yerel ağ iletişimi için açık olması isteniyor. Farklı ağlardan erişim planlanıyorsa yalnızca bu portları açmak yeterli olmayabilir: NAT, alt ağlar veya mobil operatör ağları bağlantıyı etkileyebilir.

Bu gibi durumlarda sinyal sunucusunun peerConnectionOptions yapılandırmasına STUN veya TURN sunucusu bilgileri eklenebilir. STUN, uç noktaların dışarıdan görünen IP adreslerini bulmasına yardımcı olur. TURN ise medya akışını sunucu üzerinden aktarır; bu nedenle bant genişliği ve aktarım yükü dikkate alınmalıdır. Epic’in belgeleri, mobil operatör ağları veya güvenli kurumsal ağlarda TURN kullanımının gerekebileceğini belirtiyor. İnternete açık bir sunucu kurarken yapılandırma ve erişim güvenliği ayrıca ele alınmalı; yerel ağ örneğini doğrudan üretim hizmeti olarak değerlendirmemek gerekir.

Varsayılan oynatıcı sayfasında bağlanan cihazlar klavye, fare ve dokunmatik girişleri iletebilir. Bir sunumda yalnızca sunucunun kontrol etmesi, diğer katılımcıların ise izlemesi isteniyorsa farklı kullanıcı grupları için farklı HTML oynatıcı sayfaları özelleştirilebilir. Böylece tek bir Unreal Engine oturumuna erişen kullanıcıların kontrol seçenekleri ayrıştırılabilir.

Mimari ve görselleştirme iş akışına etkisi

Pixel Streaming, etkileşimli bir Unreal Engine sahnesini web sayfası üzerinden farklı ekranlarda deneyimletmek için kullanılabilir. İzleyicilerin ek bir yazılım kurmadan tarayıcıdan bağlanabilmesi, sunum veya proje inceleme akışlarında erişimi kolaylaştırır. Ancak sahne uzaktaki ana bilgisayarda çalışır; bağlı cihazlar aynı sahnenin görüntüsünü alır. Varsayılan durumda girişler de ortak kontrol edilebilir, bu nedenle sunum sırasında kontrol yetkisi önceden düşünülmelidir.

Görüntü kalitesi, kullanılabilir ana bilgisayarın GPU ve bellek kapasitesinden etkilenebilir. İnternete veya çok sayıda eşzamanlı kullanıcıya açılacak bir hizmette sunucu donanımı, ağ koşulları ve ölçekleme yaklaşımı birlikte değerlendirilmelidir. Epic, büyük ya da talebe göre büyüyen dağıtımlar için dinamik ölçeklemeyi öneriyor; sabit sayıda uygulama çalıştırmak küçük ölçekli kullanımda mümkün olsa da boş kaynak veya bağlantı bekleme riski doğurabilir. SFU özelliği çok sayıda izleyici ve farklı ağ koşulları için seçenek olabilir, ancak belgelerde deneysel olarak tanımlanıyor.

Sık yapılan hatalar

• Eklentiyi açtıktan sonra editörü yeniden başlatmamak veya uygulamayı paketlenmiş/Standalone Game biçimi dışında çalıştırmak.

• Uygulamayı bağlantı parametresi olmadan başlatmak ya da sunucuları çalıştırmadan tarayıcıdan bağlanmaya çalışmak.

• Yerel ağ testi yerine ilk denemeyi internet üzerinden yapmak; bu durumda NAT, STUN/TURN ve güvenlik duvarı kaynaklı sorunları ayıklamak zorlaşır.

• 80 ve 8888 portlarının açık olduğunu doğrulamamak veya başka bir web sunucusunun aynı kurulumla çakışmasına izin vermek.

• Sunumda tüm katılımcıların varsayılan olarak aynı oturuma giriş gönderebildiğini gözden kaçırmak.

İlk başarılı bağlantıdan sonra tarayıcıdan klavye, fare ve gerekiyorsa dokunmatik girişi ayrı ayrı sınayın. İnternet üzerinden yayın veya çok kullanıcılı dağıtım planlanıyorsa ağ yapılandırmasını, sunucu kapasitesini ve kullanıcı yetkilerini pilot aşamada test edin.