86 lines
2.5 KiB
C#
86 lines
2.5 KiB
C#
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() { }
|
||
}
|
||
}
|