using System;

namespace Continentis.MainGame.Character
{
    /// <summary>
    /// 角色动画驱动器统一接口。
    /// 由具体的 MonoBehaviour 实现，挂载在角色 Prefab 上，
    /// CombatCharacterViewBase 在初始化时自动检测并持有引用。
    /// </summary>
    public interface ICharacterAnimator
    {
        /// <summary>
        /// 初始化动画驱动器，由 CombatCharacterViewBase.Initialize() 调用。
        /// </summary>
        void InitializeAnimator(CombatCharacterViewBase view);

        /// <summary>
        /// 播放指定名称的动作（如 "Attack"、"Hit"、"Skill"）。
        /// 播放完毕后自动回到 Idle，并触发 onComplete 回调。
        /// </summary>
        /// <param name="actionName">动作名称，需与 CharacterData.animations 的 Key 一致。</param>
        /// <param name="speed">播放速度倍率，默认 1.0。</param>
        /// <param name="onComplete">动作播放完毕后的回调，可为 null。</param>
        void PlayAction(string actionName, float speed = 1f, Action onComplete = null);

        /// <summary>
        /// 立即切回 Idle 状态。
        /// </summary>
        void ReturnToIdle();

        /// <summary>
        /// 暂停或恢复动画播放。
        /// </summary>
        void SetPause(bool isPaused);
    }
}