Unreal Engine Pixel Streaming kurulumu: Yerel ağda mimari sunum rehberi

Unreal Engine’in Pixel Streaming sistemi, bir projeyi uzak bilgisayarda çalıştırıp görüntü ve sesini web tarayıcısına iletir. Epic Games’in resmi belgelerinde anlatılan temel kurulum, önce yerel ağda denenebiliyor; masaüstü bilgisayarlar ve mobil cihazlar bu yayına tarayıcı üzerinden bağlanabiliyor. Böylece mimari bir sahnenin çalıştırıldığı bilgisayar ile sunumu izleyen cihazların aynı donanımı kullanması gerekmiyor.

Bu rehber, resmi Unreal Engine belgelerindeki yerel ağ adımlarını izler. Belgeler belirli bir minimum motor sürümü belirtmiyor; altyapı dalı örneği olarak 5.7 veriliyor. Pixel Streaming eklentisi Windows, Linux veya Mac üzerinde çalışabilse de video kodlama için uygun GPU donanımı gerekiyor. Donanım ve tarayıcı desteği ayrıntıları için resmi Pixel Streaming başvuru belgelerine bakılmalı.

1. Projeyi yayına hazırlayın

1. Unreal Editor’da projeyi açın ve Edit › Plugins menüsünden Graphics kategorisine gidin. Pixel Streaming veya Pixel Streaming 2 eklentisini etkinleştirip editörü yeniden başlatın. Hangi eklentinin kullanılacağı projedeki kurulumla uyumlu olmalı; belgeler iki seçeneği de listeliyor.

-PixelStreamingURL=ws://127.0.0.1:8888

1. Telefon veya tablet kullanıcılarının sahnede bir karakteri dokunarak kontrol etmesi gerekiyorsa Project Settings › Engine › Input bölümündeki Always Show Touch Interface ayarını etkinleştirin. Bu seçenek her proje için zorunlu değil; ayrıca projenin Player Controller yapısının dokunmatik girişi desteklemesi gerekiyor.

Uygulama penceresinin küçültülmesi halinde giriş akışı etkilenebileceğinden, belgeler isteğe bağlı -RenderOffScreen parametresini de anlatıyor. Bu seçenek uygulamayı görünür pencere olmadan çalıştırıyor. Ancak kendi sunum düzeninde gerekli olup olmadığını önce yerel testte değerlendirmek uygun olur.

2. Sunucu bileşenlerini ve ağı kurun

1. Pixel Streaming’in web arayüzü ve sunucu bileşenleri, Unreal Engine kurulumundan ayrı olarak barındırılan Pixel Streaming Infrastructure deposundan ediniliyor. Resmi belgeler depoyu doğrudan kullanma veya motorun WebServers klasöründeki get_ps_servers betiğiyle ilgili altyapı dalını alma yollarını açıklıyor. Dal seçiminde belge, UEX.Y biçimindeki örnek içinde 5.7 değerini gösteriyor; bu örnek her kurulum için sürüm uyumluluğu garantisi olarak yorumlanmamalı.

2. Yerel ağ bağlantısı için 80 ve 8888 numaralı portların açık olduğundan emin olun. Windows örneğinde önce PowerShell yönetici olarak açılıyor ve sunucu bağımlılıkları hazırlanıyor:

SignallingWebServer\platform_scripts\cmd\setup.bat

Ardından Signalling Server başlatılıyor:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

Belgelerde Linux ve Mac için aynı işlemin SignallingWebServer\platform_scripts\bash klasöründeki betiklerle yapıldığı belirtiliyor. Başarılı başlangıçta konsolda 80 ve 8888 portlarında bağlantı dinlendiğini gösteren satırlar görülmeli. Bilgisayarda başka web sunucuları çalışıyorsa başlangıçta bunları durdurmak da öneriliyor.

3. Yayını başlatın ve tarayıcıdan bağlanın

1. Sunucular hazır olduktan sonra paketlenmiş Unreal Engine uygulamasını, bağlantı parametresiyle açın. Belgelerdeki örnek komut şöyledir:

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

Sunucu konsolunda “Streamer connected” bildiriminin görülmesi, uygulamanın Signalling Server’a bağlandığını gösterir. Ardından aynı bilgisayarda desteklenen bir tarayıcı açıp http://127.0.0.1 adresine gidin. Sayfada bağlantıyı ve oynatmayı başlatın. Aynı ağdaki başka bir cihazda ise yayın yapan bilgisayarın IP adresi kullanılmalı.

Varsayılan oynatıcı sayfası klavye, fare ve dokunmatik girişleri uygulamaya iletebilir. Birden fazla cihaz bağlandığında hepsi aynı sahne görünümünü alır; varsayılan ayarda tüm bağlı kullanıcılar giriş gönderebilir. Sunum sırasında kontrolün kimde olacağı önemliyse, web oynatıcı sayfasının özelleştirilmesi ve giriş yetkilerinin düzenlenmesi değerlendirilebilir.

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

Pixel Streaming, sahnenin çalıştığı bilgisayara erişimi olmayan ekip üyelerine veya sunum katılımcılarına tarayıcıdan canlı görüntü sunmak için değerlendirilebilir. İç mimarlık ve mimari görselleştirme ekipleri, aynı ağdaki masaüstü ve mobil cihazlarla bir sahneyi gösterebilir; tarayıcı tarafında ek bir uygulama kurulumu gerekmez. Bu yöntem, sahneyi her izleyici cihazında ayrı ayrı çalıştırmak yerine tek bir çalışan Unreal Engine örneğinden yayın yapar.

Bununla birlikte, görüntünün kalitesi ve akıcılığı yalnızca tarayıcıya bağlı değildir: uygulama yayın yapan bilgisayarda çalışır ve eklentinin video kodlaması belirli GPU donanımlarına bağlıdır. Kaynak belgeler donanım modellerini veya performans değerlerini vermediği için proje öncesinde hedef bilgisayarın uyumluluğunu kontrol etmek gerekir. Yerel ağdan internete açılacak bir sunumda ağ yapılandırması da ayrıca ele alınmalı; farklı ağlardan erişim için STUN/TURN ayarları gerekebilir.

Web oynatıcı sayfası özelleştirilebildiğinden, proje sunumuna özel HTML5 arayüzü veya giriş kontrolü tasarlanabilir. Ancak böyle bir düzenleme, varsayılan yerel ağ kurulumunun ötesine geçer. Sunucu dosyalarında değişiklik yapılacaksa bunları paket klasöründeki kopyalar yerine orijinal konumda yapmak önemlidir; paket klasöründeki değişiklikler yeni paketleme sırasında üzerine yazılabilir.

Sık yapılan hatalar

• Eklentiyi etkinleştirdikten sonra editörü yeniden başlatmamak veya uygulamayı paketlenmiş ya da Standalone Game biçiminde çalıştırmamak.

• 80 ve 8888 portlarının kapalı olması ya da bilgisayardaki başka bir web sunucusunun aynı kurulumu etkilemesi.

• Paketlenmiş uygulamayı -PixelStreamingURL parametresi olmadan başlatmak.

• İlk denemeyi farklı ağlar üzerinden yapmak. Önce aynı bilgisayarda 127.0.0.1 ile, ardından yerel ağdaki başka bir cihazla test etmek daha kolay sorun giderme sağlar.

• İnternet üzerinden bağlantıyı yerel ağdaki bağlantıyla aynı kabul etmek. Farklı ağlarda STUN/TURN veya başka ağ yapılandırmaları gerekebilir.