功能描述

本地服务端录制支持两种模式:

  • 单流录制模式:(默认录制模式)分开录制频道内每个 UID 的音频流和视频流。每个 UID 均有其对应的音频文件和视频文件。
  • 合流录制模式:频道内所有或指定 UID 的音视频混合录制为一个音视频文件;或频道内所有或指定 UID 的音频混合录制为一个纯音频文件,所有或指定 UID 的视频混合录制为一个纯视频文件。

本文介绍如何通过命令行的方式进行单流录制

阅读本文前,请确保你已经完成录制 SDK 的环境准备和集成工作并且了解如何使用命令行开始录制,详见集成客户端命令行录制。单流或合流模式的设置必须在开始录制的时候完成,不支持在录制开始后切换模式。请参阅单流录制模式和合流录制模式的区别来决定应使用哪种模式。

为方便起见,本文我们假设频道内每个用户都发送音频和视频。如果有用户没有发送音频或视频(例如直播频道中的观众),一般不会生成该用户的音频或视频录制文件(Web 端例外)。

实现方法

单流模式为默认的录制模式,因此无需额外设置,直接开始录制即可使用单流模式。

该模式下录制文件的音视频编码配置如下:

  • 音频编码配置:采样率固定为 48 kHz,声道数和码率与原始音频流一致。
  • 视频编码配置:与原始视频流一致。

根据录制内容的不同,录制生成的文件如下表所示:

录制内容 参数设置 录制生成文件
仅录制音频 --isAudioOnly 1 每个 UID 生成一个 AAC 音频文件
仅录制视频 --isVideoOnly 1
  • Native 端每个 UID 生成一个 MP4 视频文件
  • Web 端每个 UID 生成一个 WebM 或 MP4 视频文件
  • 同时录制音视频 默认设置
  • Native 端每个 UID 生成一个 AAC 音频文件和一个 MP4 视频文件
  • Web 端每个 UID 生成一个 AAC 音频文件和一个 WebM 或 MP4 视频文件
  • 其中 Web 端用户的视频文件格式取决于 Web 用户的 codec 设置:

    • codec"vp8", 视频文件格式为 WebM
    • codec"h264",视频文件格式为 MP4

    命令行示例

    以下命令行为单流录制模式下录制一个通信频道内的视频。

    ./recorder_local --appId <你的 App ID> --channel <待录制的频道名> --uid 0 --appliteDir ~/Agora_Recording_SDK_for_Linux_FULL/bin --isVideoOnly 1

    开发注意事项

    • 单流模式下每个 UID 的音频和视频均分开录制,如需合成每个 UID 的音视频,需要通过 video_convert.py 脚本进行转码,详见合并音视频文件
    • 单流模式下,如果用户中途离开频道后重新加入频道或者停止发送数据一段时间后恢复发送,均可能导致录制文件切片。具体情况详见录制文件切片
    • 如果录制内容选择“仅录制视频“或”同时录制音视频“,但是 Web 端的用户没有发送视频,也会生成视频录制文件,录制黑屏。