录制管理(新录制)

最近更新时间:2023-10-25 14:51:32

我的收藏
2022年08月01日起新创建的应用(SdkAppId)录制功能类型为新版云端录制。若您当前的 TRTC 应用(sdkappid)使用的是旧版云端录制,详情请参见 旧版云端录制,下文将针对实时音视频最新推出的新版云端录制功能的使用进行说明。
说明:
判断当前应用(SdkAppId)的云端录制的类型和旧版云端录制能力,可进入控制台 > 应用管理页面内具体应用查看,若存在录制管理目录,则当前应用的云端录制类型为 新版云端录制,若不存在则当前应用的云端录制类型为 旧版云端录制。请根据您当前应用的录制类型查看对应的功能说明文档。





前置说明

1. 新版云端录制功能是由 TRTC 联合云点播 VOD 提供的录制文件保存功能,所以使用录制功能请先前往控制台开通 云点播VOD 服务,且保证云点播服务可用,否则仍会产生 TRTC 录制用量,但文件可能会保存失败。
2. 新版云端录制功能支持将录制文件存储至云点播 VOD 和对象存储 COS,如需使用录制功能请前往 云点播 VOD 或 对象存储 COS 开通对应服务,同时录制文件存储费用由云点播或对象存储收取,详细计费规则参见 云点播 > 存储价格说明 ,对象存储 > 存储价格说明 。
特别说明:
若您选择存储至对象存储 COS 将会收取录制文件投递至 COS 的费用,详见 投递费用说明 ,存储至云点播 VOD 将不收取此项费用。
3. 根据国家《网络表演经营活动管理办法》及《网络交易监督管理办法》的最新规定,经营单位需记录网络直播视频内容并进行存储备份,保存时长根据直播类型建议存储60日至3年。

录制模板管理

启用云端录制

新版云端录制,支持将房间中每一个主播的音视频都录制成一个独立的文件(单流录制),也支持将房间内的多个主播的音视频混合录制成一份文件(合流录制),若您想了解具体的实现方法,请参见 实现云端录制与回放。新版云端录制功能使用前请先前往 控制台 开启云端录制,如下图:




全局自动录制

新版云端录制提供了一种无需手动发起并管理录制任务的自动录制方式,要使用该种录制方案,需完成全局自动录制模板配置并开启全局自动录制,您不需要开发控制录制任务的发起和结束。开启「全局自动录制」等待5分钟 - 10分钟生效后,TRTC 房间中的主播上行音视频后将触发启动录制任务,房间内主播都退房且超过设置的等待续录时间后将触发停止录制任务。



开启全局自动录制功能前请配置全局自动录制模板,全局自动录制支持 单流模式。开启后只对新创建的房间有效,对开启自动录制功能之前已经创建的房间不生效。

单流录制

全局单流录制格式支持音视频录制、纯音频录制和纯视频录制,录制文件支持 MP4、HLS 和 AAC(纯音频录制格式下) ,录制文件切片策略请参见 录制文件切分说明
配置项
说明
录制模式
单流录制:房间中的每个主播的视频画面都会单独保存成一份文件。
合流录制:房间中的所有主播的视频画面都会混合成一份文件进行录制。
录制格式
音视频格式:录制房间内的音频和视频流,适用于视频通话、互动直播场景。
纯音频格式:只录制房间内的音频流。
文件格式
支持 MP4 、HLS 和 AAC(纯音频格式下)。
单个录制文件时长
可用于指定录制文件切片时长,设置范围1分钟 - 1440分钟,默认1440分钟。
续录等待时长
设置续录超时时长,当打断间隔不超过设定的续录超时时长时,一次通话(或直播)只会生成一个文件,但需要等待续录时间超时后才能收到录制文件,单位为秒,取值范围5 - 86400。(续录期间会收取音频费用,请合理设置续录时长。)
注意:合流模式下,续录等待期内会补黑帧和静音帧继续录制,单流模式下则不会录制。在续录等待期内,单流和合流录制会按照音频时长收取录制费用。
录制文件存储
支持存储至 云点播 VOD对象存储 COS
云点播:需支持指定云点播应用、录制文件在云点播的存储时间以及绑定点播任务流。
对象存储:存储至 COS 的服务由云点播联合提供,如需存储至 VOD,您需授权给 VOD 相关 COS 桶的读写权限,并需要完成您的存储桶 bucket 和云点播应用的绑定,绑定后云点播会为您创建一个应用,通过选择这个绑定的应用,可完成指定的存储桶设置。



说明:
单流录制模式下房间内的音视频流将按照推流参数进行每一路单独录制,无需设置转码。
续录等待时长未到期内录制机器人会在房间内继续等待主播上行进而完成录制,并不会因为主播退房后就立即结束,请合理设置。



注意:
单流录制最多录制一个房间内的25个主播,如果超过25个主播将会按照进房时间由先到后排序,录制前25位主播(如需单流录制超过25位主播,请参见 API 录制)。
续录等待时间默认为5s,房间内无主播的时间超过设置的续录时间,将会分成多个录制任务,对应的录制文件也是独立的,房间内无主播的时间未超过续录时间,那么录制任务保持,录制文件不切分。

手动自定义录制

若您只需要使用指定某些房间发起录制任务,您可以通过 CreateCloudRecording 手动调用发起录制任务。
注意:
新版云端录制功能开启后,默认打开「手动自定义录制」且不支持关闭,「手动自定义录制」,只会根据您的发起产生录制用量,若您只需使用手动自定义录制,请关闭全局自动录制即可。

修改云端录制配置

新版云端录制支持手动自定义录制和全局自动化录制,其中手动自定义录制默认开启,您需要通过 TRTC 提供 REST ful API 进行手动发起录制和控制录制结束,如需使用请参见 手动自定义录制;同时提供全局自动化录制,您可以通过配置全局自动录制模板,让TRTC录制服务帮您完成当前应用下的所有房间内的音视频录制,详情请参见 全局自动化录制
您可以结合您的业务需求,选择手动录制和自动录制(使用自动录制前,请先创建全局录制模板),两种方式可同时使用,将会产生两份文件和费用。
如需开启全局自动录制,请完成全局自动录制模板创建并打开全局自动录制开关,如需修改模板请点击编辑。


说明:
如需使用全局自动录制,请先创建全局自动录制模板。
目前新版云端录制支持录制 MP4 和 HLS 格式的音视频文件和纯音频 AAC 和 HLS 格式文件。

关闭云端录制功能

新版云端录制功能开启后,默认打开「手动自定义录制」且不支持关闭,「手动自定义录制」,只会根据您的发起产生录制用量,若您只需使用「手动自定义录制」,请关闭「全局自动录制」即可。

录制文件管理

TRTC 支持直接查询和管理通过新版云端录制功能产生的文件,录制完成后,我们会将文件上传至您指定的存储位置,上传完成后,您便可查看。
通过筛选您指定存储的云点播 VOD 应用,可筛选查看对应的录制结果文件。



通过单击文件名称,您可以查看详细的文件信息,包括预览视频,获取文件 URL 以及下载文件等操作。



说明:
1. 当前页面可检索查看存储至云点播 VOD 和使用全局自动录制存储至 COS 的文件,若您使用 API 录制存储至 COS,请前往 对象存储 COS 查看录制文件。
2. 根据录制文件的大小不同,上传文件所需时间可能存在30秒至数分钟的延迟,您可以订阅录制回调事件,获取文件成功上传时间。
3. 旧版云端录制功能不支持在当前页面查询录制文件,旧版录制功能 查找录制文件