更新

Assets/Scripts/SLSUtilities/Feedback/Base/FeedbackActionBase.cs

@@ -0,0 +1,85 @@
+using System;
+using Sirenix.OdinInspector;
+using UnityEngine;
+
+namespace SLSUtilities.Feedback
+{
+    /// <summary>
+    /// 反馈播放上下文，传递给每个 FeedbackAction 的生命周期回调。
+    /// </summary>
+    public struct FeedbackContext
+    {
+        /// <summary>
+        /// 当前播放器实例。
+        /// </summary>
+        public FeedbackPlayer player;
+
+        /// <summary>
+        /// 触发者的 Transform（可选）。
+        /// </summary>
+        public Transform owner;
+
+        /// <summary>
+        /// 当前帧经过时间缩放处理后的 deltaTime。
+        /// </summary>
+        public float deltaTime;
+
+        /// <summary>
+        /// Clip 已播放时间（秒）。
+        /// </summary>
+        public float elapsedTime;
+
+        /// <summary>
+        /// Clip 总时长（秒）。
+        /// </summary>
+        public float duration;
+    }
+
+    /// <summary>
+    /// 所有反馈动作的抽象基类，定义生命周期回调。
+    /// 使用 Odin 的序列化路径实现多态序列化（SerializedScriptableObject）。
+    /// Odin 会自动为此抽象类型的字段显示多态类型选择器。
+    /// </summary>
+    [Serializable]
+    public abstract class FeedbackActionBase
+    {
+        /// <summary>
+        /// Inspector 中显示的名称。
+        /// </summary>
+        public virtual string DisplayName => GetType().Name;
+
+        /// <summary>
+        /// 初始化，FeedbackPlayer 开始播放此 Clip 时调用。
+        /// </summary>
+        public virtual void OnStart(FeedbackContext context) { }
+
+        /// <summary>
+        /// 每帧更新，normalizedTime 为 Clip 内的归一化进度 [0,1]。
+        /// </summary>
+        public virtual void OnUpdate(FeedbackContext context, float normalizedTime) { }
+
+        /// <summary>
+        /// Clip 自然结束时调用。
+        /// </summary>
+        public virtual void OnEnd(FeedbackContext context) { }
+
+        /// <summary>
+        /// 被打断时调用，负责立即复位到初始状态。
+        /// </summary>
+        public virtual void OnInterrupt(FeedbackContext context) { }
+
+        /// <summary>
+        /// 用于验证配置是否正确（Editor 环境）。
+        /// </summary>
+        public virtual bool Validate(out string error)
+        {
+            error = null;
+            return true;
+        }
+
+        /// <summary>
+        /// 用于 Editor 预览（Runtime 也可用）。
+        /// </summary>
+        public virtual void Preview() { }
+    }
+}