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

Kaynak: https://3dsinifi.com/haber/unreal-engine-pixel-streaming-kurulumu-yerel-agda-mimari · Kategori: İpuçları · Yayın: 8 Ekim 2026

> Unreal Engine Pixel Streaming, projelerin görüntü ve sesini tarayıcıya aktarırken klavye, fare ve dokunmatik girişe de izin veriyor. Bu rehber, resmi belgelerdeki yerel ağ kurulumunu mimari sunum akışına uyarlıyor.

## Kısaca
- Pixel Streaming, paketlenmiş bir Unreal Engine uygulamasının görüntü ve sesini tarayıcıya aktarır; kullanıcılar akışla etkileşime de girebilir.
- Kurulum için Pixel Streaming eklentisi, uygulamaya bağlanan sunucular ve erişime açık 80 ile 8888 numaralı ağ portları gerekir.
- Aynı ağdaki birden fazla cihaz, tek bir Unreal Engine örneğinden yayınlanan aynı sahneyi görüntüleyebilir.
- İnternet veya farklı ağlar üzerinden erişim, STUN/TURN yapılandırması gibi ek ağ ayarları gerektirebilir.

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.

2. Projenin çalıştırılma biçimini seçin. Pixel Streaming, paketlenmiş uygulamayla veya Unreal Editor içinden Standalone Game seçeneğiyle kullanılabiliyor. Resmi başlangıç adımları Windows için paketleme örneği veriyor; Linux ve Mac’te ise sunucu başlatma betikleri için farklı klasör yolları belirtiliyor.

3. Editör üzerinden başlatma kullanılacaksa Editor Preferences › Level Editor › Play bölümündeki Additional Launch Parameters alanına bağlantı parametresini ekleyin. Paketlenmiş uygulama açılırken de aynı parametre gerekir; belgeler bunun için bir kısayol oluşturulmasını öneriyor.

```text
-PixelStreamingURL=ws://127.0.0.1:8888
```

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

5. 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ı.

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

```powershell
SignallingWebServer\platform_scripts\cmd\setup.bat
```

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

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

| Ayar | Önerilen değer | Etkisi |
|---|---|---|
| Yerel ağ portları | 80 ve 8888 | Tarayıcı ile yayın uygulamasının haberleşmesine yardımcı olur. |
| Yerel makine adresi | `127.0.0.1` veya `localhost` | İlk bağlantı denemesini aynı bilgisayarda yapmayı sağlar. |
| Yayın bağlantı parametresi | `ws://127.0.0.1:8888` | Unreal Engine uygulamasını yerel Signalling Server’a bağlar. |

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

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

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

## Pro ipucu
Önce aynı bilgisayarda `http://127.0.0.1` üzerinden bağlantıyı doğrulayın; ardından yayın bilgisayarının IP adresiyle ikinci bir cihazdan deneyin.

## 3dsınıfı yorumu
Türkiye’deki mimarlık ve görselleştirme ofisleri için Pixel Streaming’in pratik yanı, katılımcıların sahneyi tarayıcıdan izleyebilmesi ve yayın bilgisayarındaki tek Unreal Engine örneğinin paylaşılması. Özellikle yerel ağdaki sunumlarda, her izleyici cihazına ayrı kurulum yapma ihtiyacını azaltabilir.

Yatırım veya canlı sunum kararı öncesinde yayın bilgisayarının GPU uyumluluğu, ağ portları ve kullanılacak eklenti seçeneği test edilmeli. Belgeler donanım gereksinimlerini ayrıntılandırmadığından uyumluluk varsayılmamalı. İnternetten erişim gerekiyorsa STUN/TURN ve ağ yapılandırması ayrıca planlanmalı; ilk deneme yerel ağda yapılmalı.

## 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ı_