using UnityEngine;

namespace Ichni.Story.Dialogue
{
    /// <summary>
    /// 立绘渲染器抽象接口。所有立绘渲染实现（Sprite / Live2D / Spine）均须实现此接口，
    /// 使 <see cref="VNPortraitStage"/> 和 Yarn 命令层无需感知底层渲染细节。
    /// </summary>
    public interface IPortraitRenderer
    {
        /// <summary>此渲染器在舞台上占用的 RectTransform（用于位置操控）。</summary>
        RectTransform RectTransform { get; }

        /// <summary>
        /// 以指定角色数据和情绪名显示立绘。若角色已在台上则更新情绪。
        /// </summary>
        void Show(CharacterData character, string emotion);

        /// <summary>隐藏立绘（不销毁对象，留存以便复用）。</summary>
        void Hide();

        /// <summary>切换当前情绪（角色数据不变）。</summary>
        void SetEmotion(string emotion);

        /// <summary>
        /// 将立绘的 anchoredPosition 设为指定坐标（即时，无动画）。
        /// </summary>
        /// <param name="anchoredPos">目标 anchoredPosition（画布空间，像素单位）。</param>
        void SetPosition(Vector2 anchoredPos);

        /// <summary>
        /// 控制说话者高亮状态：说话者 alpha = 1.0，旁观者 alpha = 0.7（可由实现自行定义）。
        /// </summary>
        void SetActiveVisual(bool isSpeaking);

        /// <summary>
        /// 平滑移动到目标位置。
        /// </summary>
        /// <param name="anchoredPos">目标像素坐标</param>
        /// <param name="duration">持续时间</param>
        void MoveTo(Vector2 anchoredPos, float duration);

        /// <summary>
        /// 原地跳跃动画。
        /// </summary>
        /// <param name="power">跳跃力度（高度）</param>
        /// <param name="numJumps">跳跃次数</param>
        /// <param name="duration">持续时间</param>
        void Jump(float power, int numJumps, float duration);

        /// <summary>
        /// 左右震动动画。
        /// </summary>
        /// <param name="duration">持续时间</param>
        /// <param name="strength">震动力度（像素范围）</param>
        /// <param name="vibrato">震动频率</param>
        void Shake(float duration, float strength, int vibrato);
    }
}