Using SteamVR with Windows Mixed Reality
The Windows Mixed Reality SteamVR preview allows developers to test and optimize their SteamVR experiences to run on Windows Mixed Reality headsets. This program is currently in an invite-only closed preview. As we continue to develop the experience, we will grant access to additional developers in our program to test and provide us with feedback. If you have not yet joined our developer program and are interested in participating, please sign up at aka.ms/iwantmr.
In addition to the Ultra PC requirements for running Windows Mixed Reality, we recommend running the SteamVR Preview on a PC with a GTX 1070 video card (or better) and an Intel Core i7 processor. We are continuing to review feedback and optimize the performance to support additional system configurations in future updates. If your PC does not meet these specs you won't be blocked from running the Windows Mixed Reality SteamVR preview however this will impact the performance and quality of the overall experience.
Initial setup instructions
Install the Windows 10 Fall Creators Update
You must be running the latest Windows 10 Fall Creators update to use the Windows Mixed Reality SteamVR preview.
Setting up SteamVR
- Install Steam - http://store.steampowered.com/about. Note: If you already have Steam and you're running the client beta, you'll need to opt out before proceeding - Steam (top left of the UI) -> Settings -> Account -> Beta Participation - Not Participating.
- Install SteamVR - Use the drop down under your Library to filter to Tools and then locate SteamVR in the list and right click to install.
- Open SteamVR properties - right click SteamVR in the same Tools page and open the Properties dialog.
- Join the SteamVR Beta - click the Betas tab and opt into SteamVR Beta Update by selecting it from the drop down. Note: The beta access code field should be left blank and you can just hit close to confirm.
Enable Developer mode in Windows settings
Windows Settings -> Update and Security -> For developers - Select Developer Mode
Activate the Windows Mixed Reality SteamVR Preview
The Windows Mixed Reality SteamVR preview is currently in a closed developer preview so you must have a key to download it on Steam. Once you receive your key, activate the product through Steam:
Under the "Games" drop down menu at the top left of your Steam Client select "Activate a Product on Steam" -> Next -> Accept -> copy/paste your key -> Next -> Finish
Install the Windows Mixed Reality SteamVR preview
- Filter your Steam Library to ‘Software’ to find the Windows Mixed Reality SteamVR preview that you just activated with the product key
- Select it in the list and click Install
Launching and playing Steam games
Once you've installed the SteamVR preview according to the directions above you should be ready to play VR games from your personal Steam library. To play titles from your collection:
- Close SteamVR if its already running
- Launch the Mixed Reality Portal and make sure you make it to the Cliff House and that your controllers are working correctly
- Use Steam to download and launch the title you wish to play or launch them directly from a shortcut on your desktop (if asked, choose to launch in SteamVR mode).
Note: If you lock your screen, remove your headset, switch users or if your PC goes to sleep Steam will exit
The basic controls in games are controlled by the app developer but the high level system controls are as follows:
- Clicking left thumb stick brings up the Steam Dashboard
- Press the right thumb stick to switch your controller hands
- Windows button takes you back to Cliff House
After you've completed the setup staying up to date is easy. You can pull the latest version from Steam by checking for updates under the downloads section of your Library. If you have auto-updates enabled, then the Windows Mixed Reality SteamVR preview will stay up to date automatically.
Tuning your App for Windows Mixed Reality
Below is an overview of common adjustments developers can make to ensure their experience is tuned for Windows Mixed Reality.
- If your app renders controller models:
- Experiences that have a notion of handedness should get hints from the input APIs to differentiate controllers (Unity example)
- If possible, default to thumb stick based teleportation to match the Windows Mixed Reality home teleportation behavior
Bugs and feedback
Your feedback is invaluable when it comes to improving the Windows Mixed Reality SteamVR preview experience. Please submit all feedback and bugs through the Windows Feedback Hub. Please select the Mixed Reality category, and put the word SteamVR in the problem summary.
If you have questions or comments to share, you can also reach us on our Steam forum.
FAQs and troubleshooting
SteamVR won't launch or continuously crashes
- Launch the Mixed Reality Portal and make your way to the cliff house, then try launching SteamVR again
- Make sure your PC is in developer mode
- Double check that you opted into the SteamVR beta
- Confirm that you aren't running a Beta version of the Steam client
My controllers aren't working as expected
- Close SteamVR
- Return to the Cliff House home and confirm that your controllers are working as expected
- Launch the experience again and your controllers should be back to normal
- If issues persist please file feedback using the Windows Feedback Hub
My games are running slowly
- Pause the preview (display mirror) in the Mixed Reality Portal
- Confirm you're running against the recommended specs for the Windows Mixed Reality Preview
- Confirm you're running against the recommended specs for the game located on the Steam page
SteamVR is Showing a Compositor Error
- If you have multiple graphics adapters, the main monitor and Mixed Reality HMD should be connected to the same adapter