Streaming dans UnrealStreaming in Unreal

Le streaming à partir d’un PC vers HoloLens offre deux avantages majeurs :Streaming from a PC to HoloLens provides two major advantages:

  • Il permet à votre application de réalité mixte de tirer parti de la puissance de calcul de vos PC.It lets your mixed reality app take advantage of your PCs computational power.
  • Il permet d’accélérer l’itération du développement.It helps speed up development iteration time.

Pour commencer, vous devez télécharger Holographic Remoting Player sur votre appareil HoloLens.To get started, you'll need to download the Holographic Remoting Player to your HoloLens device. Holographic Remoting Player permet à votre application de diffuser directement sur le lecteur de communication à distance sur votre HoloLens à partir des sources suivantes :The Holographic Remoting Player lets your app to stream directly to the remoting player on your HoloLens from the following sources:

  • L’éditeur Unreal EngineThe Unreal Engine editor
  • Un exécutable Windows empaquetéA packaged Windows executable

Lors du streaming, vous avez accès à presque toutes les mêmes fonctionnalités HoloLens que lors de l’exécution d’une application sur un appareil.When streaming, you have access to almost all of the same HoloLens capabilities as you would when running an application on a device. Cela comprend notamment le suivi de la main si vous êtes sur un HoloLens 2, le mappage spatial et les ancres spatiales, mais pas les fonctionnalités mentionnées dans cette liste.This includes hand joint tracking if you're on a HoloLens 2, spatial mapping, and spatial anchors, but leaves out the features on this list.

Notes

  • La qualité de streaming dépend fortement de la puissance de votre réseau Wi-Fi.Streaming quality is highly dependent on the strength of your wifi network.
  • Toutes les fonctionnalités sont automatiquement activées pour le lecteur de communication à distance holographique.All capabilities are automatically enabled for the holographic remoting player. Si vous trouvez une fonctionnalité qui nécessite l’autorisation de l’utilisateur (par exemple le suivi oculaire) à utiliser sur le streaming mais pas lors de l’exécution sur l’appareil, vérifiez que vous avez activé les fonctionnalités appropriées dans les paramètres de votre projet.If you find a capability that requires user permission (ex: eye tracking) to be working over streaming but not when running on device, check to ensure you've enabled the proper capabilities under your project settings.

Limitations de streamingStreaming limitations

Les maillages de la main, la caméra HoloLens et le clavier système ne sont pas disponibles en streaming.Hand meshes, the HoloLens camera, and the system keyboard are unavailable over streaming. Notez que les entrées vocales pour les applications envoyées en streaming peuvent être obtenues via le microphone du PC à partir duquel vous procédez au streaming.Note that speech input for streamed apps can be acquired via the microphone of the PC you are streaming from.

OpenXROpenXR

Unreal 4.26 exécuté sur OpenXR prend en charge le streaming vers les versions 2.4.0+ du lecteur Holographic Remoting Player.Unreal 4.26 running on OpenXR supports streaming to versions 2.4.0+ of the Holographic Remoting Player. Le streaming OpenXR dans 2.4.0 ne prend pas en charge le mappage spatial ni les ancres spatiales.OpenXR streaming in 2.4.0 is missing support for spatial mapping and spatial anchors.

Prise en charge des appareilsDevice support

SourceSource HoloLens première générationHoloLens first Gen HoloLens 2HoloLens 2 Casques immersifsImmersive Headsets
Éditeur UnrealUnreal editor ✔️✔️ ✔️✔️
Package WindowsWindows package ✔️✔️

Streaming à partir de l’éditeur UnrealStreaming from the Unreal editor

En tant que développeur, vous constaterez que le streaming de l’éditeur Unreal vers votre appareil HoloLens offre de considérables avantages lors des tests ; en effet, vous n’avez plus besoin d’attendre que votre application soit générée et déployée avant d’essayer vos mises à jour.As a developer, you'll find that streaming from the Unreal editor to your HoloLens device provides significant benefits when testing, namely that you no longer have to wait for your app to build and deploy before trying out your updates.

Vous trouverez des instructions détaillées pour le streaming à partir de l’éditeur Unreal dans notre série de tutoriels.You can find detailed instructions for streaming from the Unreal editor in our tutorial series.

Streaming à partir d’un exécutable Windows empaquetéStreaming from a packaged Windows executable

Dans Unreal 4.25.1 et versions ultérieures, vous pouvez diffuser votre application sur un appareil HoloLens 2 à partir d’un fichier exécutable Windows empaqueté :In Unreal 4.25.1 and onwards, you can stream your app to a HoloLens 2 device from a packaged Windows executable:

  1. Accédez à File > Package Project > Windows dans le menu de l’éditeur.Go to File > Package Project > Windows in the editor menu.

    • Choisissez un emplacement où enregistrer votre package, puis sélectionnez Select Folder (Sélectionner un dossier).Choose a location to save your package and select Select Folder.
  2. Une fois la génération du package terminée, ouvrez Holographic Remoting Player sur votre HoloLens 2 et prenez note de l’adresse IP.Once the package has finished building, open the Holographic Remoting Player on your HoloLens 2 and make note of the IP Address.

  3. Laissez Holographic Remoting Player ouvert et utilisez l’invite de ligne de commande pour :Leave the Holographic Remoting Player open and use the command line prompt to:

    • Basculer vers le répertoire local où vous avez enregistré votre package.cd into the local directory where you saved your package.
    • Entrez la commande suivante : <App Name>.exe -vr -HoloLensRemoting=<IP Address>Enter the following command: <App Name>.exe -vr -HoloLensRemoting=<IP Address>

Notes

Le nom de l’application dans les paramètres de votre projet doit être utilisé automatiquement pour créer le package Windows.The application name in your project settings should be automatically used to create the Windows package. Si les noms diffèrent pour une raison ou une autre, utilisez le nom de l’exécutable Windows à l’invite de commandes.If these are different for some reason, use the Windows executable name in the command prompt.

Appuyez sur Entrée ; le streaming de votre application commence.Hit enter and watch your application start streaming!

Options de ligne de commandeCommand line options

Vous trouverez dans le tableau ci-dessous d’autres options de ligne de commande pour le streaming à partir de chaque plateforme dans Unreal Engine 4.26+.Additional command line options for streaming from each platform in Unreal Engine 4.26+ can be found in the table below.

OptionOption DescriptionDescription
-HoloLensRemoting=<IP address:port> Prend l’adresse IP (et le port facultatif) de l’appareil HoloLens 2 auquel se connecter.Takes the IP address (and optional port) of the HoloLens 2 device to connect to. Si aucun port n’est fourni, la valeur par défaut est 8265.If no port is provided, default to 8265.
-RemotingBitrate=<bitrate> (facultative) Valeur par défaut 8000.(optional) Default 8000. Taux de transfert réseau maximal (Ko/s).Max network transfer rate (kb/s).
-HoloLensRemotingListen (facultative) Démarre un serveur d’écoute.(optional) Start a listen server
-HoloLensRemotingListenPort=<port> (facultative) Prend le port d’écoute.(optional) Takes the port to listen on. Utilisée pour la connexion à un PC ou à une machine virtuelle à partir d’un appareil HoloLens.Used for connecting to a PC or VM from a HoloLens device.
-HoloLens1Remoting=<IP address> (dépréciée dans 4.26) Prend l’adresse IP de l’appareil HoloLens 1 auquel se connecter.(deprecated in 4.26) Takes the IP address of the HoloLens 1 device to connect to

Voir aussiSee also