适用范围与时间线
本文档适用于尚未完成迁移、业务仍依赖互动直播(iLVB)的客户,说明如何将业务迁移至实时音视频 TRTC。
时间 | 状态 |
2019 年 10 月起 | iLVB 停止维护,不再迭代功能、安全补丁及缺陷修复。 |
2026 年 10 月 31 日后 | iLVB 正式退市(北京时间)。服务停止响应,存量资源回收,控制台不可访问,资源清除后不支持找回。 |
iLVB 已停止服务,业务必须在 TRTC 上重建。本文档替代原「iLiveSDK 版本升级」相关说明。
iLVB 与 TRTC 能力映射
能力 | iLVB 落点 | TRTC 落点 |
客户端 SDK | 使用 iLiveSDK(TRTC V1)。 | 使用 LiteAVSDK(TRTC V2)。 |
集成方式 | 仅支持无 UI 接入,界面与交互需自行实现。 | |
房间与成员管理 | 控制台查询 + 客户端 SDK 操作;房间列表、成员列表、心跳由开发者自建后台承载。 | 含 UI 方案下由组件直接提供,无需自建:TUIRoomKit 支持会议预约、成员管理与会中聊天,TUICallKit 支持群组通话与通话记录,TUILiveKit 支持连麦管理与聊天弹幕(详细参见 选择集成方案)。无 UI 方案下可沿用自建后台。 |
用量统计与质量监控 | 无官方统计与监控能力,通话量、在线规模与通话质量数据需由开发者在自建后台自行采集与存储。 | 控制台可直接查看用量统计与通话记录;开通 数据仪表盘 后可做全链路质量监控,含实时监控(在线用户数、在线房间数、音视频卡顿率等指标秒级刷新)、房间通话调查(单房间与单用户的通话质量详情)、数据大盘与监控告警。 |
旁路直播 | 控制台开启全局自动旁路,或客户端 SDK 发起指定流旁路( startPushStream);只能转推至云直播 CSS。 | 方式相同:控制台开启全局自动旁路,或客户端 startPublishMediaStream 发起指定流旁路;另支持云端 API(StartPublishCdnStream 等)。可转推至云直播 CSS 或第三方 CDN。 |
录制 | 无独立录制能力,依附旁路转推链路,最终由云直播 CSS 录制;文件投递至云点播 VOD。 | TRTC 自带云端录制能力,不依赖旁路转推;支持单流 / 合流、控制台全局自动录制或云端 API 触发;文件可存 VOD、COS 或 AWS S3。 |
混流 | 无混流能力,只能在旁路转推之后调用云直播 CSS 的云端混流 HTTP 接口。 |
在完全兼容 iLVB 基础音视频通信能力之外,TRTC 还提供 AI 降噪、AI 智能语音、AI 实时对话、内容识别与审核、小程序加速、RTMP 推流进房等能力。
迁移前准备
迁移前需先确定集成方式,再完成下列准备。
选择集成方案
iLiveSDK 仅支持无 UI 一种接入方式,通话、直播的界面与交互逻辑全部需要开发者自行设计实现。TRTC 提供四类接入方案:既可沿用无 UI 方式完全自定义界面,也可直接选用三套面向主流场景的含 UI 方案,复用成品界面快速上线,接入门槛与改造成本显著降低。
方案 | 适用场景 | 界面 |
TUICallKit(视频通话) | 9 人以下音视频通话。 | 含 UI |
TUIRoomKit(视频会议) | 2 - 300 人灵活互动会议;人数无上限的网络研讨会、大型直播课堂。 | 含 UI |
TUILiveKit(直播与语聊) | 视频互动直播、语音聊天室。 | 含 UI |
TRTC SDK(音视频引擎) | 其他全部实时互动场景;需完全自定义界面与交互。 | 无 UI |
说明:
三套含 UI 方案均提供一套默认 UI,可直接使用,也可在默认 UI 基础上自主修改;同时支持不含 UI 接入,仅调用其封装的场景能力接口。
若已在 iLiveSDK 上自建业务界面,选用 TRTC SDK(音视频引擎)改造量最小:界面与交互代码可保留,只需替换音视频能力接口。
TUICallKit、TUIRoomKit、TUILiveKit 已封装 TRTC 与 IM 的核心能力,房间与成员管理、通话记录、录制、连麦等场景功能开箱即用,无需自行搭建,最快一天即可完成集成;使用时需同时订阅 TRTC 包月套餐与 IM 基础套餐包,组件本身无额外费用。组件基于腾讯云即时通信 IM 搭建,不支持替换为其他 IM 产品。
准备事项
1. 通过 TRTC 控制台 创建应用,获取 SDKAppID 与密钥。
2. 原有应用的即时通信 IM 服务与账号体系不受影响。但 iLiveSDK 内嵌 IM SDK、LiteAVSDK 不内嵌,迁移后需独立引入 IM SDK。SDKAppID 可沿用原值,也可一并替换为 TRTC 新建的 SDKAppID。
3. 确认待迁移的能力清单,对照 iLVB 与 TRTC 能力映射 列出改造点。
客户端 SDK 迁移
按 选择集成方案 确定的方式,集成对应的 TRTC SDK 替换 iLiveSDK。iLVB 使用的客户端 SDK 是 iLiveSDK,在 TRTC 文档体系中记为 V1;迁移目标 V2 为 LiteAVSDK。
获取 LiteAVSDK
在 SDK 下载 获取 LiteAVSDK,覆盖 iOS、Android、Windows、macOS、Web、Electron、Flutter、React Native、Uni-App、微信小程序等平台与框架。
若在 选择集成方案 时选择了含 UI 方案,TUICallKit、TUIRoomKit、TUILiveKit 已基于 LiteAVSDK 与 IM SDK 封装,按其各自文档集成即可,无需单独下载 LiteAVSDK。
注意:
V1 与 V2 云端线路不互通,且 V1 线路已随 iLVB 退市停止服务。同一房间内 V1 与 V2 的用户无法互相通话;由于 V1 已不可用,不存在新旧版本并存的灰度过渡,须整体切换至 V2。
迁移步骤
V1 线路已停止服务,不存在新旧并存的灰度中间态,迁移为一次性全量切换:
1. 按 选定的方案 集成 SDK:无 UI 方案集成 LiteAVSDK,含 UI 方案集成对应的 TUICallKit / TUIRoomKit / TUILiveKit,替换 iLiveSDK。若使用了 iLiveSDK 内嵌的 IM 能力,需独立接入 IM SDK(见 准备事项)。
2. 按 iLVB 与 TRTC 能力映射 改造云端能力:自有业务后台、旁路直播、录制、混流。
3. 完成功能与兼容性测试。
4. 发布新版本 App。旧版本 App 已无法连接 iLVB 后台,用户须更新至新版本方可继续使用。
云端能力迁移
iLVB 不提供音视频 REST API。房间列表、成员列表、心跳等能力由开发者自建后台承载;旁路直播、录制、混流分别落在云直播 CSS 与云点播 VOD。迁移按下面四块分别处理,其中 自有业务后台 属于开发者自有业务侧,其余 旁路直播、录制、混流 等部分属于 TRTC 云端能力。
自有业务后台
iLVB 官方后台示例中由开发者自建实现的能力:注册、登录、创建房间、上报创建房间结果、拉取直播房间列表、上报进入房间信息、拉取房间成员列表、心跳上报、申请上麦、申请上麦结果上报、录制完成上报、退出房间、拉取点播列表、拉取旁路直播地址列表、下线。
这些是开发者自有业务接口,不随 iLVB 退市失效,可继续沿用。若采用含 UI 方案,房间、成员与通话记录等能力已由 TUICallKit / TUIRoomKit / TUILiveKit 封装,本节涉及的后台改造仅在无 UI 方案或自有业务逻辑下需要。其中用量统计与质量监控无需自建:TRTC 控制台提供用量统计与通话记录,开通数据仪表盘后可查看实时监控、房间通话调查与监控告警。
旁路直播
iLVB(已停止服务)有两种开启方式:控制台 > 旁路直播配置开启自动旁路(用户开摄像头后自动触发),或客户端 SDK 手动触发。只能转推至云直播 CSS。
TRTC 的开启方式与之对应,并多出一种:
控制台开启全局自动旁路:TRTC 全部上行音视频流自动旁路转推至所设转推域名
注意:
TRTC 控制台开关分为两级:需先开启旁路转推,才能开启全局自动转推。转推目的地支持腾讯云云直播 CSS,也支持第三方 CDN,单个转推任务最多可设置 10 个推流地址。详细参见 发布音视频流到直播 CDN。
客户端接口
startPublishMediaStream:发起指定流旁路云端 API
StartPublishCdnStream、UpdatePublishCdnStream、StopPublishCdnStream:iLVB 无对应方式录制
iLVB 不提供独立的录制能力,录制依附于旁路转推链路。频道模式下由客户端 SDK 触发(
startRecordVideo / stopRecordVideo),直播码模式下可在控制台开启全局自动录制;两种模式均需先开通旁路转推,最终由云直播 CSS 完成录制,文件投递至云点播 VOD。TRTC 自带云端录制能力,不依赖旁路转推,在 TRTC 内闭环:
录制模式:单流录制、合流录制
发起方式:控制台开启全局自动录制,或由后台调用云端 API(
CreateCloudRecording、DeleteCloudRecording、DescribeCloudRecording、ModifyCloudRecording)存储位置:云点播 VOD、对象存储 COS 或 AWS S3,在控制台完成存储配置后投递
混流
iLVB 不提供混流能力,混流只能在旁路转推之后调用云直播 CSS 的接口完成。即先由 iLVB 旁路转推出流,再调用云直播 CSS 的 云端混流 HTTP 接口(
http://fcgi.video.qcloud.com/common_access,interface=Mix_Stream,使用直播 APPID 与直播 API 鉴权 key 签名),以直播码作为流 ID(直播码 = [BIZID]_MD5(房间号_用户名_数据类型))。混流布局与编码参数由 CSS 接口定义,属跨产品调用。TRTC 的混流与转推是同一个任务,混流细节在转推任务内直接定义,无需再调用云直播接口。调用 启动转推任务(
StartPublishCdnStream)并设置 WithTranscoding = 1,可在同一任务中配置:音频参数
AudioParams:采样率、声道、码率视频参数
VideoParams:分辨率、帧率、码率、GOP混流布局
LayoutParams:混流模式,每路画面的位置、尺寸、层级与渲染模式,以及画布背景色与水印混流 SEI
SeiParams:在输出流中携带布局信息输出目标:混成一路流后推至直播 CDN(单个任务最多 10 个推流地址),或回推到 TRTC 房间;iLVB 的混流结果只能输出到 CDN
录制参数
RecordParams:转推的同时完成录制说明:
同一接口以
WithTranscoding 区分两种任务:设为 0 为不转码的旁路转推,设为 1 为必定转码的混流转推(见 旁路直播)。任务启动后返回 TaskId,后续的更新与停止均依赖该 TaskId。重要:旁路直播、录制、混流所依赖的云直播 CSS 与云点播 VOD 是独立云产品,不随 iLVB 退市。已存储在 VOD 的录制文件不受影响。
TRTC 费用说明
TRTC 服务项按服务类型分为包月套餐费用(入门版至旗舰版 Plus 六个版本,为不同应用解锁增值功能服务)、基础服务消耗费用(音视频时长、云端录制与投递、云端混流转码、旁路转推及对应补充包)与其他服务消耗费用(数据仪表盘、视频截图上传、AI 智能语音、AI 实时对话)三类。音视频时长覆盖语音互动直播、视频互动直播、语音通话、视频通话四类场景,按房间内所有人互动订阅时长统计计费;录制与混流转码按任务输入流时长计,旁路转推按转推带宽峰值计。包月套餐与补充包需先行购买后使用,其余服务项按实际用量后付费出账;新账号可在 TRTC 控制台 创建应用时免费领取 10000 分钟试用音视频时长包。
说明: