Virtual Reality Robot

Plugin for all SteamVR supported virtual reality headsets (Google Cardboard, Oculus Rift, Windows Mixed Reality, HTC Vive, etc)

Manual

Use Virtual Reality with your robot to see what the robot sees, and control servos by moving your head. This plugin supports all virtual reality headsets through Steam VR (OpenVR), Google Play and iOS, including Google Cardboard, Oculus, Windows Mixed Reality and HTC Vive. The plugin does two things, it allows you to see what the robot sees and control the servos with the Pitch and Yaw of the headset. This means when you move your head, the robot head can move as well, mimicking your movement. 

In this video, it was a test of the plugin on a Synthiam JD Humanoid. Sadly, he had no arms during the test so it's a bit funny to see. Professor E from The Robot Program was controlling the robot's head and viewing the robot's camera through the VR headset. In this example, we were using OpenVR in STEAM with a Samsung Odyssey headset.

In this video below, we were controlling an Synthiam Six Hexapod with a joystick and the VR headset. When we moved the head left to right, the legs of the hexapod will rotate the body so we can look around. This also applied to looking up and down, the legs would tilt the body so we can look up and down as well. In this example we were using an Android phone with Google Cardboard Glasses.




Here is another interesting example where we combined this VR Headset plugin with 2 WiiMotes to create custom animations. Each time a button was pressed on the WiiMote, a new FRAME was created with the current position of all servos and appended to an ACTION. DJ keeps pressing the button and the FRAMES keep getting appended to the ACTION until he stops. One he presses the trigger on the WiiMote, the code instructs the ACTION to be played back. And thus, all FRAMES are played back because they are part of the action.




Here is a screenshot of the plugin running on an ARC workspace with a camera.




What Hardware Does It Support?
There are two methods that connect to the plugin which open a wide variety of hardware. 

1. SteamVR (OpenVR)
On PC, the supported headsets use Steam VR (OpenVR). This means any headset supporting Steam VR will work with this plugin, given the headset is directly connected to the PC. The most popular SteamVR headsets are Oculus, HTC Vive and Windows Mixed Reality.

2. Google Cardboard (iOS and Android)
The Google Cardboard is both a product and standard that turns your mobile device into a virtual reality headset. This means you can either purchase the cardbooard version from Google, or you can shop online and purchase a more robust plastic/foam padded version from amazon.

Download the Android App here: https://play.google.com/store/apps/details?id=com.ezrobot.virtualrealityrobot




Allow Firewall Access


When the plugin is loaded, you may receive a message to allow firewall access. Be sure to check Private and Public networks. If you do not check both, you may end up in a situation in the future where you're connected to a public network and the plugin isn't working. In this case, it's because ARC doesn't have firewall permission. Also, if you do not see this message when the plugin loads, it could be because you've already answered this in the past. In which case, you should visit the firewall rules to see if ARC has correct access.

1) Press the Windows button and type FIREWALL to search for Windows Defender Firewall
2) Select "Allow an app or feature through windows defender firewall"



3) Press CHANGE SETTINGS



4) Ensure both PRIVATE and PUBLIC are checked for ARC and press OK





Attach/Detach Camera Button



This plugin requires a camera, whether on your robot or a USB device. Add the camera device to your project and connect to the camera. Once you have a successful camera operational, press the Attach to Camera button on the plugin. This will connect the plugin to the camera device so the video stream is sent to the VR headset.

Start/Close VR Client Button (SteamVR only)



If you are have a Steam VR compatible headset connected to your PC, this button will allow you to use that headset. This button will start the VR client, which connects to the VR Headset. The client can be launched either full screen or in a window. By default, the setting is to launch in the plugin window. This setting can be altered for your project in the configuration dialog.

Google Cardboard Users
For those using a google cardboard (iOS or Android) compatible device and headset, your device needs to be on the same network as the ARC PC. This is because your mobile device will connect to the ARC plugin by typing in the IP address of the PC. The IP Address for your ARC PC is displayed in the plugin. Simply load the Virtual Reality Robot mobile app on your device and enter the ip address of the ARC PC.






4K Display Issues
There is an issue with 4K displays and running the local client in the robot skill window. If you have a 4k display and press the "Start Local Client" button, you will notice two things...
1) The client is very small
2) The client is offset from the display window

This is known issue with Windows & Unity with 4k displays. The way around this is to set the client to run in full screen, which is configurable in this skill's configuration window.





Virtual Reality Caution
Read the warnings on your device before using a virtual reality (VR) viewer with this plugin to reduce the risk of personal injury, discomfort or property damage. Ensure you use this plugin with adequate space to avoid hurting yourself or others by walking into something. Nausea and motion sickness may be experienced and worse for some users. Do not use this plugin for extended periods of time to avoid experiencing nausea.