# 合并音视频文件 (/zh-CN/realtime-media/local-server-recording/build/legacy/merge-files) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 单流录制模式下，每个 UID 的音频和视频均分开录制，每个 UID 都有其对应的音频文件和视频文件。 你可以使用我们的音视频合并脚本，合并每个 UID 的音频文件和视频文件。 ## 前提条件 [#前提条件] ### 环境准备 [#环境准备] - 以下物理或虚拟服务器： - Ubuntu 14.04+ x64 - CentOS 6.5+（推荐 7.0）x64 - 安装 Python 2.7 及以上版本 ### 录制文件准备 [#录制文件准备] - 确保你已经使用声网本地服务端录制 SDK 单流录制生成录制文件。 - 确保录制文件夹内有 `recording2-done.txt` 文件，标识本频道录制结束。 ## 转码步骤 [#转码步骤] ### 获取音视频合并转码脚本 [#获取音视频合并转码脚本] 前往[资源获取](/zh-CN/realtime-media/local-server-recording/reference/downloads)下载本地服务端录制 SDK 并解压，在 `tools` 文件夹下找到 `ffmpeg.tar.gz` 和 `video_convert.py` 文件。 打开终端，进入 `tools` 文件夹，通过 `tar -xf ffmpeg.tar.gz` 命令解压 `ffmpeg.tar.gz`，确保和 `video_convert.py` 在同一目录下。 ### 设置转码参数 [#设置转码参数] 解压完成后，设置转码参数即可开始转码。 #### 转码参数介绍 [#转码参数介绍] 你可先如下图所示，输入命令行 `python video_convert.py`，查看转码参数介绍。 ![转码参数](https://web-cdn.agora.io/docs-files/1569396483232) 也可通过下列表格了解各参数。 | 参数 | 描述 | | --- | --- | | `-f` | 必设，指定待转码文件的存储路径。 | | `-m` | [merge-files-html-0-2-1 details](#table-slot-merge-files-html-0-2-1) | | `-s` | [merge-files-html-0-3-1 details](#table-slot-merge-files-html-0-3-1) | | `-p` | 设置转码后视频的帧率，单位为 fps。默认值为 15 fps。取值范围为 5 fps 到 120 fps。如果设置低于 5 fps，则按 5 fps 执行。具体设置请参考[分辨率、帧率、码率对照表](/zh-CN/realtime-media/local-server-recording/build/legacy/set-output-video#分辨率帧率码率对照表)。 | | `-r` | 设置转码后视频的分辨率，格式为 `宽 高`，例如 `-r 640 360`。具体设置请参考[分辨率、帧率、码率对照表](/zh-CN/realtime-media/local-server-recording/build/legacy/set-output-video#分辨率帧率码率对照表)。 | **merge-files-html-0-2-1 details** 设置转码模式，可设为： - `0`：默认转码模式，按 Segment 转码，即把同一个 Segment 的音频和视频合成一个音视频文件。 - `1`：音视频合并模式。 - `2`：音频合并模式。 - `3`：视频合并模式。 详见下文 [`-m` 参数介绍](#option)。 **merge-files-html-0-3-1 details** 设置保存模式，表示转码是否需要严格时间同步，即用户离开频道的时间是否占转码文件时长： - 不设置 `-s`，则为默认的 `all time recording` 模式。此模式下，如果用户录制中途退出频道后重新加入，用户退出的时间会以黑色的画面呈现在录制文件里。举例来说，用户在频道里 2 分钟后，退出频道 30 分钟，再加入频道 2 分钟，则录制文件长度最终为 34 分钟，其中 30 分钟为黑屏。 - 如果设置了 `-s`，则转码文件中删除用户中途退出频道到重新加入频道之间的时长。 :::warning[注意] 此参数仅在 `-m` 设为 `1`，`2` 或 `3` 时有效。 ::: **-m 参数介绍** 在此之前，你需要了解录制 Segment 的概念。 录制 Segment 指每个 UID 从开始录制到结束录制这一过程。具体条件如下表所示。 | 该 UID 开始录制 | 该 UID 结束录制 | Column 3 | | --- | --- | --- | | 自动录制 | [merge-files-html-1-1-1 details](#table-slot-merge-files-html-1-1-1) | [merge-files-html-1-1-2 details](#table-slot-merge-files-html-1-1-2) | | 手动录制 | [merge-files-html-1-2-1 details](#table-slot-merge-files-html-1-2-1) | [merge-files-html-1-2-2 details](#table-slot-merge-files-html-1-2-2) | **merge-files-html-1-1-1 details** 同时满足以下条件： - 该 UID 加入频道并发流 - 录制 SDK 加入频道 **merge-files-html-1-1-2 details** 满足以下任一条件： - 该 UID 停止发流且 15 秒内没有重新发流 - 该 UID 离开频道且 15 秒内没有重新加入 - 录制 SDK 离开频道 **merge-files-html-1-2-1 details** 同时满足以下条件： - 该 UID 加入频道并发流 - 录制 SDK 加入频道并手动开始录制 **merge-files-html-1-2-2 details** 满足以下任一条件： - 该 UID 停止发流且 15 秒内没有再发流 - 该 UID 离开频道且 15 秒内没有重新加入 - 录制 SDK 手动暂停录制 了解录制 Segment 的概念后，我们再来看 `-m` 参数不同设置的具体行为。 `-m` 参数不同设置的行为视录制启动模式而定。 :::info[信息] 为方便描述，以下我们假设每个 UID 均录制生成多个音频文件和视频文件。 ::: **自动录制模式** 自动录制模式（默认录制启动模式，`triggerMode` 设为 `0`）下，`-m` 参数不同设置的行为如下： - `0`：把同一个 UID 的音频和视频按照录制 Segment 合并。一个 UID 的一个录制 Segment 对应一个音视频文件，文件名为 `UID_timestamp_av.mp4`。 - `1`：把同一个 UID 的**音频和视频**按时间顺序合成一个文件。一个 UID 对应一个音视频文件，文件名为 `UID_0_merge_av.mp4`。 - `2`：把同一个 UID 的**音频**按时间顺序合成一个文件。一个 UID 对应一个音频文件，文件名为 `UID_0_merge.m4a`。 - `3`：把同一个 UID 的**视频**按时间顺序合成一个文件。一个 UID 对应一个视频文件，文件名为 `UID_0_merge.mp4`。 其中，`timestamp` 为服务器开始录制的时间戳，由年、月、日、小时、分钟、秒和毫秒组成，时区为 UTC + 0。例如 `123_20190611073246073.aac` 表示在 UTC 2019 年 6 月 11 日 7 点 32 分 46 秒 73 毫秒时开始录制的一个 UID 为 `123` 的用户的音频文件。如音频和视频的开始录制时间不一致，`timestamp` 为两个开始时间中较早的时间。 **手动录制模式** 手动录制模式（`triggerMode` 设为 `1`）下，你需要手动开始录制和暂停录制。每一次开始/暂停视为一次录制 Session。请结合下图进行理解录制 Segment 和录制 Session。 ![录制 Session 与 Segment](https://web-cdn.agora.io/docs-files/1569399270238) 在此模式下， `-m` 参数不同设置的行为如下： - `0`：把同一个 UID 的音频和视频按照录制 Segment 合并。一个 UID 的一个录制 Segment 对应一个音视频文件，文件名为 `UID_timestamp_av.mp4`。 - `1`：把同一个 UID 的音频和视频按照录制 Session 合并。一个 UID 的一个录制 Session 对应一个音视频文件，文件名为 `UID_X_merge_av.mp4`。 - `2`：把同一个 UID 的音频按录制 Session 合并。一个 UID 的一个录制 Session 对应一个音频文件，文件名为 `UID_X_merge.m4a`。 - `3`：把同一个 UID 的视频按录制 Session 合并。一个 UID 的一个录制 Session 对应一个视频文件。文件名为 `UID_X_merge.mp4`。 其中，X 为录制 Session 的序号，从 0 开始。 #### 转码参数设置示例 [#转码参数设置示例] 下面结合具体案例来介绍转码参数的设置和最终得到的转码文件。 **案例一**：频道内有两个用户，UID 分别为 `100` 和 `123`。录制 SDK 以**自动录制模式**加入频道进行录制。在此过程中 UID `100` 用户曾离开频道，30 秒后再进入。因此 UID `100` 用户有两个录制 Segment，对应两个音频文件和两个视频文件，UID `123` 用户对应一个音频文件和一个视频文件。 可运行以下命令将每个 UID 的音视频合并成一个文件： ```shell video_convert.py -f <待转码文件所在路径> -m 1 -s -p 30 -r 640 360 ``` 最终会生成两个转码文件：`100_0_merge_av.mp4` 和 `123_0_merge_av.mp4`。UID `100` 用户退出频道后再进入频道之间的 30 秒时长不会包含在内。如要将 30 秒时长包含在内，需要取消设置 `-s`。 **案例二**：频道内有两个用户，UID 分别为 `100` 和 `123`。录制 SDK 以**手动录制模式**加入频道进行录制。在此过程中曾有一次暂停录制然后又开始录制，用户 `123` 和用户 100 中途多次进出频道。因此得到的录制文件中，UID `100` 用户对应多个音频文件和多个视频文件，UID `123` 用户也对应多个音频文件和多个视频文件。 可运行以下命令将每个 UID 的音视频文件按录制 Session 合并： ```shell video_convert.py -f <待转码文件所在路径> -m 1 -p 30 -r 640 360 ``` 最终会生成四个转码文件：`100_0_merge_av.mp4`，`100_1_merge_av.mp4`，`123_0_merge_av.mp4` 和 `123_1_merge_av.mp4`。 转码完成后，会生成一个 `convert-done.txt`，标志转码成功；还会生成一个 `convert.log` 日志文件，和音视频文件在同一个目录下。 ## 播放器支持 [#播放器支持] 转码完成后的 MP4 文件可在下表所列的播放器中播放。 | 操作系统 | 支持播放器 | | --- | --- | | Linux | [merge-files-html-2-1-1 details](#table-slot-merge-files-html-2-1-1) | | Windows | [merge-files-html-2-2-1 details](#table-slot-merge-files-html-2-2-1) | | macOS | [merge-files-html-2-3-1 details](#table-slot-merge-files-html-2-3-1) | | iOS | [merge-files-html-2-4-1 details](#table-slot-merge-files-html-2-4-1) | | Android | [merge-files-html-2-5-1 details](#table-slot-merge-files-html-2-5-1) | **merge-files-html-2-1-1 details** - VLC - ffplayer **merge-files-html-2-2-1 details** - Media Player - KM Player - VLC Player - Chrome (>= 49.0.2623) **merge-files-html-2-3-1 details** - Quick Time Player - Movist - MX Player - Chrome (>= 49.0.2623) - Safari (>= 11.0.3) **merge-files-html-2-4-1 details** - 系统播放器 - KM Player - Safari (>= 9.0) **merge-files-html-2-5-1 details** - 系统播放器 - MX Player - VLC - KM Player - Chrome (>= 49.0.2623)