Streaming in Unreal
"Streaming" wird manchmal als "Holographic Remoting" bezeichnet. Weitere Informationen finden Sie unter Übersicht über Holographic Remoting.
Das Streamen von einem PC zu HoloLens bietet hauptsächlich zwei Vorteile:
- Es ermöglicht Ihrer Mixed Reality-App die Nutzung der Rechenleistung Ihres PCs.
- Es verkürzt die Iterationszeiten bei der Entwicklung.
Für den Einstieg müssen Sie den Holographic Remoting Player auf Ihr HoloLens-Gerät herunterladen. Durch den Holographic Remoting-Player kann Ihre App direkt aus den folgenden Quellen zum Remoteplayer auf Ihrer HoloLens streamen:
- dem Unreal Engine-Editor
- einer verpackten Windows-Programmdatei
Beim Streamen haben Sie Zugriff auf nahezu alle der HoloLens-Funktionen, die Ihnen auch beim Ausführen einer Anwendung auf einem Gerät zur Verfügung stehen. Dies schließt Handgelenksnachverfolgung (bei einer HoloLens 2), Räumliche Abbildung und Raumanker (Spatial Anchors) ein, die Funktionen in dieser Liste sind jedoch ausgenommen.
Hinweis
- Die Streamingqualität hängt stark von der Feldstärke Ihres WLAN-Netzwerks ab.
- Alle Funktionen werden automatisch für den Holographic Remoting Player aktiviert. Wenn Sie auf eine Funktion stoßen, die per Streaming nur mit einer Benutzerberechtigung arbeitet, diese bei Ausführung auf dem Gerät aber nicht benötigt (Beispiel: Eye Tracking), vergewissern Sie sich in den Projekteinstellungen, dass Sie die richtigen Funktionen aktiviert haben.
Streamingeinschränkungen
Hand-Meshes, die HoloLens-Kamera und die Systemtastatur sind per Streaming nicht verfügbar. Beachten Sie, dass Spracheingaben für gestreamte Apps über das Mikrofon des PCs abgerufen werden können, von dem aus Sie streamen.
OpenXR
Unreal 4.26 unterstützt bei Ausführung in OpenXR das Streaming auf die Versionen 2.4.0+ des Holographic Remoting-Players. Informationen zur Unterstützung der neuesten Features bei Holographic Remoting finden Sie im Versionsverlauf und den Seiten zur Problembehandlung.
Geräteunterstützung
Quelle | HoloLens (1. Generation) | HoloLens 2 | Immersive Headsets |
Unreal-Editor | ✔️ | ✔️ | ✔️ |
Windows-Paket | ❌ | ✔️ | ✔️ |
Hinweis
Ab Holographic Remoting Version 2.2.0 ist Streaming auch für Windows-PCs verfügbar, auf denen Windows Mixed Reality ausgeführt wird.
Streaming vom Unreal-Editor
Als Entwickler werden Sie feststellen, dass das Streaming vom Unreal-Editor zu Ihrem HoloLens-Gerät beim Testen signifikante Vorteile bietet, nämlich dass Sie nicht mehr auf das Erstellen und Bereitstellen Ihrer App warten müssen, bevor Sie Ihre Updates ausprobieren.
Im unserer Tutorialreihe finden Sie ausführliche Anweisungen zum Streamen aus dem Unreal-Editor.
Streamen von einer verpackten Windows-Programmdatei
Seit Unreal 4.25.1 können Sie Ihre App aus einer verpackten Windows-Programmdatei zu einem HoloLens 2-Gerät streamen:
Wechseln Sie im Editormenü zu Datei > Paketprojekt > Windows.
- Wählen Sie einen Speicherort aus, um Ihr Paket zu speichern, und wählen Sie Ordner auswählen aus.
Nachdem das Erstellen des Pakets abgeschlossen wurde, öffnen Sie den Holographic Remoting Player auf Ihrer HoloLens 2, und notieren Sie die IP-Adresse.
Lassen Sie den Holographic Remoting Player geöffnet, und verwenden Sie die Eingabeaufforderung zum:
- Wechseln in das lokale Verzeichnis, in dem Sie das Paket gespeichert haben.
- Geben Sie den folgenden Befehl ein:
<App Name>.exe -vr -HoloLensRemoting=<IP Address>
Hinweis
Der Anwendungsname in Ihren Projekteinstellungen sollte automatisch zum Erstellen des Windows-Pakets verwendet werden. Wenn diese aus irgendeinem Grund verschieden sind, verwenden Sie den Namen der Windows-Programmdatei in der Eingabeaufforderung.
Hinweis
Wenn das Eyetracking (Blickverfolgung) beim Streaming aus der ausführbaren Datei eines Pakets nicht funktioniert, deaktivieren Sie entweder alle anderen Plug-Ins mit PC-unterstützten Eyetrackern (Beispiel: Magic Leap), oder führen Sie die Anwendung von der Befehlszeile aus mit dem entsprechenden Eyetracking-Argument aus (siehe Befehlszeilenoptionen).
Drücken Sie die EINGABETASTE, und sehen Sie, wie das Streamen Ihrer Anwendung beginnt!
Befehlszeilenoptionen
Zusätzliche Befehlszeilenoptionen für das Streaming von jeder Plattform in Unreal Engine 4.26+ finden Sie in der Tabelle unten.
Option | Beschreibung |
---|---|
-HoloLensRemoting=<IP address:port> |
Nimmt die IP-Adresse (und optional den Port) des HoloLens 2-Geräts an, mit dem eine Verbindung hergestellt werden soll. Wenn kein Port angegeben wird, wird standardmäßig 8265 verwendet. |
-RemotingBitrate=<bitrate> |
(optional) Standardwert 8000. Maximale Netzwerk-Übertragungsrate (KB/s). |
-HoloLensRemotingListen |
(optional) Startet einen Lauschserver |
-HoloLensRemotingListenPort=<port> |
(optional) Nimmt den Port an, an dem gelauscht werden soll. Wird zum Herstellen der Verbindung mit einem PC oder einer VM von einem HoloLens-Gerät verwendet. |
-HoloLens1Remoting=<IP address> |
(in 4.26 veraltet) Nimmt die IP-Adresse des HoloLens 1-Geräts an, mit dem die Verbindung erfolgen soll |
-eyetracking=WindowsMixedRealityEyeTracker |
(optional) Verwenden des Windows Mixed Reality-Eyetrackers |