Streaming dans Unreal

  • Article
  • S’applique à:
    HoloLens, HoloLens 2

Le « streaming » est parfois appelé « communication à distance holographique ». Pour plus d’informations, consultez Vue d’ensemble de la communication à distance holographique.

Le streaming à partir d’un PC vers HoloLens offre deux avantages majeurs :

  • Il permet à votre application de réalité mixte de tirer parti de la puissance de calcul de vos PC.
  • Il permet d’accélérer l’itération du développement.

Pour commencer, vous devez télécharger Holographic Remoting Player sur votre appareil HoloLens. Holographic Remoting Player permet à votre application de diffuser directement sur le lecteur de communication à distance sur votre HoloLens à partir des sources suivantes :

  • L’éditeur Unreal Engine
  • Un exécutable Windows empaqueté

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

Remarque

  • La qualité de streaming dépend fortement de la puissance de votre réseau Wi-Fi.
  • Toutes les fonctionnalités sont automatiquement activées pour le lecteur de communication à distance holographique. 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.

Limitations de streaming

Les maillages de la main, la caméra HoloLens et le clavier système ne sont pas disponibles en 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.

OpenXR

Unreal 4.26 exécuté sur OpenXR prend en charge le streaming vers les versions 2.4.0+ du lecteur Holographic Remoting Player. Pour obtenir la prise en charge des fonctionnalités les plus récentes avec Holographic Remoting, consultez l’historique des versions et les pages de résolution des problèmes.

Prise en charge des appareils

Source HoloLens première génération HoloLens 2 Casques immersifs
Éditeur Unreal ✔️ ✔️ ✔️
Package Windows ❌ ✔️ ✔️

Notes

À compter de Holographic Remoting version 2.2.0, le streaming est également disponible pour les PC Windows exécutant Windows Mixed Reality.

Streaming à partir de l’éditeur Unreal

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.

Vous trouverez des instructions détaillées pour le streaming à partir de l’éditeur Unreal dans notre série de tutoriels.

Streaming à partir d’un exécutable Windows empaqueté

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

  1. Accédez à File > Package Project > Windows dans le menu de l’éditeur.

    • Choisissez un emplacement où enregistrer votre package, puis sélectionnez Select Folder (Sélectionner un dossier).

  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.

  3. Laissez Holographic Remoting Player ouvert et utilisez l’invite de ligne de commande pour :

    • Basculer vers le répertoire local où vous avez enregistré votre package.
    • Entrez la commande suivante : <App Name>.exe -vr -HoloLensRemoting=<IP Address>

Remarque

Le nom de l’application dans les paramètres de votre projet doit être utilisé automatiquement pour créer le package Windows. Si les noms diffèrent pour une raison ou une autre, utilisez le nom de l’exécutable Windows à l’invite de commandes.

Remarque

Si le suivi oculaire ne fonctionne pas lors du streaming à partir d’un fichier exécutable empaqueté, désactivez tous les autres plug-ins avec suivi oculaire pris en charge par le PC (par exemple Magic Leap) ou exécutez l’application à partir de la ligne de commande avec l’argument de suivi oculaire approprié (consultez Options de ligne de commande).

Appuyez sur Entrée ; le streaming de votre application commence.

Options de ligne de commande

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

Option Description
-HoloLensRemoting=<IP address:port> Prend l’adresse IP (et le port facultatif) de l’appareil HoloLens 2 auquel se connecter. Si aucun port n’est fourni, la valeur par défaut est 8265.
-RemotingBitrate=<bitrate> (facultative) Valeur par défaut 8000. Taux de transfert réseau maximal (Ko/s).
-HoloLensRemotingListen (facultative) Démarre un serveur d’écoute.
-HoloLensRemotingListenPort=<port> (facultative) Prend le port d’écoute. Utilisée pour la connexion à un PC ou à une machine virtuelle à partir d’un appareil HoloLens.
-HoloLens1Remoting=<IP address> (dépréciée dans 4.26) Prend l’adresse IP de l’appareil HoloLens 1 auquel se connecter.
-eyetracking=WindowsMixedRealityEyeTracker (facultatif) Utilise le suivi oculaire Windows Mixed Reality

Voir aussi