即时通信 IM 直播录制

一、功能说明

你在使用该功能前需要提前配置好你的录制存储地址，随后可以在创建 TUILiveKit 直播间时决定当前房间是否需要录制，开启录制后，录制文件将默认存储在你配置好的存储地址中。具体细节请参考下述内容。

二、适用范围

TUILiveKit 的直播录制功能仅对同时满足以下条件的直播间生效：

·通过 TUILiveKit 创建的房间。

·TUILiveKit 房间的 isUnlimitedRoomEnabled 字段为 true。你在创建房间时选择不同房间模板的 isUnlimitedRoomEnabled 默认值如下：

Template Case	isUnlimitedRoomEnabled	场景说明
.videoDynamicGrid9Seats	true	竖屏动态九宫格
.videoDynamicFloat7Seats	true	竖屏 1v6 浮动
.videoFixedGrid9Seats	true	竖屏静态九宫格
.videoFixedFloat7Seats	true	竖屏静态 1v6
.videoLandscape4Seat	true	横屏 4 人麦位
.karaoke	false	语音 KTV
.audioSalon	false	语音沙龙

根据以上录制规则，实际录制的音视频内容如下：

·视频直播：单主播情况下录制单主播的音视频单流；多主播情况下录制多主播的音视频混流，最终生成一份完整的录制文件。

·语聊房：默认 isUnlimitedRoomEnabled 为 false，因此不支持录制，如需开启，请联系我们。

注意：当 LiveKit 房间的 isUnlimitedRoomEnabled 字段设置为 true 时，若直接使用 TRTC 云端录制的全局自动录制功能，可能会导致相同音视频内容被重复录制两次，从而产生额外成本。因此，在该场景下，建议优先使用 LiveKit 录制能力。如 LiveKit 录制功能不满足你的需求，可参考 TRTC 手动录制实现录制。

三、步骤1：前往控制台配置录制文件存储地址

1. 前往实时音视频控制台 > 应用管理 > LiveKit 功能，点击配置房间录制。

2. 点击立即配置。

3. 在配置页面内进行录制配置。

配置项说明请参考下表。

配置项	说明
存储位置	必填。可选存储至云点播（VOD）或对象存储（COS）。
全房间录制	用于一键开启当前 SDKAppID 下所有房间的录制。开启后，系统将自动为当前 SDKAppID 下所有符合以下条件的直播间开启录制：直播间满足前述的适用范围。创建直播间时，IsCloudRecordEnabled 为空（默认）或显式设置为 true，详见下述步骤 2。

注意：IsCloudRecordEnabled 参数的默认值为空。若将其设为 false，即使开启全房间录制，该房间也不会被录制。

四、步骤2：创建房间时设置录制参数

你可以在创建房间（RoomInfo）时通过设置 IsCloudRecordEnabled 决定当前房间是否录制，其具体行为取决于参数的取值，如下所示：

参数值	描述	房间录制行为
空	默认值	遵循全房间录制设置。即，若此时直播间满足适用范围，同时你在步骤 1 中开启了全房间录制，则当前房间会被录制，否则不会录制。
true	明确开启录制	此时若直播间满足适用范围，则无论全房间录制设置如何，当前房间都会开启录制。
false	明确关闭录制	强制不录制。即使你在步骤一中开启了全房间录制，该房间也不会录制。

注意：请保证步骤 1 中的必填项“指定点播应用”与“录制文件保存时长”已顺利完成配置，否则即使执行本步骤，也无法顺利开启录制。

五、录制结果

你可以前往控制台实时音视频控制台 > 应用管理，在录制管理 > 录制文件管理中，查看并管理存储于云点播（VOD）中的录制文件。

注意：录制文件管理页面仅支持查看存储于云点播（VOD）的录制文件，无法查看你指定存储在对象存储（COS）中的文件。如需查看存储于对象存储（COS）的录制文件，请前往对象存储（COS）控制台。

录制的默认参数如下：

特征项	描述
录制时长	开启录制功能后，将录制直播间从创建到解散的全程。单个文件最大时长为1440分钟，超过时长会出现断录情况，续录的等待时间为30秒。暂不支持在直播的中途开始或结束录制。
录制文件格式	MP4。

若上述特征不满足你的需求，你也可以参考 TRTC 的云端录制进行录制。

注意：当前录制最大并发支持500路，如果你需要更高并发量，请联系销售或提交工单申请技术支持。

六、计费说明

TUILiveKit 的直播录制功能涉及费用如下：

计费内容	说明	计费参考
云端录制费用	录制音视频内容时产生的费用，默认使用 TRTC 云端录制的单流录制。	录制费用与录制时长及画面分辨率相关，详细的计费规则、价格说明等可参考 TRTC 云端录制，其中计费价格参考单流录制的价格。
录制投递费用	录制投递服务用于将录制文件投递至指定存储桶。选择存储位置为对象存储 COS 时，将按照录制投递至腾讯云 COS 计费。	录制完成后，系统将录制文件投递至指定存储服务，并按录制文件的输出时长计费，详细的计费说明、价格说明可参考录制文件投递费用。
文件存储费用	录制文件存储费用由对应的存储服务（云点播、对象存储）收取。	详细的计费规则、价格，云点播（VOD）参考媒资管理的标准存储，对象存储（COS）参考对象存储计费。

七、TUILiveKit 直播录制与 TRTC 云端录制的区别？

TUILiveKit 的直播录制服务底层使用的是 TRTC 云端录制服务，只是录制对象均为 TUILiveKit 的房间，同时提供接口方便你在创建直播房间的时候直接开启录制，简化你开启录制的步骤；特别是在多主播场景下，可以仅录制一份多主播混流后的文件，不会出现重复录制问题，也无需手动进行混流参数配置。

对比项	LiveKit 直播录制	TRTC 云端录制
录制范围	适用于当前 SDKAppID 下的 TUILiveKit 房间。	适用于当前 SDKAppID 下的 TRTC 房间。
录制方式	方法一：控制台开启全房间录制。方法二：创建房间时通过参数开启录制。	方法一：控制台开启全局自动录制。方法二：通过 REST API 手动录制。
录制文件	两种录制开启方式均只录制一条音视频流：视频直播：单主播场景录制单主播的音视频单流；多主播场景录制多主播的音视频混流。语聊房：默认不支持录制，如需开启，请联系我们。	录制方式不同，录制的流会不同：全局自动录制：每个主播的音视频流单独录制，得到多个主播的单独视频文件。REST API 方式：手动选择单流或合流录制。
存储服务	可使用云点播 VOD、存储对象 COS 进行存储。	自主配置存储服务。

八、TUILiveKit 直播录制的“全房间录制”和 TRTC 云端录制的“全局自动录制”的区别？

录制范围	TUILiveKit 直播录制的全房间录制	TRTC 云端录制的全局自动录制
录制的房间	仅录制当前 SDKAppID 下，使用 TUILiveKit 创建的房间。使用 TUICallKit、TUIRoomKit 和 TRTC SDK 集成后创建的房间均不会被录制。	录制当前 SDKAppID 下所有的 TRTC 房间，包含所有使用 TUICallKit、TUILiveKit、TUIRoomKit 和 TRTC SDK 集成后创建的房间。
录制的内容	仅录制视频直播房间，单主播场景录制单主播的音视频单流；多主播场景录制多主播的音视频混流；默认不录制语聊房内容，如需开启，请联系我们。	录制所有的主播音视频流，每个主播录制一个单独的文件

九、开启 TRTC 云端录制后，是否会影响开启 LiveKit 录制？

TRTC 云端录制和 LiveKit 录制功能相互独立，两者可以同时开启。开启后，TRTC 和 LiveKit 会分别进行录制，互不干扰。

十、不使用 TUILiveKit 录制，直接使用 TRTC 云端录制时需要注意什么？

如果未使用 LiveKit 录制能力，而使用了 TRTC 云端录制的全局自动录制能力，可能会出现同一音视频内容被重复录制的情况，从而带来额外成本。因此，在该场景下，建议优先使用 LiveKit 录制能力。如 LiveKit 录制无法满足业务需求，可参考 TRTC 手动录制方式进行录制控制。