1. 项目概述为什么我们需要一个自己的动画捕获插件在Unity项目开发中尤其是涉及到角色动画、过场动画Cinematic或者需要将游戏内动画导出到其他DCC工具如Maya、Blender进行二次编辑时我们经常会遇到一个痛点如何方便、高效地记录和导出游戏对象在运行时或编辑器下的变换与动画数据Unity内置的Animation窗口主要用于编辑和预览但它并不直接支持将任意时间跨度内、由代码或物理驱动的复杂运动“录制”成标准的动画片段Animation Clip。市面上虽然有Asset Store的付费插件但要么功能臃肿要么定制性不足要么在特定项目架构下存在兼容性问题。自己动手实现一个Animation Recorder不仅能完美契合项目需求更能让你深入理解Unity动画系统和序列化机制的内核。这个插件核心要解决两个场景的需求编辑器模式录制和运行时录制。编辑器模式下你可能需要手动摆放场景物件录制一段摄像机运镜或者记录一个物理模拟的结果。运行时模式下则是在游戏运行中实时捕获玩家操作的角色动作、特效的位移旋转甚至是UI元素的动态变化。实现这样一个工具你将串联起Unity的Update/LateUpdate循环、AnimationCurve的数据构建、ScriptableObject的资源管理以及EditorWindow的绘制是一个综合性极强的练手项目。2. 核心架构设计数据驱动与双模式分离一个健壮的Animation Recorder插件其架构必须清晰地将数据、逻辑与控制界面分离。核心思想是录制器Recorder负责采样动画数据容器Clip Builder负责存储和序列化而控制器Manager负责协调整个生命周期。同时编辑器模式和运行时模式虽然共享核心录制逻辑但在启动、停止和资源处理上需要有明确的区分。2.1 核心组件职责划分首先我们定义几个核心的C#类AnimationClipData (ScriptableObject)这是动画数据的最终载体。它不仅仅是一个Unity的AnimationClip资产更是一个包含元数据的容器。例如它可以记录录制的帧率FPS、录制时长、参与录制的目标对象GameObject列表以及每个对象上被录制的属性路径如localPosition.x,localEulerAngles.y。将其设计为ScriptableObject是为了方便在项目中创建、保存和引用。PropertyRecorder (核心采样类)这是实际干活的类。它绑定到一个具体的GameObject上负责在每一帧采样该对象上指定的属性如Transform的position, rotation, scale或某个Material的color属性。它会将采样到的时间时间戳和值浮点数、向量等存储为临时的列表。关键在于它需要知道如何将不同的数据类型Vector3,Quaternion,float统一地转换为AnimationCurve所需的关键帧Keyframe数据。RecorderManager (单例或静态管理类)这是录制系统的大脑。它维护一个全局的录制状态正在录制、暂停、停止管理所有活跃的PropertyRecorder实例。在编辑器模式下它可能由EditorWindow驱动在运行时模式下它通过MonoBehaviour的Update进行驱动。它还负责在录制结束时命令所有PropertyRecorder将采样的原始数据序列化到AnimationClipData中并最终生成AnimationClip文件。AnimationRecorderWindow (EditorWindow)这是编辑器模式下的用户界面。它提供按钮开始/暂停/停止录制、目标对象选择框、属性勾选列表让用户选择录制位置还是旋转、帧率设置、输出路径设置等。它的主要作用是与RecorderManager交互并在OnGUI中提供可视化反馈。2.2 双模式运行机制编辑器模式录制驱动由EditorApplication.update委托驱动。这是一个在编辑器不运行游戏时也会每帧调用的回调完美模拟了游戏循环。流程用户在AnimationRecorderWindow中配置好目标和属性点击“开始录制”。窗口脚本调用RecorderManager.StartRecording()管理器创建并初始化PropertyRecorder。随后在EditorApplication.update回调中管理器调用所有PropertyRecorder的Sample()方法进行采样。点击停止时管理器触发数据序列化和AnimationClip资产的创建使用AssetDatabase.CreateAsset。优势不依赖游戏运行可以录制编辑器中的任何操作包括手动拖拽、动画预览等。运行时模式录制驱动由一个不销毁的GameObject上的MonoBehaviour例如RuntimeRecorderBehaviour驱动在其Update或LateUpdate方法中调用采样。流程通常通过代码API启动例如RecorderManager.StartRecordingAtRuntime(targets, properties)。采样过程与编辑器模式类似但时间源是Time.time。停止录制后生成的AnimationClipData和AnimationClip需要以资源文件如AssetBundle或二进制文件的形式保存到磁盘这涉及到Resources、AssetDatabase仅限编辑器或直接文件IOSystem.IO的使用。挑战运行时资源创建和保存路径处理需要更谨慎尤其是在移动平台或WebGL平台写入权限是受限的。注意一个常见的误区是试图用同一个MonoBehaviour同时服务编辑器和运行时。更好的做法是抽象一个IRecorderDriver接口然后分别实现EditorDriver和RuntimeDriver由RecorderManager在初始化时根据上下文注入相应的驱动。这符合依赖注入原则使代码更清晰、可测试。3. 关键技术细节与实现难点拆解有了架构蓝图我们深入几个实现中必然会遇到的关键技术点。这些细节决定了插件的稳定性、性能和易用性。3.1 属性采样与AnimationCurve构建这是最核心的算法部分。PropertyRecorder如何采样一个Transform的旋转问题Unity的Transform.rotation是一个Quaternion。而AnimationClip中的一条曲线AnimationCurve只能存储一系列浮点数。一个四元数有四个分量x, y, z, w我们需要为每个分量创建一条独立的曲线。解决方案public void SampleRotation(Transform target, float time) { Quaternion rot target.localRotation; // 通常录制局部旋转更通用 // 将Quaternion的四个分量分别采样 SampleFloatChannel(time, rot.x, “localRotation.x”); SampleFloatChannel(time, rot.y, “localRotation.y”); SampleFloatChannel(time, rot.z, “localRotation.z”); SampleFloatChannel(time, rot.w, “localRotation.w”); }SampleFloatChannel方法会将时间和值存入一个ListKeyframe。录制结束后用这个列表new AnimationCurve(keyframes.ToArray())来创建曲线。难点与优化冗余关键帧剔除如果物体静止不动每一帧采样的值都一样会产生大量冗余关键帧极大增加文件大小和后期计算量。必须在采样时或后处理时进行剔除。一个简单的策略是在添加新的关键帧前检查它与上一个关键帧的值差是否小于某个阈值如0.0001f如果小于则跳过。if (Mathf.Abs(currentValue - lastSampledValue) epsilon) { // 跳过这一帧的采样 return; } lastSampledValue currentValue;欧拉角与万向锁直接录制Transform.localEulerAngles看似更直观但会遭遇著名的万向锁问题在插值时可能导致意外旋转。最佳实践是始终录制四元数。虽然.anim文件内部存储的是欧拉角但Unity的AnimationUtility在从代码设置曲线时会处理四元数到欧拉角的转换。用户若需要可读的欧拉角可以在导出后或插件界面提供一个“转换为欧拉角”的选项但这仅用于查看录制源应保持为四元数。世界坐标与局部坐标必须明确录制的是局部变换localPosition,localRotation,localScale还是世界变换。录制局部变换兼容性更好因为它不依赖于父节点的变化。如果用户需要世界坐标可以录制一个没有父级或父级不变的物体的变换或者提供选项并提示潜在风险。3.2 帧率控制与时间管理录制动画需要稳定的时间间隔。你不能简单地依赖Update的不稳定时间差。固定帧率录制这是专业动画的要求。在RecorderManager中维护一个计时器。private float sampleTimer 0f; private float timePerSample; // 1f / targetFrameRate; void UpdateDriver() { sampleTimer Time.deltaTime; // 或 EditorApplication.timeSinceStartup增量 while (sampleTimer timePerSample) { sampleTimer - timePerSample; SampleAllRecorders(currentTime); // 执行采样 currentTime timePerSample; // 使用固定的采样时间累加 } }使用while循环确保即使游戏卡顿导致两帧间隔很长也能补上应有的采样次数保证动画时长正确。时间源编辑器模式下使用EditorApplication.timeSinceStartup运行时使用Time.time。currentTime变量记录了动画剪辑内部的时间线从0开始每次采样递增timePerSample。3.3 动画剪辑的创建与属性绑定采样得到了一堆AnimationCurve如何把它们变成一个真正的AnimationClip创建ClipAnimationClip clip new AnimationClip();设置Clip参数clip.frameRate targetFrameRate;确保回放速度正确。绑定曲线这是最关键的一步需要生成正确的属性绑定路径。// 例如给名为 “MyCube” 的物体绑定局部X位置曲线 string relativePath AnimationUtility.CalculateTransformPath(targetTransform, rootTransform); // 计算从根对象到目标对象的相对路径 string propertyName “localPosition.x”; // 属性名 EditorCurveBinding binding EditorCurveBinding.FloatCurve(relativePath, typeof(Transform), propertyName); AnimationUtility.SetEditorCurve(clip, binding, curveX);CalculateTransformPath方法能自动生成像“Armature/Hip/Spine/Shoulder”这样的路径这对于录制角色骨骼动画至关重要。你需要指定一个“根对象”通常就是开始录制时所有目标的共同祖先或者场景根节点。实操心得在编辑器模式下创建AnimationClip后直接使用AssetDatabase.CreateAsset(clip, “Assets/Path/MyClip.anim”);即可保存。在运行时这个过程复杂得多。你不能直接使用AssetDatabase。一种方案是将AnimationClip序列化为字节流然后使用Resources.Load或AssetBundle系统来动态加载。对于需要持久化保存到设备的情况可能需要将关键帧数据以自定义格式如JSON保存然后在编辑器环境下或特定工具中再重新生成.anim文件。这通常是运行时录制最麻烦的部分。4. 完整实现流程与代码骨架让我们串联起所有部分勾勒出一个可工作的代码骨架。这里以编辑器模式录制为例因为它包含了所有核心环节。4.1 步骤一定义数据容器// AnimationClipData.cs using UnityEngine; using System.Collections.Generic; [CreateAssetMenu(fileName “NewAnimationData”, menuName “Tools/Animation Clip Data”)] public class AnimationClipData : ScriptableObject { public AnimationClip generatedClip; public float frameRate 30f; public float duration; public ListRecordedGameObject recordedObjects new ListRecordedGameObject(); [System.Serializable] public class RecordedGameObject { public GameObject target; public string path; // 相对路径 public ListPropertyCurveSet curves new ListPropertyCurveSet(); } [System.Serializable] public class PropertyCurveSet { public string propertyName; // e.g., “m_LocalPosition.x” public AnimationCurve curve; } }4.2 步骤二实现属性记录器// PropertyRecorder.cs using UnityEngine; using System.Collections.Generic; public class PropertyRecorder { public GameObject target; public string relativePath; private Dictionarystring, ListKeyframe pendingKeyframes new Dictionarystring, ListKeyframe(); private Dictionarystring, float lastSampledValues new Dictionarystring, float(); private const float epsilon 0.0001f; public void AddPropertyToRecord(string propertyName) { if (!pendingKeyframes.ContainsKey(propertyName)) { pendingKeyframes[propertyName] new ListKeyframe(); lastSampledValues[propertyName] float.MaxValue; // 初始值 } } public void Sample(float time, Transform targetTransform) { // 示例采样位置 Vector3 pos targetTransform.localPosition; SampleFloat(time, pos.x, “localPosition.x”); SampleFloat(time, pos.y, “localPosition.y”); SampleFloat(time, pos.z, “localPosition.z”); // ... 采样旋转、缩放等 } private void SampleFloat(float time, float value, string propertyName) { if (!pendingKeyframes.ContainsKey(propertyName)) return; float lastValue lastSampledValues[propertyName]; if (Mathf.Abs(value - lastValue) epsilon) return; // 冗余剔除 lastSampledValues[propertyName] value; pendingKeyframes[propertyName].Add(new Keyframe(time, value)); } public Dictionarystring, AnimationCurve GetCurves() { var curves new Dictionarystring, AnimationCurve(); foreach (var kvp in pendingKeyframes) { if (kvp.Value.Count 0) { curves[kvp.Key] new AnimationCurve(kvp.Value.ToArray()); } } return curves; } public void Clear() { pendingKeyframes.Clear(); lastSampledValues.Clear(); } }4.3 步骤三构建录制管理器// RecorderManager.cs (编辑器部分示例) using UnityEngine; using UnityEditor; using System.Collections.Generic; using System.Linq; public static class RecorderManager { private static bool isRecording false; private static float startTime; private static float currentTime; private static float timePerSample; private static AnimationClipData currentClipData; private static ListPropertyRecorder activeRecorders new ListPropertyRecorder(); private static System.Action updateDelegate; public static void StartRecording(AnimationClipData clipData, GameObject root, ListGameObject targets, float frameRate) { if (isRecording) StopRecording(); currentClipData clipData; currentClipData.frameRate frameRate; timePerSample 1f / frameRate; currentTime 0f; startTime (float)EditorApplication.timeSinceStartup; isRecording true; activeRecorders.Clear(); foreach (var go in targets) { var recorder new PropertyRecorder(); recorder.target go; recorder.relativePath AnimationUtility.CalculateTransformPath(go.transform, root.transform); // 这里简化默认录制所有Transform属性 recorder.AddPropertyToRecord(“localPosition.x”); // ... 添加其他属性 activeRecorders.Add(recorder); } // 注册更新回调 updateDelegate EditorUpdate; EditorApplication.update updateDelegate; Debug.Log($“开始录制帧率{frameRate}FPS目标数{targets.Count}”); } private static void EditorUpdate() { if (!isRecording) return; float elapsed (float)EditorApplication.timeSinceStartup - startTime; // 固定帧率采样逻辑 while (currentTime elapsed) { foreach (var recorder in activeRecorders) { if (recorder.target ! null) { recorder.Sample(currentTime, recorder.target.transform); } } currentTime timePerSample; } } public static void StopRecording() { if (!isRecording) return; isRecording false; EditorApplication.update - updateDelegate; FinalizeClip(); Debug.Log(“录制结束正在生成动画片段。”); } private static void FinalizeClip() { AnimationClip clip new AnimationClip(); clip.frameRate currentClipData.frameRate; foreach (var recorder in activeRecorders) { var curves recorder.GetCurves(); foreach (var curveKvp in curves) { var binding EditorCurveBinding.FloatCurve(recorder.relativePath, typeof(Transform), curveKvp.Key); AnimationUtility.SetEditorCurve(clip, binding, curveKvp.Value); } recorder.Clear(); } currentClipData.generatedClip clip; currentClipData.duration currentTime; // 保存Asset string path AssetDatabase.GetAssetPath(currentClipData); if (string.IsNullOrEmpty(path)) path “Assets/RecordedClip.anim”; AssetDatabase.CreateAsset(clip, path); AssetDatabase.SaveAssets(); AssetDatabase.Refresh(); } }4.4 步骤四创建编辑器窗口// AnimationRecorderWindow.cs using UnityEngine; using UnityEditor; using System.Collections.Generic; public class AnimationRecorderWindow : EditorWindow { private AnimationClipData clipData; private GameObject rootObject; private ListGameObject targetObjects new ListGameObject(); private float frameRate 30f; private Vector2 scrollPos; [MenuItem(“Tools/Animation Recorder”)] static void Init() { var window GetWindowAnimationRecorderWindow(); window.titleContent new GUIContent(“动画录制器”); window.Show(); } void OnGUI() { scrollPos EditorGUILayout.BeginScrollView(scrollPos); // 1. 创建或选择ClipData clipData (AnimationClipData)EditorGUILayout.ObjectField(“动画数据”, clipData, typeof(AnimationClipData), false); if (GUILayout.Button(“创建新的数据资产”)) { clipData CreateInstanceAnimationClipData(); string path EditorUtility.SaveFilePanelInProject(“保存动画数据”, “NewAnimationData”, “asset”, “”); if (!string.IsNullOrEmpty(path)) { AssetDatabase.CreateAsset(clipData, path); AssetDatabase.Refresh(); } } // 2. 设置根对象和目标列表 rootObject (GameObject)EditorGUILayout.ObjectField(“根对象路径计算起点”, rootObject, typeof(GameObject), true); // 这里简化目标对象列表的UI实际可以用ReorderableList EditorGUILayout.LabelField(“目标对象”); for (int i 0; i targetObjects.Count; i) { targetObjects[i] (GameObject)EditorGUILayout.ObjectField(“目标 “ i, targetObjects[i], typeof(GameObject), true); } if (GUILayout.Button(“ 添加目标”)) targetObjects.Add(null); // 3. 录制参数 frameRate EditorGUILayout.FloatField(“帧率 (FPS)”, frameRate); // 4. 控制按钮 EditorGUILayout.BeginHorizontal(); if (GUILayout.Button(“开始录制”, GUILayout.Height(30))) { if (clipData null) { EditorUtility.DisplayDialog(“错误”, “请先创建或选择一个动画数据资产”, “确定”); return; } if (rootObject null) { EditorUtility.DisplayDialog(“错误”, “请指定根对象”, “确定”); return; } var validTargets targetObjects.FindAll(go go ! null); if (validTargets.Count 0) { EditorUtility.DisplayDialog(“错误”, “请至少添加一个有效的目标对象”, “确定”); return; } RecorderManager.StartRecording(clipData, rootObject, validTargets, frameRate); } if (GUILayout.Button(“停止录制”, GUILayout.Height(30))) { RecorderManager.StopRecording(); } EditorGUILayout.EndHorizontal(); EditorGUILayout.EndScrollView(); } }5. 常见问题、优化与扩展方向在实际实现和使用的过程中你肯定会遇到各种问题。这里记录一些典型的坑和对应的解决方案。5.1 性能与内存优化问题录制高帧率、长时间、多目标的动画会导致内存中暂存的海量关键帧列表可能引起卡顿或内存溢出。解决增量式写入不要把所有Keyframe都存在内存里。可以每采样一定数量如1000帧或每隔一段时间就将现有的关键帧列表序列化到磁盘的临时文件中。最终再合并所有临时文件生成动画。这需要设计一个简单的文件格式。采样频率动态调整对于移动缓慢的物体可以自动降低采样频率。这需要更复杂的逻辑来判断物体的“运动激烈程度”。对象池管理频繁创建和销毁PropertyRecorder和列表会产生GC垃圾回收压力。可以使用对象池来复用这些组件。5.2 录制属性扩展基础版只录制了Transform。一个强大的插件应该支持更多材质属性录制Material的color,float参数等。属性路径类似“material._Color.r”。组件属性录制任意MonoBehaviour脚本的公共字段或属性。这需要通过反射System.Reflection或更高效的序列化方案来实现是插件高级化的方向。Animator状态与Unity的Animator组件结合录制状态机参数Animator.SetFloat等的变化。5.3 运行时录制的资源保存这是最大的挑战。如前所述运行时不能调用AssetDatabase。方案A仅内存录制生成的AnimationClip只存在于内存用于游戏内即时回放不保存到磁盘。适用于录制“精彩瞬间”并立即重播的场景。方案B自定义序列化将AnimationClipData包含所有关键帧数据序列化为JSON或二进制文件保存到Application.persistentDataPath。然后你需要编写一个“导入器”工具可以是另一个编辑器窗口在开发时读取这些数据文件重新在编辑器内生成.anim资源。这是最通用、跨平台的方案。方案CAssetBundle在运行时动态创建AnimationClip然后将其与一个预设体一起打包成AssetBundle再保存到磁盘。这个过程相对复杂且AssetBundle的管理本身就有一定开销。5.4 编辑器体验打磨录制预览在录制过程中可以在Scene视图实时绘制被录制物体的轨迹或关键帧标记。属性选择面板提供一个像Animation窗口一样的树状结构让用户勾选需要录制的具体属性。后处理功能增加曲线平滑、冗余关键帧删除基于更复杂的算法、时间缩放、剪辑裁剪等功能。实现一个完整的Animation Recorder插件是一个系统工程它考验你对Unity引擎循环、动画系统、序列化、编辑器扩展等各方面的理解。从最简单的Transform录制开始逐步迭代加入更多属性和优化最终你会得到一个强大且完全贴合自己工作流的专属工具。这个过程本身就是一次极佳的学习和提升之旅。