简介

Agora 云端录制,可为 Agora 实时音视频提供录制服务。同 Agora 本地服务端录制相比,Agora 云端录制无需部署 Linux 服务器,减轻了研发和运维的压力,更轻量便捷。点击云端录制产品概述了解关键特性。

兼容性

Agora 云端录制与以下 Agora SDK 兼容:

SDK 描述
Agora Native SDK 云端录制与全平台 Agora Native SDK 1.7.0 或更高版本兼容,如果频道内有任何人使用了 1.6 版本的 Agora Native SDK, 则整个频道无法录制。
Agora Web SDK 云端录制与 Agora Web SDK 1.12.0 或更高版本兼容。

2020.09.16

该版本进行了性能优化及服务稳定性优化,并修复了如下问题:

  • 订阅小流不生效。
  • 偶现的部分内容未被录制的问题。

2020.07.21

本次发布的新增特性和 API 变更如下:

新增特性

阿里视频点播服务

在合流模式下,支持将录制文件上传至阿里视频点播服务(VoD)。

API 变更

  • start 方法中新增了 extensionServiceConfig 参数,用于指定阿里视频点播服务的配置。
  • 新增 vod_started 回调和 vod_triggered 回调,提供阿里视频点播服务上传模块的状态。

2020.06.12

本次发布的新增特性和 API 变更如下:

新增特性

灵活的 UID 订阅

提供更为灵活的 UID 订阅,支持设置音频和视频的订阅白名单或黑名单,以及在录制过程中更新订阅名单。详见设置订阅名单

高可用的回调

该版本增加了 session_failover 回调,在启用高可用机制后触发,返回启用高可用机制后的新录制 UID。

API 变更

  • start 方法中新增了 unSubscribeVideoUidsunSubscribeAudioUids 参数,用于指定订阅黑名单。
  • 新增 update 方法,用于在录制过程中更新订阅名单。
  • 新增 session_failover 回调。

2020.05.09

本次发布新增了对金山云存储的支持。

2020.04.17

本次发布新增了截图功能,详见视频截图

2019.12.16

本次发布提高了云端录制服务的可用性。当出现服务器断网、进程被杀时,云端录制会自动切换到新的服务器,在短时间内恢复录制服务。详情见云端录制服务器断网、进程被杀的处理

API 变更

acquire 方法中新增了 resourceExpiredHour 参数,用于设置云端录制 RESTful API 的调用时效。

RESTful API 回调通知中新增事件 session_exit,提供云端录制服务的退出状态。

2019.11.15

调用 start 方法后,你可以通过 query 请求立刻获得录制文件名,而不再需要等待 15 秒。

2019.10.24

本次发布新增了对腾讯云存储的支持。

2019.10.08

本次发布的新增特性、改进及修复问题如下:

新增特性

1. 单流录制

RESTful API 新增单流录制模式,支持分开录制每个 UID 的音频流和视频流。使用方法详见单流录制。同时,Agora 提供了音视频合并脚本,用于合并单流录制模式下生成的音频和视频文件。使用方法详见音视频文件合并

2. 录制指定 UID 的音视频流

RESTful API 新增 subscribeAudioUidssubscribeVideoUids 参数,支持录制指定 UID 的音视频流。

3. 自定义录制文件存储路径

RESTful API 新增 fileNamePrefix 参数,支持指定录制文件在第三方云存储的存储位置。

4. 频道状态变化的时间戳

RESTful API 回调通知中新增事件 recorder_audio_stream_state_changedrecorder_video_stream_state_changed,提供音频流和视频流状态变化的时间,和该路流对应的 UID。

5. 音视频格式转换脚本

Agora 提供了音视频格式转换脚本,用于 TS、MP3、MP4 等文件格式之间的转换。使用方法详见音视频格式转换

6. 同步回放

通过 RESTful API 回调或解析 M3U8 文件,你可以获取录制开始时的时间戳,从而将录制的音视频和其他数据流文件(白板、课件、课堂聊天记录等)同步回放。详情见同步回放

改进

在出现错误时,你会在 HTTP 响应包体内收到相应的错误信息,而不只是错误码。错误码详情见云端录制 RESTful API

问题修复

如果因为第三方云存储的 bucketkey 参数值错误导致上传失败,云端录制服务将会直接报错,而不再将切片文件上传至 Agora 云备份。

2019.07.19

本次发布的新增特性、改进及修复问题如下:

新增特性

自定义合流布局

RESTful API 新增自定义的合流布局。使用方法详见自定义合流布局

你可以在开始录制时将 mixedVideoLayout 设为 3,并在 layoutConfig 中设置每个用户的画面大小和位置。你也可以在录制过程中调用 updateLayout 方法随时更新合流布局。

自定义背景色

RESTful API 新增 backgroundColor 参数,支持自定义合流的画布背景色。无论使用何种合流布局,都可以通过该参数设置画布的背景色。

录制的时间戳

为方便开发者获得精准的录制开始时间,RESTful API 提供录制开始第一片切片的 Unix 时间戳 sliceStartTime,可以通过 query 方法查询获得。同时在 RESTful API 的回调通知中新增事件 recorder_slice_start,提供第一片录制切片开始的时间和上一次录制失败的时间。

改进

RESTful API 优化了对 resourceIdcname 以及 uid 是否对应的检查。

修复问题

修复了默认的合流布局中存在的一些小问题。

2019.07.02

  • 将合流布局默认背景色修改为黑色。
  • 改善了在弱网环境下录制的视频卡顿问题。

2019.06.13

本次发布主要新增了对 RESTful API 的支持,无需集成 SDK,直接通过网络请求来控制云端录制。

你可以参考下面的文档使用 RESTful API:

2019.04.29

本次发布主要包括以下功能:

  • Agora Native SDK 和 Agora Web SDK 的高清音视频通话的录制
  • 频道内所有用户的音视频合流录制
  • 支持 3 种合流布局样式:Float(默认布局)、BestFit(自适应布局)、Vertical(垂直布局)。
  • 第三方云存储,目前支持七牛云、阿里云和 Amazon S3
  • 提供 C++ 和 Java SDK 包