Initial Commit

2025-07-04 20:33:06 +03:00
commit 8f09347ae0
9219 changed files with 2447903 additions and 0 deletions
@@ -0,0 +1,146 @@
+/*
+ * 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 UnityEngine;
+using UnityEngine.Assertions;
+using UnityEngine.Events;
+
+namespace Oculus.Interaction
+{
+    /// <summary>
+    /// This component makes it possible to connect PointableCanvases in the
+    /// inspector to Unity Events that are broadcast from PointableCanvasModule.
+    /// Useful for hooking into uGUI navigation.
+    /// </summary>
+    public class PointableCanvasUnityEventWrapper : MonoBehaviour
+    {
+        [SerializeField, Interface(typeof(IPointableCanvas))]
+        private UnityEngine.Object _pointableCanvas;
+        private IPointableCanvas PointableCanvas;
+
+        [SerializeField, Tooltip("Selection and hover events will not be fired while dragging.")]
+        private bool _suppressWhileDragging = true;
+
+        [SerializeField, Tooltip("Raised when beginning hover of a uGUI selectable")]
+        private UnityEvent _whenBeginHighlight;
+
+        [SerializeField, Tooltip("Raised when ending hover of a uGUI selectable")]
+        private UnityEvent _whenEndHighlight;
+
+        [SerializeField, Tooltip("Raised when selecting a hovered uGUI selectable")]
+        private UnityEvent _whenSelectedHovered;
+
+        [SerializeField, Tooltip("Raised when selecting with no uGUI selectable hovered")]
+        private UnityEvent _whenSelectedEmpty;
+
+        [SerializeField, Tooltip("Raised when deselecting a hovered uGUI selectable")]
+        private UnityEvent _whenUnselectedHovered;
+
+        [SerializeField, Tooltip("Raised when deselecting with no uGUI selectable hovered")]
+        private UnityEvent _whenUnselectedEmpty;
+
+        protected bool _started = false;
+
+        private bool ShouldFireEvent(PointableCanvasEventArgs args)
+        {
+            if (args.Canvas != PointableCanvas.Canvas)
+            {
+                return false;
+            }
+            if (_suppressWhileDragging && args.Dragging)
+            {
+                return false;
+            }
+            return true;
+        }
+
+        private void PointableCanvasModule_WhenSelectableHoverEnter(PointableCanvasEventArgs args)
+        {
+            if (ShouldFireEvent(args))
+            {
+                _whenBeginHighlight.Invoke();
+            }
+        }
+
+        private void PointableCanvasModule_WhenSelectableHoverExit(PointableCanvasEventArgs args)
+        {
+            if (ShouldFireEvent(args))
+            {
+                _whenEndHighlight.Invoke();
+            }
+        }
+
+        private void PointableCanvasModule_WhenSelectableSelected(PointableCanvasEventArgs args)
+        {
+            if (ShouldFireEvent(args))
+            {
+                if (args.Hovered == null)
+                    _whenSelectedEmpty.Invoke();
+                else
+                    _whenSelectedHovered.Invoke();
+            }
+        }
+
+        private void PointableCanvasModule_WhenSelectableUnselected(PointableCanvasEventArgs args)
+        {
+            if (ShouldFireEvent(args))
+            {
+                if (args.Hovered == null)
+                    _whenUnselectedEmpty.Invoke();
+                else
+                    _whenUnselectedHovered.Invoke();
+            }
+        }
+
+        protected virtual void Awake()
+        {
+            PointableCanvas = _pointableCanvas as IPointableCanvas;
+        }
+
+        protected virtual void Start()
+        {
+            this.BeginStart(ref _started);
+            this.AssertField(PointableCanvas, nameof(PointableCanvas));
+            this.EndStart(ref _started);
+        }
+
+        protected virtual void OnEnable()
+        {
+            if (_started)
+            {
+                PointableCanvasModule.WhenSelectableHovered += PointableCanvasModule_WhenSelectableHoverEnter;
+                PointableCanvasModule.WhenSelectableUnhovered += PointableCanvasModule_WhenSelectableHoverExit;
+                PointableCanvasModule.WhenSelected += PointableCanvasModule_WhenSelectableSelected;
+                PointableCanvasModule.WhenUnselected += PointableCanvasModule_WhenSelectableUnselected;
+            }
+        }
+
+        protected virtual void OnDisable()
+        {
+            if (_started)
+            {
+                PointableCanvasModule.WhenSelectableHovered -= PointableCanvasModule_WhenSelectableHoverEnter;
+                PointableCanvasModule.WhenSelectableUnhovered -= PointableCanvasModule_WhenSelectableHoverExit;
+                PointableCanvasModule.WhenSelected -= PointableCanvasModule_WhenSelectableSelected;
+                PointableCanvasModule.WhenUnselected -= PointableCanvasModule_WhenSelectableUnselected;
+            }
+        }
+    }
+}