云端录制 Beta
  • 平台类型
  • 框架 / 引擎
  • iOS
  • Android
  • macOS
  • Windows
  • Linux
  • Web
  • 小程序

单流录制

更新时间:2020-11-13 11:05

1 功能描述

云端录制支持如下两种录制模式:

  • 单流录制:分别录制房间内每条音视频流、白板,每条音视频流都会生成对应的音视频文件,所有白板会生成一个视频文件。
  • 混流录制:房间内所有音视频流、白板混合录制成一个音视频文件。

本文介绍如何通过使用云端录制 RESTful API 进行单流录制。

2 实现方法

在调用 start 方法时,将 record_mode 参数设为 “1” 即可启用单流录制模式。

通过将 output_file_format 参数设为 “mp4”、“flv” 或 “hls” 可以生成对应格式的视频文件。假设 output_file_format 设为 “mp4” ,根据录制内容的不同,生成的文件如下:

录制内容 参数设置 录制生成文件
仅录制音频 stream_type 设为 “1” 每个 streamID 生成一个 mp4 文件,mp4 文件内仅存储该 streamID 的音频数据。
仅录制视频 stream_type 设为 “2” 每个 streamID 生成一个 mp4 文件,mp4 文件内仅存储该 streamID 的视频数据。
录制音视频(合并) stream_type 设为 “3” 每个 streamID 生成一个 mp4 文件,mp4 文件内存储该 streamID 的音视频数据。
录制音视频(分离) stream_type 设为 “4” 每个 streamID 生成一个 mp4 文件和一个 aac 文件,mp4 文件内仅存储该 streamID 的视频数据,aac 文件内仅存储该 streamID 的音频数据。
  • stream_type 仅适用于音视频流,所有白板会录制生成另一个 mp4 文件,该 mp4 文件内仅存储白板的视频数据。
  • 目前 hls 格式暂不支持单流录制白板和录制音视频(分离)。

3 请求示例

Content-type 为 application/json;charset=utf-8,start 请求包体内容如下:

{
    "app_id": 0000,
    "access_token": "xxxx",
    "room_id": "xxxx",
    "record_input_params": {
        "record_mode": 1,
        "stream_type": 3,
        "max_idle_time": 60
    },
    "record_output_params": {
        "output_file_format": "mp4",
        "output_folder": "record/"
    },
    "storage_params": {
        "storage_provider": 2,
        "region": "oss-xxxx",
        "bucket_name": "xxxx",
        "access_key_id": "xxxx",
        "access_key_secret": "xxxx"
    }
}