# 合流录制 (/zh-CN/realtime-media/local-server-recording/build/legacy/composite-mode) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). 本文介绍如何通过命令行的方式进行合流录制。 本地服务端录制支持两种模式: - 单流录制模式:(默认录制模式)分开录制频道内每个用户 ID 的音频流和视频流。每个用户 ID 均有其对应的音频文件和视频文件。 - 合流录制模式:频道内所有或指定用户 ID 的音视频混合录制为一个音视频文件;或频道内所有或指定用户 ID 的音频混合录制为一个纯音频文件,所有或指定用户 ID 的视频混合录制为一个纯视频文件。 ## 前提条件 [#前提条件] 开始前请确保: - 你已经完成录制 SDK 的环境准备和集成工作并且了解如何使用命令行开始录制,详见[集成客户端](/zh-CN/realtime-media/local-server-recording/build/legacy/integrate-sdk)和[命令行录制](/zh-CN/realtime-media/local-server-recording/build/legacy/record-by-cmd)。 - 单流或合流模式的设置必须在开始录制的时候完成,不支持在录制开始后切换模式。请参阅[单流录制模式和合流录制模式的区别](/zh-CN/reference/faq/integration/recording_mode)来决定应使用哪种模式。 ## 实现方法 [#实现方法] 为方便起见,本文我们假设频道内每个用户都发送音频和视频。如果某个用户没有发送音频或视频,例如直播频道中的观众,一般不会生成该用户的音频或视频录制文件(Web 端例外)。 ### 启用合流录制 [#启用合流录制] 在开始录制时将参数 `isMixingEnabled` 设为 `1` 即可使用合流模式录制。 根据录制内容的不同,录制生成的文件如下表所示: | 录制内容 | 参数设置 | 录制生成文件 | | :------------- | :---------------------------------------- | :------------------ | | 仅录制音频 | `--isAudioOnly 1 --isMixingEnabled 1` | 一个 AAC 音频文件 | | 仅录制视频 | `--isVideoOnly 1 --isMixingEnabled 1` | 一个 MP4 视频文件 | | 同时录制音视频 | `--isMixingEnabled 1 --mixedVideoAudio 2` | 一个 MP4 音视频文件 | :::info[信息] - 合流录制模式下,如果同时录制音视频,我们建议同时将 `mixedVideoAudio` 参数设为 `2`,把音频文件和视频文件实时混合成一个既有音频也有视频的 MP4 文件。 - 在仅录制音频或仅录制视频时请不要将 `mixedVideoAudio` 设为 `2`。 - 仅录制音频或同时录制音视频时,生成的音频文件新增 MP3 格式,且支持只生成 MP3 格式的音频文件。详见[命令行录制](/zh-CN/realtime-media/local-server-recording/build/legacy/record-by-cmd)。 ::: ### 设置音视频编码配置 [#设置音视频编码配置] 合流模式下,你可以自己设置录制文件的音视频编码配置。 #### 音频编码配置 [#音频编码配置] 设置 `audioProfile` 参数,设置音频编码模式、采样率、声道数和码率。 - `0`:默认音频设置,采样率 48 kHz,单声道,编码码率为 48 Kbps。 - `1`:高音质,采样率 48 kHz,单声道,编码码率 128 Kbps。 - `2`:高音质立体声,采样率 48 kHz,双声道,编码码率 192 Kbps。 #### 视频编码配置 [#视频编码配置] 设置 `mixResolution` 参数,格式为:`width, height, fps, Kbps`,从左至右分别对应合流视频的宽、高、帧率和码率。默认的视频编码配置为 `360`, `640`, `15`, `500`。推荐的视频编码配置请参考[分辨率、帧率和码率对照表](/zh-CN/realtime-media/local-server-recording/build/legacy/set-output-video#分辨率帧率和码率对照表)。 ### 设置合流布局 [#设置合流布局] 在合流模式录制多人视频时,你可以通过 `layoutMode` 参数设置频道内所有发流用户画面的大小及其在视频画布上的位置,进行[合流布局](/zh-CN/realtime-media/local-server-recording/build/legacy/set-layout)。默认设置为 `0`(悬浮布局)。 ## 命令行示例 [#命令行示例] 以下命令行展示合流录制模式下录制一个直播频道里的音视频,音频编码配置为高音质,视频编码配置为 `640`, `480`, `15`, `1000`,合流布局设为 `1`(自适应布局)。 ```shell ./recorder_local --appId <你的 App ID> --channel <待录制的频道名> --channelProfile 1 --uid 0 --appliteDir ~/Agora_Recording_SDK_for_Linux_FULL/bin --isMixingEnabled 1 --mixedVideoAudio 2 --audioProfile 1 --mixResolution 640,480,15,1000 --layoutMode 1 ``` ## 开发注意事项 [#开发注意事项] 如果某用户中途停止发流或退出频道,该用户画面会显示为背景色。