Call
  • Web
    • Overview
      • Product Introduction
      • Activate the Service
      • 价格中心
        • 免费时长
        • Call 包月套餐
        • 订阅套餐时长计费说明
    • Get Started
      • Run Sample Code
      • Integration (React)
      • Integration (Vue3)
      • Secure authentication with userSig
    • Basic Features
      • UI Customization
      • Configuring Nickname and Avatar
      • GroupCall
      • 悬浮窗
      • 自定义铃声
      • 设置分辨率和填充模式
      • 监控通话状态
    • Advanced Features
      • 虚拟背景
      • AI 降噪
      • 云端录制
    • 客户端 API
      • UIKit APIs
        • API Overview
        • TUICallKit
      • Engine APIs
        • TUICallEngine
        • TUICallEvent
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • FAQs
      • All Platfroms
      • Web
      • ErrorCode
      • 发布说明
  • Android
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • 跑通 Demo
      • 集成
      • Secure authentication with userSig
    • Basic Features
      • UI 定制
      • 离线通话推送
      • Configuring Nicknames and Avatars
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 更多功能
      • 虚拟背景
      • AI 降噪
      • 云端录制
    • 客户端 API
      • UIKit APIs
        • 接口概述
        • TUICallKit
        • TUICallObserver
        • 类型定义
      • Engine APIs
        • TUICallEngine
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • FAQs
      • All Platforms
      • Android
      • ErrorCode
      • 发布说明
  • iOS
    • Overview
      • Product Introduction
      • Activate the Service
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • 跑通 Demo
      • 集成
      • Secure authentication with userSig
    • Basic Features
      • UI 定制
      • 离线通话推送
        • VoIP
        • APN
      • 设置昵称和头像
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 更多功能
      • 虚拟背景
      • AI 降噪
      • 云端录制
    • 客户端 API
      • UIKit APIs
        • 接口概述
        • TUICallKit
        • TUICallObserver
        • 类型定义
      • Engine APIs
        • TUICallEngine
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • FQAs
      • All Platform
      • iOS
      • ErrorCode
      • 发布说明
  • Flutter
    • Overview
      • 产品概述
      • 开通服务
      • Pricing
        • Free Minutes
        • Call Monthly Packages
        • Billing Explanation for Subscription Package Duration
    • Get Started
      • 跑通 Demo
      • 集成
      • Secure authentication with userSig
    • Basic Features
      • UI 定制
      • 离线通话推送
        • 通知
        • VoIP(可选)
      • 设置昵称和头像
      • 群组通话
      • 悬浮窗
      • 自定义铃声
      • 监控通话状态
    • 更多功能
      • 虚拟背景
      • AI 降噪
      • 云端录制
      • 美颜特效
    • 客户端 API
      • 接口概述
      • TUICallKit
      • TUICallEngine
      • TUICallObserver
      • 类型定义
    • 服务端 API
      • 通话状态回调
        • 通话状态回调
        • 通话事件回调
        • 回调配置
          • 回调配置接口列表
          • 创建回调配置
          • 查询回调配置
          • 更新回调配置
          • 删除回调配置
      • REST 接口
        • REST 接口简介
        • 通过 callId 获取记录
        • 通过条件获取记录
    • FQAs
      • All Platform
      • Flutter
      • ErrorCode
      • 升级
      • 发布说明
Call

云端录制

本文将介绍如何开启 TUICallKit 的云端录制,方便重要通话的存档、审核等,我们提供了两个方案供您选择:自动录制方案REST API 录制方案
说明:
TUICallKit 整合有多个腾讯云基础的 PaaS 服务,其中音视频相关能力依赖于实时音视频 TRTC,因为 TUICallKit 的云端录制功能需要进入 实时音视频控制台 进行配置。

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

我们推荐您使用自动录制的方案,录制不需业务方来启动和停止,由腾讯云实时音视频后台来管理录制任务,通话过程中有音视频流上行时就自动录制,接入过程快速、简单,您可以通过如下几步完成:
1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,进入高级功能配置页。
2. 高级功能配置页,您可以看到云端录制配置的选项,点击全局自动录制进入配置浮窗。



3. 根据音视频通通话的业务场景(1v1通话、群组通话),我们推荐如下配置参数,当然您也可以根据自己的业务需求配置自定义录制模版。



注意:
全局录制支持最大混流人数为 8,若您的通话人数超过8时(包括自己),最后一个用户的流无法录制。
开启全局自动录制功能后,在通话接听后且有音视频上行,就会触发自动启动录制任务,在通话结束后会自动停止录制,如果因为网络或者其他情况异常退房,我们的录制后台会根据您设置的 MaxIdleTime值(空闲等待时间,默认5s)自动停止录制任务,避免造成额外的计费损失。
4. 模版创建完成后,勾选全局自动录制即可完成。

方案二:REST API 录制方案

如果自动录制方案不满足您的业务需求,您也可以采用更加灵活的 REST API 录制方案,可以指定录制订阅房间内的主播,自定义合流布局,录制中途更新布局和订阅等,但是需要搭配业务后台服务,接入复杂,功能强大,关键步骤如下
1. 实时音视频控制台 > 应用管理 找到对应 SDKAppId 的应用,进入高级功能配置页。
2. 高级功能配置页,您可以看到云端录制配置的选项,启用云端录制功能,此时默认勾选手动自定义录制,即 REST API 模式。



3. 然后您就可以调用 REST API (CreateCloudRecording)来启动云端的录制,这里建议您可以通过监听 TUICallObserver 的通知事件,在音视频通话开始的时候开启录制,以 Java 代码为例:
TUICallEngine.createInstance(context).addObserver(new TUICallObserver() {
@Override
public void onCallBegin(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType, TUICallDefine.Role callRole) {
// 通知您的业务后台,使用REST API 启动录制任务。
}
});
4. 考虑到客户端有可能会存在网络差、杀进程的情况造成的通话异常挂断,所以如何结束录制,建议您可以通过订阅 TRTC 房间状态的回调(详情请参见 监听服务端事件回调),在收到 TRTC 房间状态解散的回调后,调用 REST API (DeleteCloudRecording)来停止云端的录制任务。

常见问题

1. 如何查看录制时长明细?

您可以在 实时音视频控制台 > 云端录制查看录制的一些时长明细。

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

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