简单序列帧动画播放器，播放GIF

using UnityEngine;
using UnityEngine.UI;
using UnityEngine.U2D;

/// <summary>
/// 简单序列帧动画播放器
/// 支持直接拖入 SpriteAtlas 图集，自动提取并播放所有帧
/// </summary>
[RequireComponent(typeof(Image))]
public class SimpleSpriteAnimation : MonoBehaviour
{
[Header("图集（直接拖入）")]
[Tooltip("拖入 SpriteAtlas 图集，自动提取所有 Sprite")]
public SpriteAtlas atlas;

[Header("播放设置")]
[Tooltip("帧率（每秒播放帧数）")]
public float frameRate = 30f;

[Tooltip("是否自动播放")]
public bool playOnStart = true;

[Tooltip("是否循环播放")]
public bool loop = true;

// 提取的精灵帧
private Sprite[] frames;

// 当前帧索引
private int currentFrame = 0;

// 计时器
private float timer = 0f;

// 播放状态
private bool isPlaying = false;

// Image组件
private Image image;

/// <summary>
/// 总帧数
/// </summary>
public int FrameCount => frames?.Length ?? 0;

/// <summary>
/// 是否正在播放
/// </summary>
public bool IsPlaying => isPlaying;

private void Awake()
{
image = GetComponent<Image>();
}

private void Start()
{
ExtractFramesFromAtlas();

if (playOnStart && frames != null && frames.Length > 0)
{
Play();
}
}

private void Update()
{
if (!isPlaying || frames == null || frames.Length == 0)
return;

timer += Time.deltaTime;
float interval = 1f / frameRate;

while (timer >= interval)
{
timer -= interval;
NextFrame();
}
}

/// <summary>
/// 从 SpriteAtlas 提取所有帧
/// </summary>
private void ExtractFramesFromAtlas()
{
if (atlas == null)
return;

// 获取图集中的 Sprite 数量
int spriteCount = atlas.spriteCount;
frames = new Sprite[spriteCount];

// 提取所有 Sprite
Sprite[] tempSprites = new Sprite[spriteCount];
atlas.GetSprites(tempSprites);

// 按名称数字排序
System.Array.Sort(tempSprites, (a, b) =>
{
int numA = ExtractNumber(a.name);
int numB = ExtractNumber(b.name);
return numA.CompareTo(numB);
});

frames = tempSprites;
}

/// <summary>
/// 从 Sprite 名称中提取数字用于排序
/// </summary>
private int ExtractNumber(string name)
{
// 移除 "(Clone)" 后缀（GetSprites 会添加）
name = name.Replace("(Clone)", "");

int number;
if (int.TryParse(name, out number))
return number;

// 尝试提取数字部分
for (int i = 0; i < name.Length; i++)
{
if (char.IsDigit(name[i]))
{
int start = i;
while (i < name.Length && char.IsDigit(name[i]))
i++;
if (int.TryParse(name.Substring(start, i - start), out number))
return number;
}
}

return int.MaxValue;
}

/// <summary>
/// 播放动画
/// </summary>
public void Play()
{
if (frames == null || frames.Length == 0)
{
ExtractFramesFromAtlas();
}

if (frames == null || frames.Length == 0)
return;

isPlaying = true;
timer = 0f;
UpdateFrame();
}

/// <summary>
/// 暂停动画
/// </summary>
public void Pause()
{
isPlaying = false;
}

/// <summary>
/// 停止动画（暂停并重置到第一帧）
/// </summary>
public void Stop()
{
isPlaying = false;
currentFrame = 0;
timer = 0f;
UpdateFrame();
}

/// <summary>
/// 重新播放
/// </summary>
public void Replay()
{
currentFrame = 0;
timer = 0f;
Play();
}

/// <summary>
/// 跳转到下一帧
/// </summary>
private void NextFrame()
{
currentFrame++;

if (currentFrame >= frames.Length)
{
if (loop)
{
currentFrame = 0;
}
else
{
currentFrame = frames.Length - 1;
isPlaying = false;
return;
}
}

UpdateFrame();
}

/// <summary>
/// 更新显示的帧
/// </summary>
private void UpdateFrame()
{
if (frames != null && frames.Length > 0 && image != null)
{
image.sprite = frames[currentFrame];
}
}
}

Resource下文件