Initial Commit

2025-07-04 20:33:06 +03:00
commit 8f09347ae0
9219 changed files with 2447903 additions and 0 deletions
@@ -0,0 +1,158 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ * All rights reserved.
+ *
+ * Licensed under the Oculus SDK License Agreement (the "License");
+ * you may not use the Oculus SDK except in compliance with the License,
+ * which is provided at the time of installation or download, or which
+ * otherwise accompanies this software in either electronic or hard copy form.
+ *
+ * You may obtain a copy of the License at
+ *
+ * https://developer.oculus.com/licenses/oculussdk/
+ *
+ * Unless required by applicable law or agreed to in writing, the Oculus SDK
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+using System;
+using UnityEngine;
+using UnityEngine.Assertions;
+
+namespace Oculus.Interaction.Input
+{
+    public interface IOVRCameraRigRef
+    {
+        OVRCameraRig CameraRig { get; }
+        /// <summary>
+        /// Returns a valid OVRHand object representing the left hand, if one exists on the
+        /// OVRCameraRig. If none is available, returns null.
+        /// </summary>
+        OVRHand LeftHand { get; }
+        /// <summary>
+        /// Returns a valid OVRHand object representing the right hand, if one exists on the
+        /// OVRCameraRig. If none is available, returns null.
+        /// </summary>
+        OVRHand RightHand { get; }
+        Transform LeftController { get; }
+        Transform RightController { get; }
+
+        event Action<bool> WhenInputDataDirtied;
+    }
+
+    /// <summary>
+    /// Points to an OVRCameraRig instance. This level of indirection provides a single
+    /// configuration point on the root of a prefab.
+    /// Must execute before all other OVR related classes so that the fields are
+    /// initialized correctly and ready to use.
+    /// </summary>
+    [DefaultExecutionOrder(-90)]
+    public class OVRCameraRigRef : MonoBehaviour, IOVRCameraRigRef
+    {
+        [Header("Configuration")]
+        [SerializeField]
+        private OVRCameraRig _ovrCameraRig;
+
+        [SerializeField]
+        private bool _requireOvrHands = true;
+
+        public OVRCameraRig CameraRig => _ovrCameraRig;
+
+        private OVRHand _leftHand;
+        private OVRHand _rightHand;
+        public OVRHand LeftHand => GetHandCached(ref _leftHand, _ovrCameraRig.leftHandAnchor);
+        public OVRHand RightHand => GetHandCached(ref _rightHand, _ovrCameraRig.rightHandAnchor);
+
+        public Transform LeftController => _ovrCameraRig.leftControllerAnchor;
+        public Transform RightController => _ovrCameraRig.rightControllerAnchor;
+
+        public event Action<bool> WhenInputDataDirtied = delegate { };
+
+        protected bool _started = false;
+
+        private bool _isLateUpdate;
+
+        protected virtual void Start()
+        {
+            this.BeginStart(ref _started);
+            this.AssertField(_ovrCameraRig, nameof(_ovrCameraRig));
+            this.EndStart(ref _started);
+        }
+
+        protected virtual void FixedUpdate()
+        {
+            _isLateUpdate = false;
+        }
+
+        protected virtual void Update()
+        {
+            _isLateUpdate = false;
+        }
+
+        protected virtual void LateUpdate()
+        {
+            _isLateUpdate = true;
+        }
+
+        protected virtual void OnEnable()
+        {
+            if (_started)
+            {
+                CameraRig.UpdatedAnchors += HandleInputDataDirtied;
+            }
+        }
+
+        protected virtual void OnDisable()
+        {
+            if (_started)
+            {
+                CameraRig.UpdatedAnchors -= HandleInputDataDirtied;
+            }
+        }
+
+        private OVRHand GetHandCached(ref OVRHand cachedValue, Transform handAnchor)
+        {
+            if (cachedValue != null)
+            {
+                return cachedValue;
+            }
+
+            cachedValue = handAnchor.GetComponentInChildren<OVRHand>(true);
+            if (_requireOvrHands)
+            {
+                Assert.IsNotNull(cachedValue);
+            }
+
+            return cachedValue;
+        }
+
+        private void HandleInputDataDirtied(OVRCameraRig cameraRig)
+        {
+            WhenInputDataDirtied(_isLateUpdate);
+        }
+
+        #region Inject
+        public void InjectAllOVRCameraRigRef(OVRCameraRig ovrCameraRig, bool requireHands)
+        {
+            InjectInteractionOVRCameraRig(ovrCameraRig);
+            InjectRequireHands(requireHands);
+        }
+
+        public void InjectInteractionOVRCameraRig(OVRCameraRig ovrCameraRig)
+        {
+            _ovrCameraRig = ovrCameraRig;
+            // Clear the cached values to force new values to be read on next access
+            _leftHand = null;
+            _rightHand = null;
+        }
+
+        public void InjectRequireHands(bool requireHands)
+        {
+            _requireOvrHands = requireHands;
+        }
+        #endregion
+    }
+}