Merge pull request #239 from De-Panther/spectator_camera_support

Added Spectator Camera

Author: De-Panther

Build/Build/Build.data

@@ -6,6 +6,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- Spectator Camera.
+
 ## [0.15.0] - 2022-06-04
 ### Changed
 - Requires WebXR Export 0.15.0.

Build/Build/Build.framework.js

@@ -0,0 +1,60 @@
+using UnityEngine;
+
+namespace WebXR.Interactions
+{
+  /// <summary>
+  /// Controls the Spectator Camera, enable render it when in XR mode.
+  /// Notice that the Depth of the attached Camera should be higher than the other cameras on the scene.
+  /// </summary>
+  [RequireComponent(typeof(Camera))]
+  public class SpectatorCamera : MonoBehaviour
+  {
+    private Camera _camera;
+    [SerializeField]
+    private bool enableInXR = false;
+    private WebXRState currentXRState = WebXRState.NORMAL;
+
+    private void Awake()
+    {
+      _camera = GetComponent<Camera>();
+    }
+
+    private void OnEnable()
+    {
+      WebXRManager.OnXRChange += HandleOnXRChange;
+      currentXRState = WebXRManager.Instance.XRState;
+      TryUpdateCameraState();
+    }
+
+    private void OnDisable()
+    {
+      WebXRManager.OnXRChange -= HandleOnXRChange;
+    }
+
+    private void OnPreRender()
+    {
+      WebXRManager.Instance.PreRenderSpectatorCamera();
+    }
+
+    private void HandleOnXRChange(WebXRState state, int viewsCount, Rect leftRect, Rect rightRect)
+    {
+      currentXRState = state;
+      TryUpdateCameraState();
+    }
+
+    private void TryUpdateCameraState()
+    {
+      bool newState = enableInXR && currentXRState != WebXRState.NORMAL;
+      if (_camera.enabled != newState)
+      {
+        _camera.enabled = newState;
+      }
+    }
+
+    public void EnableCameraInXR(bool value)
+    {
+      enableInXR = value;
+      TryUpdateCameraState();
+    }
+  }
+}