chore: initial commit

Assets/Scripts/Feedback/IFeedbackPlayer.cs

@@ -0,0 +1,68 @@
+namespace BaseGames.Feedback
+{
+    /// <summary>
+    /// 反馈播放器接口：封装所有角色反馈行为，解耦 Character 逻辑与 Feel/MMF_Player 的直接依赖。
+    /// 由 PlayerFeedback（玩家）和 EnemyFeedback（敌人）分别实现；
+    /// NullFeedbackPlayer 用于测试/占位。
+    /// </summary>
+    public interface IFeedbackPlayer
+    {
+        // ── 命中 ──────────────────────────────────────────────────────────────────
+        /// <summary>对目标造成命中时播放对应力度的反馈（摄像机震屏 + 控制器振动等）。</summary>
+        void PlayHit(HitWeight weight);
+
+        /// <summary>成功弹反（Parry）时播放反馈。</summary>
+        void PlayParrySuccess();
+
+        // ── 受伤 / 死亡 ──────────────────────────────────────────────────────────
+        /// <summary>角色受到伤害时播放反馈（闪白 + 轻微震屏等）。</summary>
+        void PlayTakeHit();
+
+        /// <summary>角色死亡时播放反馈（慢动作 + 震屏 + 音效）。</summary>
+        void PlayDeath();
+
+        // ── 状态恢复 ─────────────────────────────────────────────────────────────
+        /// <summary>治疗/恢复血量时播放反馈（粒子 + 音效）。</summary>
+        void PlayHeal();
+
+        // ── 移动 / 动作 ──────────────────────────────────────────────────────────
+        /// <summary>硬着陆时播放地面冲击反馈。</summary>
+        void PlayLandImpact();
+
+        /// <summary>攻击出手时播放破风反馈。</summary>
+        void PlayAttackWhoosh();
+
+        /// <summary>跳跃起跳时播放反馈。</summary>
+        void PlayJumpLaunch();
+
+        // ── 通用 ─────────────────────────────────────────────────────────────────
+        /// <summary>通过 presetId 触发在 Inspector 中配置的命名预设 MMF_Player。</summary>
+        void TriggerPreset(string presetId);
+
+        /// <summary>通过 sfxId 触发单次音效（不带任何摄像机/振动反馈）。</summary>
+        void PlaySFXById(string sfxId);
+    }
+
+    /// <summary>命中力度。</summary>
+    public enum HitWeight { Light, Medium, Heavy }
+
+    /// <summary>
+    /// 空对象模式实现：所有方法均为空操作，用于测试和不需要反馈的实体。
+    /// </summary>
+    public class NullFeedbackPlayer : IFeedbackPlayer
+    {
+        public static readonly NullFeedbackPlayer Instance = new NullFeedbackPlayer();
+
+        public void PlayHit(HitWeight weight)       { }
+        public void PlayParrySuccess()              { }
+        public void PlayTakeHit()                   { }
+        public void PlayDeath()                     { }
+        public void PlayHeal()                      { }
+        public void PlayLandImpact()                { }
+        public void PlayAttackWhoosh()              { }
+        public void PlayJumpLaunch()                { }
+        public void TriggerPreset(string presetId)  { }
+        public void PlaySFXById(string sfxId)       { }
+    }
+}
+