Skip to content
This repository has been archived by the owner on Feb 13, 2023. It is now read-only.

Latest commit

 

History

History
62 lines (45 loc) · 4.18 KB

StreamingGuide.md

File metadata and controls

62 lines (45 loc) · 4.18 KB

NDI Streaming with OBS

This guide includes the steps required to retreve the streamed image from the Desktop and iOS client apps using OBS.


Combine Camera Streams using OBS

Download and Install

  1. Download OBS
  2. Install the OBS NDI plugin
  3. Inside your OBS project, add a new NDI Source to the scene.
    image image
  4. Add a new video source and select the camera you are using to capture from the headset’s position as the Source Name.
  5. Make sure your NDI Source is above the Video Source in the source hierarchy.
    image

Start Streaming

  1. Start the game on the desktop and headsets.
  2. To create or find a network anchor on the Magic Leap headsets, press the trigger on the controller.
  3. To begin streaming press on desktop press the "1" key on your keyboard, this will also cycle through the players.
  4. To stream on your iOS device, press the start streaming button on the screen.

Note: NDI Streaming can start automatically from desktop or iOS devices by enabling the _streamOnStart condition on the NDIController. The default value is set to false to in case the user wants to view the AR content in real-time without saving the video.

Adjusting the Bandwidth

  1. Once the client and server Unity applications are connected, select the NDI Source in the Sources panel inside the OBS application.
  2. Select the gear icon to open the NDI's source properties.
  3. Select the drop down arrow near the Sources Name Field.
  4. Set Bandwidth to Highest, Sync to Source Timing, and Latency mode to Normal.
    image
  5. OBS should now display a feed of the virtual content from the headset’s perspective with a transparent background overlaid on top of the video feed.
  6. Adjust the size of the NDI stream capture to match the full screen of the video capture
    image
  7. When you are ready to record the composited video, press Start Recording under the Controls header.

Troubleshooting NDI stream latency issues:

If you are experiencing significant delays between the NDI stream and the video stream, try the following steps:

  • Right click on your Video Capture source and select Filters
  • Under Audio/Video Filters, click the + and select Video Delay (Async) image
  • Enter a name for this delay and input the number of milliseconds you want to delay the Video Feed by. You will need to test different lengths until the video feed playback matches the NDI stream output.
  • Click here for a more detailed video tutorial on these steps.

NDI Stream not showing as option in OBS:

  • Double check the steps in the "Create the NDI Rig" section -- make sure if you're using the standard render pipeline, you set the NDI Sender capture method to "game view". If using URP, you can use "camera", but you must set the NDI Camera's Camera/HDR setting to "Off".
  • If attempting to stream from iOS, make sure the project is using URP or HDRP.

If you are still having issues with NDI stream latency, you can try the following:

  • Add a second machine to process the rendering.
  • If you are on a Windows computer, you can try the Spout plugin for Unity.

The image streams but alpha channel shows as black.

  • Inside your Unity project, make sure that the NDI component has alpha enabled in its NDI Sender Script and the Camera that you are using as your source uses a solid black background with transparent alpha. image