(client) feat:图像加载失败时加载默认图像，生成实体身体结构

Client/Assets/Scripts/Entity/SpriteAnimator.cs

@@ -0,0 +1,151 @@
+using UnityEngine;
+
+namespace Entity
+{
+public class SpriteAnimator : MonoBehaviour
+{
+    // 引用 SpriteRenderer 组件
+    [SerializeField] private SpriteRenderer spriteRenderer;
+
+    // 精灵列表
+    [SerializeField] private Sprite[] sprites;
+
+    // 动画帧率 (Frames Per Second)
+    [SerializeField] private float fps = 10f;
+
+    // 是否暂停动画
+    [SerializeField] private bool isPaused = false;
+
+    // 暂停时显示的静态精灵索引 (-1 表示不显示静态精灵)
+    [SerializeField] private int staticSpriteIndex = -1;
+
+    // 当前帧索引
+    private int currentFrameIndex = 0;
+
+    // 帧间隔时间
+    private float frameInterval;
+
+    // 计时器
+    private float timer;
+
+    private void Start()
+    {
+        // 初始化帧间隔时间
+        frameInterval = 1f / fps;
+
+        // 如果指定了静态精灵索引，则直接显示静态精灵
+        if (staticSpriteIndex >= 0 && staticSpriteIndex < sprites.Length)
+        {
+            ShowStaticSprite(staticSpriteIndex);
+        }
+        else
+        {
+            // 否则从第一个精灵开始
+            UpdateSprite();
+        }
+    }
+
+    private void Update()
+    {
+        // 如果暂停并且没有设置静态精灵，则不更新
+        if (isPaused && staticSpriteIndex == -1) return;
+
+        // 如果暂停并设置了静态精灵，则直接显示静态精灵
+        if (isPaused && staticSpriteIndex >= 0)
+        {
+            ShowStaticSprite(staticSpriteIndex);
+            return;
+        }
+
+        // 更新计时器
+        timer += Time.deltaTime;
+
+        // 如果达到下一帧的时间间隔
+        if (timer >= frameInterval)
+        {
+            timer -= frameInterval; // 重置计时器
+            UpdateSprite(); // 更新精灵
+        }
+    }
+
+    /// <summary>
+    /// 更新当前显示的精灵
+    /// </summary>
+    private void UpdateSprite()
+    {
+        if (sprites.Length == 0) return; // 如果没有精灵，则退出
+
+        // 设置当前帧的精灵
+        spriteRenderer.sprite = sprites[currentFrameIndex];
+
+        // 循环播放：更新到下一帧
+        currentFrameIndex = (currentFrameIndex + 1) % sprites.Length;
+    }
+
+    /// <summary>
+    /// 显示静态精灵
+    /// </summary>
+    /// <param name="index">静态精灵的索引</param>
+    private void ShowStaticSprite(int index)
+    {
+        if (index < 0 || index >= sprites.Length)
+        {
+            Debug.LogWarning("静态精灵索引超出范围！");
+            return;
+        }
+
+        // 显示指定的静态精灵
+        spriteRenderer.sprite = sprites[index];
+    }
+
+    /// <summary>
+    /// 开始播放动画
+    /// </summary>
+    public void PlayAnimation()
+    {
+        isPaused = false; // 取消暂停
+        staticSpriteIndex = -1; // 清除静态精灵索引
+    }
+
+    /// <summary>
+    /// 暂停动画并显示静态精灵
+    /// </summary>
+    /// <param name="index">静态精灵的索引</param>
+    public void PauseAnimationWithStaticSprite(int index)
+    {
+        if (index < 0 || index >= sprites.Length)
+        {
+            Debug.LogWarning("静态精灵索引超出范围！");
+            return;
+        }
+
+        isPaused = true; // 暂停动画
+        staticSpriteIndex = index; // 设置静态精灵索引
+    }
+
+    /// <summary>
+    /// 暂停动画但不显示静态精灵
+    /// </summary>
+    public void PauseAnimation()
+    {
+        isPaused = true; // 暂停动画
+        staticSpriteIndex = -1; // 不显示静态精灵
+    }
+
+    /// <summary>
+    /// 设置帧率
+    /// </summary>
+    /// <param name="newFps">新的帧率</param>
+    public void SetFPS(float newFps)
+    {
+        if (newFps <= 0)
+        {
+            Debug.LogWarning("帧率必须大于 0！");
+            return;
+        }
+
+        fps = newFps;
+        frameInterval = 1f / fps; // 更新帧间隔时间
+    }
+}
+}