tencent cloud

文档反馈

云端录制(TUIRoomKit)

最后更新时间:2024-04-17 18:02:53
    本文将介绍如何快速使用 TUIRoomKit 云端录制功能,帮助开发者在视频会议、在线教育、直播互动等场景中,实现对重要内容进行存档、审核等多样化需求。我们提供了两个方案供您选择:自动录制方案REST API 录制方案

    方案一:自动录制方案(推荐)

    我们推荐您使用自动录制的方案,录制不需业务方来启动和停止,由腾讯云实时音视频后台来管理录制任务,通话过程中有音视频流上行时就自动录制,接入过程快速、简单,您可以通过如下几步完成:
    1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,进入高级功能配置页。
    2. 高级功能配置页,您可以看到云端录制配置的选项,点击全局自动录制进入配置浮窗。
    
    
    
    3. 在配置浮窗中,您可以根据自己的业务需求配置自定义录制模版。
    
    
    
    说明:
    全局自动录制仅支持 单流录制(即每个主播单个录制一个文件),开启后只对新创建的房间有效,对开启自动录制功能之前已经创建的房间不生效。如需录制多路流混合后的画面,请使用REST API 录制方案
    全局自动录制支持最多录制一个房间内的25个主播,如果超过25个主播将会按照进房时间由先到后排序,录制前25位主播(如需单流录制超过25位主播,请参见 REST API 录制方案)。
    开启全局自动录制功能后,在会议开始后且有音视频上行,就会触发自动启动录制任务,在会议结束后会自动停止录制,如果因为网络或者其他情况异常退房,我们的录制后台会根据您设置的 MaxIdleTime值(空闲等待时间,默认5s)自动停止录制任务,避免造成额外的计费损失。
    

    方案二:REST API 录制方案

    如果自动录制方案不满足您的业务需求,您也可以采用更加灵活的 REST API 录制方案,可以指定录制订阅房间内的主播,自定义合流布局,录制中途更新布局和订阅等,但是需要搭配业务后台服务,接入复杂,功能强大,关键步骤如下
    1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,进入高级功能配置页。
    2. 高级功能配置页,您可以看到云端录制配置的选项,启用云端录制功能。这里建议关闭全局自动录制,此时默认为手动自定义录制,即 REST API 模式。
    
    
    
    3. 之后,您可以调用 REST API (CreateCloudRecording)来启动云端的录制,这里建议您可以通过监听 TUIRoomObserver 的通知事件,在会议开始时开启录制。
    说明:
    手动录制下,您可以前往控制台配置回调地址,以接受录制回调事件,请见 录制回调说明
    
    
    

    常见问题

    1. 两种录制方案可以同时使用吗?

    自动录制方案 REST API 录制方案这两种方案并不冲突,可以同时使用两种录制方案,但会产生两份录制文件和 费用

    2. 如何查看录制的文件?

    您可以登录 云点播控制台,在左侧导航栏选择媒资管理,单击列表上方的前缀搜索,选择前缀搜索,在搜索框输入关键词,录制文件命名规则如下:
    单流录制 MP4 文件名规则: <SdkAppId>_<RoomId>_UserId_s_<UserId>_UserId_e_<MediaId>_<Index>.mp4
    合流录制 MP4 文件名规则: <SdkAppId>_<RoomId>_<Index>.mp4
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持