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

Kaynak: https://3dsinifi.com/haber/unreal-engine-pixel-streaming-kurulumu-projeyi-tarayiciya-2 · Kategori: Eğitimler · Yayın: 8 Kasım 2026

> Unreal Engine Pixel Streaming, projede üretilen görüntü ve sesi tarayıcıya aktararak masaüstü ve mobil cihazlardan etkileşim sağlar. Bu rehber, yerel ağda temel kurulumu ve bağlantıyı adım adım anlatıyor.

## Kısaca
- Pixel Streaming, paketlenmiş Unreal Engine uygulamasını veya Standalone Game olarak başlatılan projeyi tarayıcı üzerinden yayınlayabilir.
- Başlangıç kurulumu için yerel ağda 80 ve 8888 numaralı bağlantı noktalarının açık olması gerekir.
- Yayın için uygulamanın yanında Pixel Streaming altyapısındaki web servisleri de çalıştırılmalıdır.
- Bağlanan cihazlar aynı sahneyi görür; varsayılan oyuncu sayfası klavye, fare ve dokunmatik girişlerini iletebilir.

## 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:

```text
-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.

3. 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.

```bash
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.

4. 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:

```powershell
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:

```powershell
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:

```text
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.

## Pro ipucu
Önce aynı bilgisayarda `127.0.0.1` adresiyle bağlantıyı doğrulayın ve 80 ile 8888 numaralı bağlantı noktalarının açık olduğundan emin olun.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ofisleri ve görselleştirme ekipleri için Pixel Streaming’in pratik yanı, sahneyi her izleyici cihazına ayrı ayrı kurmadan tarayıcı üzerinden sunabilmesi. Aynı uygulamanın birden fazla cihazda görülmesi, etkileşimli değerlendirme ve sunum süreçlerinde işe yarayabilir. Ancak render yükü istemcilere dağıtılmıyor: uygulama ana bilgisayarda çalışıyor ve uyumlu GPU donanımı gerektiriyor.

Bu nedenle yatırım kararı öncesinde mevcut iş istasyonunun destek koşulları ve ağ altyapısı sınanmalı. Kaynaklar serbest lisanslı olsa da ürünün lisans ve ücret koşullarına ilişkin bilgi vermiyor. Farklı ağlardan erişim için ek yapılandırma gerekebileceği de belirtiliyor. Önce yerel ağda küçük bir deneme yapmak, bağlantı gereksinimlerini gerçek proje üzerinden değerlendirmek için temkinli bir başlangıç olur.

## Kaynaklar
- [dev.epicgames.com](https://dev.epicgames.com/documentation/en-us/unreal-engine/pixel-streaming-in-unreal-engine) (özet)
- [dev.epicgames.com](https://dev.epicgames.com/documentation/en-us/unreal-engine/getting-started-with-pixel-streaming-in-unreal-engine) (özet)

_Yapay zekâ ile yazıldı, kaynaklarla doğrulandı. © 3dsınıfı_