游戏美术与资产 / 系统课时

在 Unity 中播放第一个 Spine 角色

在 Unity 中播放第一个 Spine 角色

本篇将完成 Spine 资源接入 Unity 的最小流程,从导入运行库到配置角色组件,最终让角色在场景中播放第一个动画。

学习目标

  • 理解 Unity 中 Spine 资源的基本组成和加载方式。
  • 完成 Spine 角色预制体配置并播放动画。
  • 掌握基础动画切换代码的调用方式。

准备 Spine Unity Runtime

Unity 本身不能直接识别 Spine 导出的动画数据,需要通过 Spine 官方提供的 Unity Runtime 解析资源。导入 Runtime 后,项目中会增加用于加载骨骼数据、控制动画状态的组件。

导入资源时,需要保证 Runtime 版本与 Spine 编辑器导出版本匹配。例如使用较新的 Spine 编辑器导出资源时,项目中的 Runtime 版本过旧可能导致数据无法读取。

导入资源并创建角色对象

将导出的 .json 或 .skel、.atlas 和纹理文件复制到 Unity 项目的 Assets 目录后,Unity 会自动导入资源。

一个基础角色对象通常需要包含 Skeleton Animation 组件,该组件负责加载骨骼数据,并通过 Animation State 控制动画播放。

text
Assets/
└── Spine/
    └── hero/
        ├── hero.json
        ├── hero.atlas
        └── hero.png

预期结果

text
Unity Project 窗口中显示 Spine 资源文件,并可以创建对应角色对象。

播放第一个动画

在运行时,可以通过 SkeletonAnimation 提供的 AnimationState 设置当前动画。下面是一个 Unity C# 脚本示例,用于让角色进入 idle 动画。

csharp
using UnityEngine;
using Spine.Unity;

public class SpineCharacterController : MonoBehaviour
{
    [SerializeField] private SkeletonAnimation skeletonAnimation;

    void Start()
    {
        // 设置角色初始循环动画
        skeletonAnimation.AnimationState.SetAnimation(0, "idle", true);
    }
}

预期输出

text
Unity 运行场景后,角色显示并持续循环播放 idle 动画。

如果动画名称不存在,运行时不会播放目标动作,因此动画名称需要与 Spine 编辑器中的 Animation 列表保持一致。

切换动画时的注意事项

Spine 动画切换通常通过动画状态机完成,而不是直接替换模型。多个动画之间可以设置混合时间,让角色动作过渡更加自然。

例如角色从 idle 切换到 run 时,应考虑以下因素:

  • 当前动画是否循环播放。
  • 新动画是否需要覆盖当前轨道。
  • 是否需要设置过渡混合时间。

基础接入阶段只需要完成资源加载和单动画播放,确认角色能够正常显示后,再继续处理动画混合、事件回调和复杂状态管理。

排查播放失败问题

如果 Unity 中角色显示异常,可以优先检查资源和版本:

  • 角色对象是否引用正确的 Skeleton Data。
  • 动画名称是否与 Spine 编辑器完全一致。
  • Runtime 版本是否支持当前导出格式。
  • atlas 和图片资源是否完整导入。

完成这些检查后,一个基础 Spine 角色就可以在 Unity 场景中正常运行,后续功能可以基于动画状态继续扩展。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 Unity 中播放第一个 Spine 角色

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通