1. 项目概述与核心价值

最近在社区里看到不少朋友在问，怎么在Unity游戏运行的时候，把角色动画、特效序列这些动态内容给录下来。不管是用来做宣传视频、技能展示，还是给美术和策划做效果预览，这需求都挺实在的。Unity自带的Recorder插件功能强大，但很多教程讲得比较零散，特别是针对在游戏运行时（Runtime）进行录制这个场景，总感觉隔着一层窗户纸。今天我就结合自己踩过的坑，把Unity Runtime Animation Recorder这套流程彻底拆开揉碎了讲清楚，让你看完就能上手，录出高清流畅的动画序列。

简单来说，Unity Runtime Animation Recorder的核心价值，就是让你能在游戏真正跑起来的时候，不受编辑器播放模式的限制，自由地录制任何GameObject的变换、动画状态、甚至是粒子特效的每一帧，并输出成序列帧图片或视频文件。这和你用屏幕录制软件完全是两码事——它录的是引擎内部精确的、带Alpha通道的原始图像数据，质量无损，后期处理空间巨大。无论是独立开发者做作品集，还是团队内部进行版本演示、Bug复现，这都是一个效率神器。

2. 核心组件与工具选型解析

要在Runtime下录制，我们主要依赖两个核心组件：Unity Recorder和Timeline。很多人知道Recorder，但容易忽略Timeline在运行时录制中扮演的“导演”角色。

2.1 Unity Recorder：录制引擎

Recorder是Unity官方的录制套件，需要通过Package Manager安装。它支持多种录制类型：

• Animation Clip Recorder：录制GameObject的变换和动画数据，生成.anim文件。这在Runtime下用于记录角色运动轨迹非常有用。
• Movie Recorder：录制视频，支持多种编码格式（如MP4、WebM）。这是最常用的功能。
• Image Sequence Recorder：录制序列帧（如PNG、EXR），适合需要最高画质或后期合成的场景。
• GIF Recorder：录制GIF动画，适合分享小片段。

对于Runtime录制，Movie Recorder和Image Sequence Recorder是我们的主力。选择哪一个？我的经验是：如果追求最高画质和后期灵活性（比如在After Effects里做合成），选PNG序列；如果追求方便快捷、文件小，用于即时分享预览，选MP4。

2.2 Timeline：运行时的控制中枢

这是关键！在编辑器中，我们可以直接点击Recorder窗口的按钮。但在Runtime，谁来触发“开始录制”、“结束录制”这些命令？谁来管理录制时长？答案就是Timeline。

我们可以提前创建一个Timeline资源，在里面放置一个Recorder Track，并绑定好Recorder Clip（配置好录制参数）。然后，在游戏运行时，通过代码PlayableDirector.Play()来启动这个Timeline，录制就会自动开始；Timeline播放完毕，录制自动结束。这种方式非常优雅，把录制的启停、时长控制都整合进了Unity现有的叙事工具里，管理起来清晰明了。

2.3 第三方插件与方案对比

除了官方方案，市面上也有一些第三方Runtime录制插件。但经过实测，官方Recorder + Timeline的方案在稳定性、兼容性和功能完整性上是最优的，尤其是对于Unity 2020 LTS及以后的版本。第三方插件可能在某个特定功能（如直接录制成GIF）上更便捷，但长期维护和与新版本Unity的兼容性是个风险点。因此，除非有非常特殊的需求，否则我强烈建议深耕官方方案。

注意：确保你安装的Recorder版本与Unity版本兼容。建议通过Package Manager安装官方发布的最新稳定版，避免使用Git URL直接引入可能存在的开发中版本。

3. 运行时录制系统搭建全流程

理论说完，我们动手搭一个。目标：在游戏中按下一个键（比如R），开始录制屏幕内容10秒钟，并将视频保存到指定路径。

3.1 环境准备与初始配置

首先，打开你的Unity项目（建议使用2021.3 LTS或更新版本，稳定性好）。

1. 打开Window > Package Manager。
2. 在Packages下拉菜单中选择Unity Registry。
3. 搜索“Recorder”，找到“Unity Recorder”并点击安装。安装时，它会自动安装其依赖的Recorder Timeline等包。
4. 同样方法搜索并安装“Timeline”（如果尚未安装）。

安装完成后，你的项目中就应该有了Recorder和Timeline的相关菜单和组件。

3.2 创建并配置Recorder Timeline资产

这是核心的配置步骤，相当于预先写好“录制剧本”。

1. 在Project窗口中右键，选择Create > Timeline。新建一个Timeline文件，命名为RuntimeRecordingTimeline。
2. 双击这个Timeline文件，打开Timeline编辑器窗口。
3. 我们需要一个对象来“承载”这个Timeline的播放。在场景中创建一个空GameObject，命名为RecordingDirector。
4. 选中RecordingDirector，在Inspector面板中点击Add Component，搜索并添加Playable Director组件。
5. 将刚才创建的RuntimeRecordingTimeline资产，拖拽到Playable Director组件的Playable属性槽中。
6. 在Timeline编辑器窗口中，确保左上角当前绑定的对象是RecordingDirector。然后右键点击轨道区域，选择Add Recorder Track。这时会弹出一个窗口让你创建Recorder Clip。
7. 在弹窗中，选择Movie Recorder，然后点击Create。一个Recorder Clip就会出现在轨道上。
8. 关键配置：选中轨道上的Recorder Clip，在Inspector面板中进行详细设置：
   • Output File：设置输出路径和文件名格式。例如：<ProjectRoot>/Recordings/<Recorder>/<Frame>_<Resolution>。<ProjectRoot>是相对路径，录制文件会生成在项目文件夹下的Recordings文件夹里。我建议将<Recorder>改为一个固定的名称，如RuntimeCapture，方便查找。
   • Source：选择Game View（录制游戏视图）或Targeted Camera（指定某个摄像机）。对于大多数情况，Game View就够了。
   • Resolution：设置录制分辨率。可以选择1920x1080或2560x1440。注意，Runtime下录制过高分辨率（如4K）对性能压力较大，需谨慎。
   • Frame Rate：设置帧率。30或60是常见选择。这里有个坑：如果选择60，但你的游戏在目标设备上无法稳定60帧，录制出来的视频可能会出现时间轴不准的问题。稳妥起见，可以选30。
   • Encoder：选择编码格式。MP4是最通用的。确保下面的Codec选择的是H.264，兼容性最好。
   • Duration Mode：选择Frame Range。然后在下面的Start Frame和End Frame，根据你想要的时长和帧率计算。例如，录制10秒，帧率30，那么End Frame就是10 * 30 = 300。Start Frame保持为0。
9. 配置好后，将Recorder Clip的长度（在Timeline上拖动其右边缘）调整到与帧范围匹配（大约10秒的位置）。这样，Timeline播放多久，就录制多久。

3.3 编写运行时控制脚本

配置好了“剧本”，我们需要写一个“场记”来在运行时发号施令。

1. 创建一个C#脚本，命名为RuntimeRecorderController。
2. 将其挂载到RecordingDirector或任何其他方便的游戏对象上（如GameManager）。
3. 编写脚本内容：

using UnityEngine; using UnityEngine.Playables; // 引入Timeline命名空间 public class RuntimeRecorderController : MonoBehaviour { public PlayableDirector playableDirector; // 引用绑定了Recorder Timeline的Playable Director public KeyCode startRecordingKey = KeyCode.R; // 触发录制的按键 void Start() { // 如果未手动赋值，尝试获取当前物体上的PlayableDirector组件 if (playableDirector == null) { playableDirector = GetComponent<PlayableDirector>(); } if (playableDirector == null) { Debug.LogError("RuntimeRecorderController: No PlayableDirector assigned or found!"); } else { // 确保Timeline初始状态是停止的 playableDirector.Stop(); // 这是一个重要技巧：将Timeline的初始时间设置为0，避免首次播放异常 playableDirector.time = 0; playableDirector.Evaluate(); } } void Update() { // 检测按键输入 if (Input.GetKeyDown(startRecordingKey)) { StartRecording(); } } void StartRecording() { if (playableDirector != null) { Debug.Log("开始录制..."); // 重置Timeline到开头并播放 playableDirector.Stop(); // 先停止，确保状态重置 playableDirector.time = 0; playableDirector.Play(); // 你可以在这里添加UI提示，比如显示“录制中...”的文本 } else { Debug.LogWarning("无法开始录制：PlayableDirector未设置。"); } } // 可选：如果你想知道录制何时结束，可以监听Timeline的播放结束事件。 // 这需要在Start方法中绑定事件：playableDirector.stopped += OnTimelineStopped; void OnTimelineStopped(PlayableDirector director) { Debug.Log("录制结束。文件已保存。"); // 这里可以更新UI，提示录制完成 } }

4. 回到Unity编辑器，将RecordingDirector对象拖拽到RuntimeRecorderController脚本的Playable Director字段上。

3.4 测试与首次录制

1. 点击Unity编辑器上的播放按钮，进入运行模式。
2. 在Game视图里，确保你的游戏内容正在渲染。
3. 按下键盘上的R键。
4. 你应该能在Console窗口看到“开始录制...”的日志，并且Game视图可能有一个红色的“Rec”录制标识（取决于Recorder设置）。
5. 等待10秒（或你设置的时长），录制会自动停止。再次查看Console，应该会有“录制结束”的日志（如果你实现了事件回调）。
6. 停止播放模式。在Unity项目的根目录下，你应该能找到Recordings文件夹，里面就有你刚录制的MP4文件了。

实操心得：第一次运行时，可能会因为输出文件夹权限问题导致录制失败。确保你的Unity项目路径没有特殊字符或过深的层级，且具有写入权限。如果是在Windows系统，避免放在C:\Program Files或C:\Users\用户名\Desktop这类可能受保护的目录下。

4. 高级配置与性能优化指南

基础功能跑通后，我们来看看如何提升录制效果和应对复杂场景。

4.1 多摄像机与渲染纹理录制

有时我们不想录整个屏幕，只想录某个特定摄像机的视角，比如一个画中画、一个后视镜或者一个UI摄像机。这时就需要使用Targeted Camera模式。

1. 在Recorder Clip的配置中，将Source从Game View改为Targeted Camera。
2. 将一个场景中的摄像机对象拖拽到Camera属性槽中。
3. 录制时，Recorder就会只捕获该摄像机渲染的内容。

更进一步，如果你想录制一个渲染到RenderTexture的内容（比如一个动态小地图），你需要确保该RenderTexture被一个摄像机使用，然后将这个摄像机指定给Recorder。

4.2 录制包含Alpha通道的序列帧

对于需要后期合成的专业工作流，带透明通道的视频或序列帧是必须的。MP4格式通常不支持Alpha通道，这时就要使用Image Sequence Recorder，并选择PNG或EXR格式。

• PNG：压缩无损，带Alpha通道，文件大小适中，是最常用的序列帧格式。
• EXR：高动态范围（HDR），包含更丰富的颜色和亮度信息，文件非常大，用于电影级后期。

在Recorder Clip中选择Image Sequence Recorder后，关键设置：

• Format：选择PNG。
• Color Space：如果项目使用线性颜色空间（Linear Color Space），这里建议选择Linear以保持颜色精度。但要注意，导出的PNG用普通图片查看器打开可能会显得很暗，需要在使用合成软件（如AE、Nuke）时解释为线性空间。
• Include Alpha：勾选此项，才会记录透明通道。

重要提示：录制Alpha通道要求被录制的画面本身支持透明。这意味着你的游戏背景可能需要是透明的（例如，摄像机使用Solid Color背景，且Alpha为0），或者你录制的是某个特定层级的UI。

4.3 Runtime录制性能影响与优化

录制，尤其是高分辨率、高帧率录制，是一项GPU和CPU密集型任务，必然会对游戏性能（FPS）产生影响。以下是一些优化思路：

1. 降低录制分辨率：如果预览用途，录制720p甚至更低分辨率足以，能大幅减轻负担。
2. 降低录制帧率：30帧的视频在大多数情况下已经足够流畅，比60帧节省近一半的编码计算量。
3. 使用硬件编码：在Movie Recorder的Encoder设置中，检查是否有Hardware (Encoder)选项。如果显卡支持（如NVIDIA NVENC， AMD VCE， Intel Quick Sync Video），启用硬件编码能极大降低CPU占用，性能提升非常明显。
4. 避免超长时间录制：规划好录制时长，只录需要的片段。长时间录制会积累巨大的内存和磁盘写入压力。
5. 分离录制与游戏逻辑的更新周期：这是一个高级技巧。你可以通过修改Time.captureFramerate（已过时，但思路类似）或使用自定义的更新循环，让录制以固定帧率进行，而游戏逻辑以可变帧率运行。但这需要较深的引擎知识，且可能带来逻辑与表现不同步的问题，需谨慎使用。

实测数据参考：在一台搭载RTX 3060的中端PC上，录制1080p 60帧 H.264软件编码，游戏帧率可能下降15-25%。切换到NVENC硬件编码后，帧率下降通常可以控制在5%以内。

5. 常见问题排查与实战技巧

即使按照教程一步步来，也难免会遇到些“妖魔鬼怪”。这里把我遇到过的问题和解决方案列出来，希望能帮你快速排雷。

5.1 录制失败与错误日志分析

5.2 录制内容与预期不符

• 录出来是黑屏：最常见的原因是摄像机设置问题。如果你选择了Targeted Camera，请确认该摄像机在录制期间是启用（Enable）的，并且其Culling Mask包含了你想录制的物体层。另外，检查摄像机是否被其他物体挡住，或者Clear Flags和背景色设置是否导致画面全黑。
• 录制的画面卡顿，但游戏运行流畅：这通常是编码性能瓶颈。首先确认你是否使用了硬件编码。如果已经是硬件编码还卡顿，可能是显卡同时处理游戏渲染和编码压力过大。尝试降低录制分辨率或帧率。另一个可能是游戏帧率（FPS）远高于录制帧率，导致Recorder丢帧。可以尝试在Quality Settings中开启垂直同步（VSync），或将游戏最大帧率限制到略高于录制帧率（如录制30帧，游戏限40帧）。
• Alpha通道不透明：确保：1. Recorder Clip中已勾选Include Alpha。2. 被录制的摄像机背景是透明的（例如，Background Type为Solid Color，且颜色的A值设为0）。3. 输出格式支持Alpha（如PNG）。

5.3 实用技巧与扩展思路

1. 动态修改输出文件名：你可以在开始录制前，通过代码访问Recorder Clip的属性，动态修改输出文件名，比如加上时间戳。这需要获取到Timeline中的RecorderClip实例，通过playableDirector.playableAsset（即Timeline资产）来遍历轨道和Clip，找到它并修改其outputFile属性。这属于进阶操作，代码略复杂，但能实现高度自动化。
2. 录制特定Layer或UI：可以创建一个专用摄像机，其Culling Mask只包含你想录制的层（如UI层），然后将这个摄像机指定给Recorder。这样就可以单独录制UI动画了。
3. 与游戏事件联动：不一定非要用按键触发。你可以将StartRecording()方法绑定到任何游戏事件上，比如BOSS战开始、释放终极技能的时刻、或者玩家到达某个检查点。只需在对应的事件回调中调用即可。
4. 批量处理与自动化：对于需要录制大量动画片段的情况（如所有角色的技能动画），可以编写编辑器脚本，结合UnityEditor.TestTools中的RuntimeTestRunner，在Play Mode下自动按流程触发录制并保存，极大提升生产效率。