Unreal Engine Pixel Streaming einrichten: Projekte im Browser bereitstellen

Was erfahren Sie in dieser Anleitung?

Unreal Engine Pixel Streaming überträgt Bild und Ton einer Anwendung an ein entferntes Gerät und ermöglicht zugleich Eingaben von diesem Gerät. So lässt sich ein Unreal-Engine-Projekt in einer Webseite anzeigen; Nutzer können über Desktop- oder Mobilgeräte per Tastatur, Maus oder Touch mit der Anwendung interagieren. Auf Browserseite ist keine zusätzliche Softwareinstallation erforderlich.

Diese Anleitung beschreibt, wie Sie das Projekt für das Streaming vorbereiten, die Serverkomponenten starten und über einen Browser im selben lokalen Netzwerk eine Verbindung herstellen. Epic Games’ Einsteigerleitfaden verwendet Windows als Beispiel und weist darauf hin, dass sich die Serverskripte für Linux und Mac in einem anderen Ordner befinden.

Voraussetzungen und Vorbereitung

Das Pixel-Streaming-Plugin kann Videos auf Computern mit Windows, Linux oder Mac und bestimmten unterstützten GPU-Konfigurationen kodieren. Der Quellleitfaden verweist für Einzelheiten zu kompatiblen Hardwaretypen auf das Dokument Pixel Streaming Reference. Da hier keine konkreten GPU-Modelle aufgeführt sind, sollte die Kompatibilität vor dem Streaming gesondert geprüft werden.

Für die Grundeinrichtung im lokalen Netzwerk müssen die Ports 80 und 8888 für die Kommunikation geöffnet sein. Wenn auf dem Computer andere Webserver laufen, empfiehlt der Leitfaden, diese vor der Einrichtung zu stoppen. Für Verbindungen über das Internet oder zwischen verschiedenen Netzwerken kann eine zusätzliche Netzwerkkonfiguration erforderlich sein. Ein erster Test auf demselben Computer mit der Adresse localhost oder 127.0.0.1 ist ein unkomplizierter Einstieg.

Der Leitfaden erwähnt keine Anforderungen an ein Benutzerkonto. Die Serverinfrastruktur erhalten Sie über das Pixel-Streaming-Infrastruktur-Repository von Epic Games auf GitHub. Das Projekt muss als paketierte Anwendung oder über die Option Standalone Game im Unreal Editor gestartet werden; die Verwendung des Plugins wird anhand dieser beiden Startmethoden erläutert.

Einrichtung: Projekt und Server vorbereiten

1. Öffnen Sie das Projekt im Unreal Editor. Wählen Sie im Hauptmenü Edit > Plugins; aktivieren Sie in der Kategorie Graphics das Plugin Pixel Streaming oder Pixel Streaming 2 und starten Sie das Projekt neu. Wenn ein Projekt eine Figur enthält und mobile Touch-Steuerung benötigt wird, können Sie unter Edit > Project Settings in der Kategorie Engine > Input die Option Always Show Touch Interface verwenden. Diese Einstellung ist nicht zwingend erforderlich; auch die Player-Controller-Komponente der Figur muss Touch-Eingaben unterstützen.

2. Legen Sie den Startparameter für das Projekt fest. Fügen Sie unter Edit > Editor Preferences... in der Kategorie Level Editor > Play im Feld Additional Launch Parameters die lokale Verbindungsadresse hinzu:

-PixelStreamingURL=ws://127.0.0.1:8888

Mit diesem Parameter wird die Adresse angegeben, unter der sich die Anwendung mit dem Pixel-Streaming-Server verbindet. Wenn Sie das Projekt für Windows paketieren, wählen Sie im Menü des Unreal Editors Files > Package Project > Windows (64-bit) und legen Sie den Ausgabeordner fest. Bei jedem Start der Anwendung muss derselbe Parameter verwendet werden. Der Leitfaden erläutert auch die Möglichkeit, den Parameter dem Feld Target der Startverknüpfung hinzuzufügen.

1. Beschaffen Sie die Pixel-Streaming-Serverkomponenten. Laut Leitfaden können Sie die Infrastruktur direkt aus dem GitHub-Repository beziehen oder in Ihrem bevorzugten Terminal den folgenden Befehl verwenden. Anstelle von UEX.Y wird der gewünschte Branch eingesetzt; als Beispiel nennt das Dokument 5.7.

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

Alternativ können Sie zum Ordner \Engine\Plugins\Media\PixelStreaming\Resources\WebServers in Ihrer Unreal-Engine-Installation wechseln und das Skript get_ps_servers ausführen, das unter Windows die Erweiterung .bat und unter Linux oder Mac die Erweiterung .sh hat. Dadurch wird der entsprechende Infrastruktur-Branch in den Ordner geladen.

1. Führen Sie im Windows-Beispiel das Installationsskript im Ordner SignallingWebServer der heruntergeladenen Infrastruktur in einer als Administrator gestarteten PowerShell aus:

SignallingWebServer\platform_scripts\cmd\setup.bat

Führen Sie nach Abschluss der Installation das Startskript in derselben Ordnerstruktur aus:

SignallingWebServer\platform_scripts\cmd\start_with_stun.bat

Für Linux und Mac verweist der Leitfaden auf die Skripte im Ordner SignallingWebServer\platform_scripts\bash. Sobald der Server bereit ist, sollten in der Konsole Meldungen zum Lauschen auf der Publisher-Verbindung an Port 8888, der Player-Verbindung an Port 80 sowie zum HTTP-Dienst erscheinen.

Anwendung starten und im Browser verbinden

Starten Sie bei laufenden Servern die paketierte Anwendung mit dem Parameter für die Pixel-Streaming-Verbindungsadresse. Beispielbefehl:

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

MyPixelStreamingApplication.exe ist ein beispielhafter Dateiname; verwenden Sie den Namen Ihrer eigenen paketierten Anwendung. Sobald sich die Anwendung mit dem Server verbunden hat, sollte in der Serverkonsole die Meldung Streamer connected erscheinen.

Öffnen Sie auf demselben Computer einen unterstützten Browser und rufen Sie http://127.0.0.1 auf. Epic nennt Google Chrome und Mozilla Firefox als geeignete Optionen. Klicken Sie auf die Seite und anschließend auf die Wiedergabeschaltfläche, um den Stream zu starten. Die standardmäßige Player-Seite kann Tastatur-, Maus- und Touch-Eingaben an die Unreal-Engine-Anwendung weiterleiten.

Um eine Verbindung von einem anderen Computer oder Mobilgerät im selben lokalen Netzwerk herzustellen, geben Sie im Browser die IP-Adresse des streamenden Computers ein. Bei dieser Methode sehen alle verbundenen Geräte dieselbe Szenenansicht derselben Unreal-Engine-Instanz; in der Standardeinstellung werden auch Eingaben von den Geräten an dieselbe Anwendung weitergeleitet. Für Verbindungen über das Internet oder aus anderen Subnetzen kann eine weitergehende Netzwerkkonfiguration erforderlich sein. Der Quellleitfaden erwähnt für solche Verbindungen die Einrichtung von STUN/TURN-Servern.

Häufige Probleme und Einsatz im Architektur-Workflow

Wenn keine Verbindung zustande kommt, prüfen Sie zunächst, ob die Serverkomponenten laufen, die Anwendung mit dem korrekten Parameter PixelStreamingURL gestartet wurde und die Ports 80 und 8888 erreichbar sind. Auch ein anderer Webserver auf demselben Computer kann die Grundeinrichtung beeinträchtigen. Wird der Eingabestream unterbrochen, wenn das Anwendungsfenster minimiert wird, weist der Leitfaden auf den Parameter -RenderOffScreen hin. Mit ihm kann die Anwendung ohne sichtbares Fenster ausgeführt werden.

In Architektur-, Innenarchitektur- und Archviz-Workflows kann diese Einrichtung für Teams nützlich sein, die dieselbe Szene auf mehreren Computern oder Mobilgeräten zeigen und interaktive Präsentationen im Browser durchführen möchten. Das Rendering erfolgt auf dem Hostcomputer, auf dem die Anwendung läuft; die verbundenen Geräte erhalten dieselbe Ansicht. Deshalb sind die GPU-Kompatibilität und die Netzwerkkonfiguration des Hostcomputers wichtig. Laut Leitfaden lassen sich Einstellungen wie Auflösung, Bildschirmgröße, IP-Adressen und Ports konfigurieren. Die Quellen erläutern weder Lizenz- und Kostenbedingungen des Produkts noch die Kompatibilität mit einer bestimmten Archviz-Software.

Nächste Schritte

Nachdem das grundlegende Streaming funktioniert, lässt sich die Player-Webseite an das Projekt anpassen. Auch die Kontrolle der Nutzer, die Eingaben senden dürfen, oder das Hinzufügen von HTML5-Benutzeroberflächenelementen zur Seite ist möglich. Epic stellt eine Anleitung zur Streaming-Optimierung bereit, die Einstellungen für Bildqualität, Latenz und Verbindungsstabilität behandelt. Für Anforderungen wie mehrere Server, verschiedene Clients oder die Bereitstellung über das Internet können Sie den Hosting and Networking Guide konsultieren.

Wenn Sie Dateien der Infrastruktur ändern, empfiehlt der Leitfaden, den ursprünglichen Installationspfad statt der Kopie im Paketordner zu bearbeiten. Änderungen an Dateien im Paketordner können bei der nächsten Paketierung überschrieben werden. Schließen Sie zunächst die Einrichtung im lokalen Netzwerk ab und prüfen Sie die Projektanforderungen sowie die vorgesehenen Netzwerkeinstellungen, bevor Sie komplexere Verbindungsszenarien angehen.

Quelle und Lizenz

Diese Anleitung wurde auf Grundlage der Informationen aus dem Unreal-Engine-Pixel-Streaming-Dokument und dem Pixel-Streaming-Einsteigerleitfaden von Epic Games ins Türkische übertragen. Beide Quellen werden unter einer freien Lizenz bereitgestellt.