# 录制崩溃后修复录制文件 (/zh-CN/realtime-media/local-server-recording/build/legacy/restore-files)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
在过去的版本中，由于录制崩溃，录制生成的 MP4 文件可能无法播放。
针对该问题，自 3.0.3 版本起，声网录制 SDK 提供如下解决方案：
- 录制 SDK 在录制过程中生成 TS 格式的视频文件，并在录制正常结束后自动转封装为 MP4 文件。即使录制过程中偶现崩溃，最终生成的 MP4 文件依然可以播放。
- 录制 SDK 新增 `crash_restore.sh` 脚本。当录制服务因多次崩溃而异常退出时，你可以运行该脚本将 TS 文件转封装为 MP4 文件，并修复内容缺失的 `uid_UID_timestamp.txt` 文件。
## 适用场景 [#适用场景]
声网录制 SDK 会在以下场景的录制过程中生成 TS 文件：
| 录制模式 | 录制内容 | 参数设置 | 录制过程中生成的文件 | 录制完成后生成的文件 |
| --- | --- | --- | --- | --- |
| [单流录制](/zh-CN/realtime-media/local-server-recording/build/legacy/individual-mode) | 同时录制音视频 | 默认设置 | [restore-files-html-0-1-3 details](#table-slot-restore-files-html-0-1-3) | [restore-files-html-0-1-4 details](#table-slot-restore-files-html-0-1-4) |
| [合流录制](/zh-CN/realtime-media/local-server-recording/build/legacy/composite-mode) | 仅录制视频 | [restore-files-html-0-2-2 details](#table-slot-restore-files-html-0-2-2) | 一个 TS 视频文件 | 一个 MP4 视频文件 |
| [合流录制](/zh-CN/realtime-media/local-server-recording/build/legacy/composite-mode) | 同时录制音视频 | [restore-files-html-0-3-2 details](#table-slot-restore-files-html-0-3-2) | 一个 TS 音视频文件 | 一个 MP4 音视频文件 |
**restore-files-html-0-1-3 details**
- Native 和框架端每个 UID 生成一个 AAC 音频文件和一个 TS 视频文件
- Web 端每个 UID 生成一个 AAC 音频文件和一个 WebM 或 TS 视频文件
**restore-files-html-0-1-4 details**
- Native 和框架端每个 UID 生成一个 AAC 音频文件和一个 MP4 视频文件
- Web 端每个 UID 生成一个 AAC 音频文件和一个 WebM 或 MP4 视频文件
**restore-files-html-0-2-2 details**
- `--isVideoOnly 1`
- `--isMixingEnabled 1`
**restore-files-html-0-3-2 details**
- `--isMixingEnabled 1`
- `--mixedVideoAudio 2`
:::info[信息]
- AAC 音频文件和 WebM 视频文件为流媒体格式的文件，即使录制崩溃也不会影响其可用性。
- 表格中列出的是在录制过程中无崩溃情况下，录制过程中和录制完成后生成的文件。如果录制过程中发生崩溃，TS 视频文件会根据崩溃的次数而被切分成多个，转封装后的 MP4 文件也将是多个。
:::
## 实现方法 [#实现方法]
在不同录制模式下，根据单次录制进程中录制崩溃发生的次数，你需要对录制文件进行不同的修复操作，具体如下表所示：
| 崩溃次数 | 单流录制 | 合流录制 |
| --- | --- | --- |
| 崩溃小于 4 次 | [restore-files-html-1-1-1 details](#table-slot-restore-files-html-1-1-1) | [restore-files-html-1-1-2 details](#table-slot-restore-files-html-1-1-2) |
| 崩溃等于 4 次 | [restore-files-html-1-2-1 details](#table-slot-restore-files-html-1-2-1) | [restore-files-html-1-2-2 details](#table-slot-restore-files-html-1-2-2) |
**restore-files-html-1-1-1 details**
- 录制服务会被重复拉起，继续录制。由于录制崩溃，TS 文件会被切片，`uid_UID_timestamp.txt` 文件会出现内容缺失。
- 录制结束后，录制 SDK 会将所有 TS 文件逐一转封装为 MP4 文件，无需手动处理。
- 但是，录制 SDK 不会修复 `uid_UID_timestamp.txt` 文件。如果你需要用转码脚本将每个 UID 的音频文件和视频文件合并成一个 MP4 文件，则需要先运行 `crash_restore.sh` 脚本修复 `uid_UID_timestamp.txt` 文件。
**restore-files-html-1-1-2 details**
- 录制服务会被重复拉起，继续录制。由于录制崩溃，TS 文件会被切片。
- 录制结束后，录制 SDK 会将所有 TS 文件逐一转封装为 MP4 文件，无需手动处理。
**restore-files-html-1-2-1 details**
- 录制服务异常退出，因录制崩溃而被切片的 TS 文件无法被自动转封装，`uid_UID_timestamp.txt` 文件会出现内容缺失。
- 你需要运行 `crash_restore.sh` 脚本将所有 TS 文件转封装为 MP4 文件。该脚本同时会修复 `uid_UID_timestamp.txt` 文件。
**restore-files-html-1-2-2 details**
- 录制服务异常退出，因录制崩溃而被切片的 TS 文件无法被自动转封装。
- 你需要运行 `crash_restore.sh` 脚本将所有 TS 文件转封装为 MP4 文件。
## 使用恢复脚本 [#使用恢复脚本]
### 前提条件 [#前提条件]
开始前请确保你的开发环境满足以下要求：
- Linux 运行环境
- Python 3.0 或以上版本
- FFmpeg 4.0 或以上版本 （你也可以使用声网录制 SDK 在 **tools** 文件夹下提供的 FFmpeg 包。）
- 确保录制文件的存储路径可访问。
### 恢复步骤 [#恢复步骤]
输入以下命令行：
```shell
$ ./crash_restore.sh /
```
其中，`recorderDir` 为录制文件存放的目录。
输入命令行后，脚本会将指定目录下所有 TS 文件逐一转封装为 MP4 文件，并对 `uid_UID_timestamp.txt` 文件做修复处理。
转封装后的 MP4 文件的数量和主名与源 TS 文件一致，后缀名为 `mp4`。使用脚本完成转封装后，TS 文件不会被删除，以免因修复异常而需要再次使用。
## 示例 [#示例]
如要将录制文件夹 `20200915` 下的 TS 文件转封装为 MP4 文件并修复 `uid_UID_timestamp.txt` 文件，命令如下：
```shell
$ ./crash_restore.sh 20200915/
```
修复前：
修复后：
## 注意事项 [#注意事项]
开发过程中，你还需要关注以下注意事项：
- 自 3.0.3 版本起，录制结束后，需要等待转封装完成，才能得到 MP4 文件。转封装实际耗时取决于服务器的 IOPS 以及待转封装的所有 TS 文件大小。例如，转封装大小总和为 4GB 的 TS 文件大约需要 85 到 150 秒（该数据仅供参考）。
- 转封装操作会增加服务器磁盘 IO 资源消耗。如果服务器磁盘性能较差，在转封装完成前，建议不要进行其他操作。