含 UI 集成方案

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT
应用创建成功后,您可通过功能配置为您当前的应用开启 旁路转推云端录制高级权限控制 功能,该页面所有功能配置修改成功后大约5分钟生效。

旁路转推配置

注意事项

基于 UDP 传输协议的 TRTC 服务,通过协议转换将音视频流对接到 云直播 系统,这个过程称之为“旁路转推”。
旁路转推功能默认关闭,开启旁路转推功能需先开通云直播服务。
将旁路转推用于 CDN 直播观看 时,云直播将会按直播观看产生的下行流量/带宽收取相关费用,详见 云直播>流量带宽计费 说明。
您可以使用旁路转推将音视频推流至云直播,使用云直播的录制能力完成录制,将会产生录制、录制文件存储等费用,详见 云端录制与回放>相关费用 说明。
若您在 云直播控制台 给旁路转推使用的转推域名(xxxx.livepush.myqcloud.com)绑定了录制、转码、截图鉴黄、水印等收费功能的模板,则旁路转推时会产生模板对应的 增值费用

开启旁路转推功能

1. 进入实时音视频控制台,选择 应用管理
2. 选择需要修改功能配置的应用,单击目标应用所在行的功能配置。n


3. 旁路转推配置中,单击启用旁路转推右侧的按钮。n


4. 在弹出的开启旁路转推功能弹框中,仔细阅读风险说明;若确认开通,单击开启旁路转推功能即可。n



选择旁路转推方式

旁路转推功能开启 后,您可以根据实际业务情况选择旁路的转推方式:n


指定流旁路:选择“指定流旁路”后:如果不需要混流转码,请调用客户端 SDK startPublishing 接口直接发起旁路转推;如果需要混流转码,请根据 云端混流转码 文档指引操作,混流转码后会自动旁路转推。
全局自动旁路:选择“全局自动旁路”后,TRTC 所有上行音视频流都会被自动旁路转推到您所设置的转推域名下。

切换旁路转推域名

1. 您当前默认的推流域名为 xxxx.livepush.myqcloud.com/xxx.tlivecloud.com,并且支持切换您在 云直播控制台 绑定的推流域名,如需切换其他推流域名请先前往云直播控制台进行绑定。
说明
切换推流默认域名后,您之前绑定在当前推流域名的录制模板、回调模板、截图鉴黄模板和水印模板将会失效,请先将这些模板绑定至您即将切换的新推流域名,再完成切换,域名切换生效等待时间为30分钟,生效之后,新建的房间内产生的音视频将会按照新的推流域名进行转推。
2. 前往 实时音视频控制台 > 应用管理 > 功能配置 下,单击旁路转推功能处的切换。n


注意
如果您当前使用的是 旧版云端录制 功能,那么当您完成推流域名切换后,您当前应用的云端录制能力将升级为 新版云端录制 且不支持回退,请确认新版云端录制能力是否满足您的需求之后,再进行推流域名切换。

关闭旁路转推功能

如果您需要关闭旁路转推功能,具体操作步骤如下:
1. 单击 应用管理,选择需要修改功能配置的应用,单击目标应用所在行的功能配置
2. 旁路转推配置中,单击启用旁路转推右侧的按钮。n


3. 在弹出的关闭旁路转推功能弹框中,仔细阅读风险说明;若确认关闭,单击关闭旁路转推功能即可。n


注意
关闭旁路转推功能后,您当前应用的云端录制能力将升级为 新版云端录制 且不支持回退,请知悉。


云端录制配置


注意事项

目前实时音视频服务存在两种云端录制功能,新版云端录制能力通过TRTC的录制集群实现录制功能,旧版云端录制能力通过旁路转推使用 云直播 的能力为您提供全程的云端录制功能,两者都将录制下来的文件存储到 云点播 平台。(同一个应用只可使用一种录制能力,云端录制能力类型区分
新版云端录制功能使用的是实时音视频内部的能力,产生录制费用由TRTC侧收取,详细计费规则请参见云端录制计费说明,旧版录制功能使用的是云直播服务的能力,详细计费规则请参见 旧版云端录制计费说明
录制后的文件存储在云点播平台,将产生云点播的存储费用,按录制文件存储在云点播平台的存储容量计费,详细计费规则请参见 云点播 > 视频存储(日结)价格说明云点播 > 视频存储资源包价格说明
如需播放或下载录制的视频文件,将会产生云点播服务的流量(视频加速)费用,按下行加速流量计费,详细计费规则请参见 云点播 > 视频加速(日结)价格说明云点播 > 视频加速资源包价格说明
云端录制功能默认关闭,启用云端录制功能需要先开通云直播和云点播服务。
新、旧云端录制对比说明:
对比项
录制发起方式
服务端 API 录制(指定用户录制)、全局自动录制
指定用户录制、全局自动录制
录制格式
MP4、HLS、AAC
MP4、HLS、AAC
录制文件存储位置
云点播、COS等第三方存储(后续支持)
云点播
录制灵活性
新版云端录制提供一套服务端 API,支持灵活发起、调整和结束录制任务,可在录制任务过程中调整录制参数,已满足您的个性化录制需求
需要在进房时指定发起录制的用户,过程中不可修改。
录制费用

如何区分应用的录制能力类型

当前 TRTC 云端录制功能存在新版和旧版两种类型,您可以前往实时音视频控制台 > 应用管理>功能配置下,通过云端录制模块的页面样式来判断当前应用的云端录制功能类型:
新版云端录制能力如下图:



旧版云端录制能力如下图:



新版云端录制旧版云端录制功能和事件回调有所不同,请先确认您当前使用的应用的录制能力类型再进行对应的开发接入。

新版云端录制功能说明

实时音视频现已推出新版云端录制能力,截止2022年08月01日零点未开通旁路转推功能的应用和2022年08月01日后新创建的应用和默认使用新版云端录制能力,其余应用则默认保留旧版云端录制能力。为了兼容已经在使用旧版云端录制能力的客户,故对旧版能力进行了保留兼容,同时提供了升级为新版云端录制能力的方式,详情请见下文。

启用云端录制

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




修改云端录制配置


注意
修改云端录制配置可能会影响您线上正在运行的业务数据,请确认风险后谨慎操作。
新版云端录制支持手动自定义录制和全局自动化录制,其中手动自定义录制默认开启,您需要通过 TRTC 提供 REST ful API 进行手动发起录制和控制录制结束,如需使用请参见 手动自定义录制;同时提供全局自动化录制,您可以通过配置全局自动录制模板,让TRTC录制服务帮您完成当前应用下的所有房间内的音视频录制,详情请参见 全局自动化录制
您可以结合您的业务需求,选择手动录制和自动录制(使用自动录制前,请先创建全局录制模板),两种方式可同时使用,将会产生两份文件和费用。n


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

关闭云端录制功能

新版云端录制功能不可关闭,手动录制功能默认开启,全局自动录制功能您可以手动进行开启和关闭。


旧版云端录制功能说明

启用云端录制功能

旧版云端录制,可以将房间中的每一个用户的音视频流都录制成一个独立的文件,若您需开启云端录制功能,详细操作指引请参见 实现云端录制与回放

修改云端录制配置

注意
修改云端录制配置可能会影响您线上正在运行的业务数据,请确认风险后谨慎操作。
1. 单击 应用管理选择需要修改云端录制配置的应用,单击目标应用所在行的功能配置
2. 功能配置 > 云端录制配置中,单击右侧的编辑进入云端录制配置修改页。n


3. 根据实际情况修改 配置信息,单击确定即可保存修改。


关闭云端录制功能


关闭云端录制后将导致您线上正在运行的业务无法进行云端录制,包括手动录制和自动录制。请确认您的业务确实不再需要云端录制功能时再关闭。
1. 单击 应用管理,选择需要修改功能配置的应用,单击目标应用所在行的功能配置
2. 功能配置 > 云端录制配置中,单击启用云端录制右侧的按钮。n


3. 仔细阅读关闭后的影响,若确认关闭云端录制,单击关闭云端录制即可。n



云端录制能力升级

如果您在了解了新版录制的 功能说明和限制 后,想将当前应用的云端录制能力升级为新版云端录制,我们提供了通过控制台的三种切换方式,任一方式即可切换且不支持回退,请您确认后再进行切换。
注意:
录制升级的影响:
1. 由于服务架构正在迁移的影响,2022年7月12日之前创建的应用如需使用全局自动化录制(手动API录制立即生效无影响),需等待1个工作日配置生效(需使用对应应用完成一次进房推流),2022年7月12日之后新创建应用立即生效无需等待,请您知悉。
2. 升级为新版云端录制后,需要针对新版录制能力进行开发接入录制回调事件的调整,请您预留一定的调整时间。
3. 升级后,若您开启仍开启了旁路转推功能且在云直播控制台配置了录制模板且绑定了域名,则同时会发起云直播侧的录制功能,如不需要发起云直播侧的录制功能,可以在云直播控制台解绑录制模板。
方式1:当前应用完成旁路转推的默认推流域名的切换流程(无需实际切换转推域名)。n


方式2:关闭当前应用的旁路转推功能后重新开启。n


方式3:通过原云端录制配置下方的切换入口进行切换。n


注意:
新、旧云端录制能力的回调信息和配置回调方式不同,如需使用回调功能,请您在切换后完成新版云端录制回调地址配置并了解新版录制回调说明

高级权限控制

如果您希望给某些房间中加入进房限制或者上麦限制,也就是仅允许指定的用户去进房或者上麦,而您又担心在客户端判断权限很容易遭遇破解攻击,那么可以考虑 开启高级权限控制。n



注意事项

开启高级权限控制后,当前 SDKAppID 的所有用户都需要在 TRTCParams 中正确传入 privateMapKey 参数才能成功进房。如果线上有使用此 SDKAppID 的用户,请不要轻易开启此功能。

启用高级权限控制

1. 单击应用管理,选择需要开启高级权限控制的应用,单击目标应用所在行的功能配置
2. 功能配置 > 高级权限控制中,单击右侧的启用高级权限控制右侧按钮。n



关闭高级权限控制

1. 单击应用管理,选择需要关闭高级权限控制的应用,单击目标应用所在行的功能配置
2. 功能配置 > 高级权限控制中,单击右侧的关闭高级权限控制右侧按钮。n



相关文档

若需创建新的应用,具体操作请参见 创建应用
若需在应用列表中搜索相关应用,具体操作请参见 搜索应用
若需查看应用的基本信息,具体操作请参见 应用信息
若需在云端混流转码时设置自定义背景图片,可在素材管理中添加对应的图片素材,具体操作请参见 素材管理
若需快速跑应用通配套的 Demo 源码,具体操作请参见 快速上手
目录