This document describes the steps needed to set up a computer for streaming a composite webcam and VR headset display feed to Zoom to enable collaboration with remote students without a VR headset.
Prerequisites
This document assumes:
- You have an Oculus Quest or Quest 2 headset
- The headset is connected to your computer with a USB-C cable rated for rapid data transfer (e.g. the silver striped cable included with headsets loaned from the Physics Department)
- The headset has Developer Mode enabled (this is true for any headset borrowed from the Physics Department)
- The headset has USB Debugging enabled for your computer
- The VR lab software is installed on the headset
- Your computer is running Windows 10, Mac OS X or higher, or a modern incarnation of Linux
Software Installation
- Make sure you have downloaded the most recent version of Zoom for your operating system.
- Download the most recent version of OBS (Open Broadcasting Software) for your operating system: https://obsproject.com/
- When configuring OBS for the first time, you may be asked if you plan to use OBS primarily for streaming, recording, or for the virtual camera. If you have the option to select the virtual camera, do so. Otherwise, select streaming, and decline any options you are given to configure any streaming accounts.
- Download the latest release of
scrcpy for your operating system following the instructions here: https://github.com/Genymobile/scrcpy
End goals / Synopsis
The Quest runs the VR lab software on its own; scrcpy is used to mirror (copy) the headset display to the computer. OBS combines the video feeds from the headset mirror and your webcam into a single "virtual camera," which you can select as a video source on Zoom. By doing so, you will share your headset feed and webcam with your remote collaborators over Zoom.
Procedure
Headset mirror setup
Launch scrcpy as described in the installation and mirroring instructions:
VR Lab Installation and Mirroring with scrcpy
Once the mirror is running, launch OBS.