Holographic Remoting Player
Holographic Remoting for HoloLens 2 is a major version change. Remote applications for HoloLens (1st gen) must use NuGet package version 1.x.x and remote applications for HoloLens 2 must use 2.x.x. This implies that remote applications written for HoloLens 2 are not compatible with HoloLens (1st gen) and vice versa.
The Holographic Remoting Player is a companion app that connects to PC apps and games that support Holographic Remoting. Holographic Remoting streams holographic content from a PC to your Microsoft HoloLens in real-time, using a Wi-Fi connection.
The Holographic Remoting Player can only be used with PC apps that are specifically designed to support Holographic Remoting.
The Holographic Remoting Player is available for both HoloLens (1st gen) and HoloLens 2. PC apps that supported Holographic Remoting with HoloLens need to be updated to support Holographic Remoting with HoloLens 2. Please contact your app provider if you have questions about which versions are supported.
Connecting to the Holographic Remoting Player
Follow your app's instructions to connect to the Holographic Remoting Player. You will need to enter the IP address of your HoloLens device, which you can see on the Remoting Player's main screen, as follows:
Whenever you see the main screen, you will know that you do not have an app connected.
Note that the holographic remoting connection is not encrypted. You should always use Holographic Remoting over a secure Wi-Fi connection that you trust.
Quality and Performance
The quality and performance of your experience will vary based on three factors:
- The holographic experience you're running - Apps that render high-resolution or highly-detailed content may require a faster PC or faster wireless connection.
- Your PC's hardware - Your PC needs to be able to run and encode your holographic experience at 60 frames per second. For a graphics card, we generally recommend a GeForce GTX 970 or AMD Radeon R9 290 or better. Again, your particular experience may require a higher or lower-end card.
- Your Wi-Fi connection - Your holographic experience is streamed over Wi-Fi. Use a fast network with low congestion to maximize quality. Using a PC that is connected over an Ethernet cable, rather than Wi-Fi, may also improve quality.
To measure the quality of your connection, say "enable diagnostics" while on the main screen of the Holographic Remoting Player. When diagnostics are enabled, on HoloLens (1st gen) the app will show you:
- FPS - The average number of rendered frames the Remoting player is receiving and rendering per second. The ideal is 60 FPS.
- Latency - The average amount of time it takes for a frame to go from your PC to the HoloLens. The lower the better. This is largely dependent on your Wi-Fi network.
On HoloLens 2 the app will show you:
Render - The number of frames the Remoting player rendered during the last second. Note, this is independent from the number of frames which arrived via the network (see Video frames). Additionally, the average/maximum render delta time in milliseconds over the last second between rendered frames is displayed.
Video frames - The first number displayed is skipped video frames, the second is reused video frames, and the third is received video frames. All numbers represent the count over the last second.
Received framesis the number of video frames which arrived over the last second. Under normal conditions this should be 60 but if it's not this is an indicator that either frames are dropped because of network issues or the remote/remote side does not produce frames with the expected rate.
Reused framesis the count of video frames used more than once over the last second. For instance, if video frames arrive late, the rendering loop of the player still renders a frame but needs to reuse the video frame it already used for the previous frame.
Skipped framesis the count of video frames which have not been used by the rendering loop of the player. For instance, network jitter can have the effect that video frames arriving are not evenly distributed anymore. For example, if some are late and others arrive in time with the result that they do not have a delta of 16.66 milliseconds anymore when running on 60Hz. It can occur that more than one frame arrives between two ticks of the render loop of the player. In this case, the player skips one or more frames as it's supposed to always display the most recent received video frame.
When facing network jitter, skipped and reused frames are usually about the same. In contrast, if you only see skipped frames, this is an indicator that the player does not hit its target frame rate. In this case, you should keep an eye on the maximum render delta time when diagnosing issues.
Video frames delta - The minimum/maximum delta between received video frames over the last second. This number usually correlates with skipped/reused frames in case of issues caused by network jitter.
Latency - The average turnaround in milliseconds over the last second. Turnaround in this context means the time from sending pose/sensor data from the HoloLens to the remote/remote side till displaying the video frame for that pose/telemetry data on the HoloLens display.
Video frames discarded - The number of discarded video frames over the last second and since a connection has been established. The primary cause for discarded video frames is when a video frame does not arrive in order and for that reason needs to be discarded as there is already a newer one. This is similar to discarded frames but the cause is at a lower level in the Remoting stack. Discarded video frames are only expected under quite bad network conditions.
While on the main screen, you can say "disable diagnostics" to turn off diagnostics.
PC System Requirements
- Your PC must be running the Windows 10 Anniversary Update or newer.
- We recommend a GeForce GTX 970 or AMD Radeon R9 290 or better graphics card.
- We recommend you connect your PC to your network via ethernet to reduce the number of Wireless hops.