实时音视频 互动直播 iLVB 迁移指南

一、适用范围与时间线

iLVB 已停止服务，业务必须在 TRTC 上重建。这篇档替代原「iLiveSDK 版本升级」相关说明。

二、iLVB 与 TRTC 能力映射

在完全兼容 iLVB 基础音视频通信能力之外，TRTC 还提供 AI 降噪、AI 智能语音、AI 实时对话、内容识别与审核、小程序加速、RTMP 推流进房等能力。

三、迁移前准备

迁移前需先确定集成方式，再完成下列准备。

四、选择集成方案

iLiveSDK 仅支持无 UI 一种接入方式，通话、直播的界面与交互逻辑全部需要开发者自行设计实现。TRTC 提供四类接入方案：既可沿用无 UI 方式完全自定义界面，也可直接选用三套面向主流场景的含 UI 方案，复用成品界面快速上线，接入门槛与改造成本显著降低。

四类方案的完整对比见 新手指引 > TRTC 接入方案对比；无 UI 接入的集成步骤见 无 UI 集成方案。

注意：说明：

五、准备事项

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 分钟试用音视频时长包。

注意：说明：

注意：完整计费说明请查看 购买指南 系列文档。

十五、联系我们

迁移过程中如遇到任何问题，欢迎通过 提交工单 联系我们，我们会尽快协助你处理。