Providing a quick VR/normal toggle key.

First notice that the keyboard event must be handled in the JS side
since requesting the VR presentation is user-gated and only a
synchronous call from a user gesture can start the presentationñ.

The code in the C# behaviour compiles conditionally and it's only
included if not targeting WebGL. This is because of Unity code for
controlling the keyboard interferes somehow* with the code handling the
input events in the JS.

(*) When interfering, it resulted in the game not entering VR.

Author: delapuente

Assets/WebGLTemplates/WebVR/webvr.js

@@ -20,6 +20,7 @@
   var sitStand = mat4.create();
   var gamepads = [];
   var vrGamepads = [];
+  var toggleVRKeyName = '';
 
   if ('serviceWorker' in navigator && 'isSecureContext' in window && !window.isSecureContext) {
     console.warn('The site is insecure; Service Workers will not work and the site will not be recognized as a PWA');
@@ -63,6 +64,11 @@
         vrDisplay.requestAnimationFrame(onAnimate);
       }
     }
+
+    // Handle quick VR/normal toggling.
+    if (msg.detail.indexOf('ConfigureToggleVRKeyName') === 0) {
+      toggleVRKeyName = msg.detail.split(':')[1];
+    }
   }
 
   function onToggleVR() {
@@ -317,13 +323,20 @@
     });
   }
 
+  function onKeyUp(evt) {
+    if (toggleVRKeyName && toggleVRKeyName === evt.key) {
+      onToggleVR();
+    }
+  }
+
   // Monkeypatch `rAF` so that we can render at the VR display's framerate.
   window.requestAnimationFrame = onRequestAnimationFrame;
 
   window.addEventListener('resize', onResize, true);
   window.addEventListener('vrdisplaypresentchange', onResize, false);
   window.addEventListener('vrdisplayactivate', onRequestPresent, false);
   window.addEventListener('vrdisplaydeactivate', onExitPresent, false);
+  window.addEventListener('keyup', onKeyUp, false);
   document.addEventListener('UnityLoaded', onUnityLoaded, false);
   document.addEventListener('Unity', onUnity);
   entervrButton.addEventListener('click', onToggleVR, false);

Assets/WebVR/Plugins/WebGL/webvr.jslib

@@ -10,5 +10,9 @@ mergeInto(LibraryManager.library, {
 
   PostRender: function () {
     document.dispatchEvent(new CustomEvent('Unity', {detail: 'PostRender'}));
+  },
+
+  ConfigureToggleVRKeyName: function (keyName) {
+    document.dispatchEvent(new CustomEvent('Unity', {detail: 'ConfigureToggleVRKeyName:'+Pointer_stringify(keyName)}));
   }
 });

Assets/WebVR/Prefabs/WebVRCameraSet.prefab

@@ -284,8 +284,9 @@ MonoBehaviour:
   m_Script: {fileID: 11500000, guid: 2330d5cea21bb564e97ad081f15487d9, type: 3}
   m_Name: 
   m_EditorClassIdentifier: 
-  leftHandObj: {fileID: 0}
-  rightHandObj: {fileID: 0}
+  leftHandObject: {fileID: 0}
+  rightHandObject: {fileID: 0}
+  toggleVRKeyName: v
 --- !u!124 &124144808855090856
 Behaviour:
   m_ObjectHideFlags: 1

Assets/WebVR/Scripts/WebVRCamera.cs

@@ -14,6 +14,9 @@ public class WebVRCamera : MonoBehaviour
 	[DllImport("__Internal")]
 	private static extern void PostRender();
 
+	[DllImport("__Internal")]
+	private static extern void ConfigureToggleVRKeyName(string keyName);
+
 	Camera cameraMain, cameraL, cameraR;
 
     Quaternion cq;
@@ -39,9 +42,14 @@ public class WebVRCamera : MonoBehaviour
 
     bool active = false; // vr mode
 
-	public GameObject leftHandObj;
-    public GameObject rightHandObj;
+	[Tooltip("GameObject to be controlled by the left hand controller.")]
+	public GameObject leftHandObject;
+    
+	[Tooltip("GameObject to be controlled by the right hand controller.")]
+	public GameObject rightHandObject;
 
+ 	[Tooltip("Name of the key used to alternate between VR and normal mode. Leave in blank to disable.")]
+	public string toggleVRKeyName;
 
 	// delta time for latency checker.
 	float deltaTime = 0.0f;
@@ -143,9 +151,12 @@ public void TogglePerf() {
 	}
 
 	private void toggleMode() {
-		active = active == true ? false : true;
-		string mode = active == true ? "vr" : "normal";
+		active = !active;
+		string mode = active ? "vr" : "normal";
+
+		#if UNITY_EDITOR || !UNITY_WEBGL
 		changeMode (mode);
+		#endif
 	}
 
 	private void changeMode(string mode)
@@ -192,20 +203,30 @@ void Start()
 
 		#if !UNITY_EDITOR && UNITY_WEBGL
 		FinishLoading();
+		ConfigureToggleVRKeyName(toggleVRKeyName);
 		#endif
 	}
 
 	void Update()
 	{
+		#if UNITY_EDITOR || !UNITY_WEBGL
+		bool quickToggleEnabled = toggleVRKeyName != null && toggleVRKeyName != "";
+		if (quickToggleEnabled) {
+			if (Input.GetKeyUp(toggleVRKeyName)) {
+				toggleMode();
+			}
+		}
+		#endif
+
 		deltaTime += (Time.deltaTime - deltaTime) * 0.1f;
 
-		if (leftHandObj) {
-			leftHandObj.transform.rotation = lhr;
-			leftHandObj.transform.position = lhp + transform.position;
+		if (leftHandObject) {
+			leftHandObject.transform.rotation = lhr;
+			leftHandObject.transform.position = lhp + transform.position;
 		}
-		if (rightHandObj) {
-			rightHandObj.transform.rotation = rhr;
-			rightHandObj.transform.position = rhp + transform.position;
+		if (rightHandObject) {
+			rightHandObject.transform.rotation = rhr;
+			rightHandObject.transform.position = rhp + transform.position;
 		}
 
 		if (active) {