- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
- 动态与公告
- 产品简介
- 购买指南
- 新手指引
- Demo 体验
- 视频通话（含 UI）
- 多人会议（含 UI）
- 组件介绍（TUIRoomKit）
- 开通服务（TUIRoomKit）
- 跑通 Demo（TUIRoomKit）
- 快速接入（TUIRoomKit）
- 预定会议（TUIRoomKit）
- 会中呼叫（TUIRoomKit）
- 界面定制（TUIRoomKit）
- 虚拟背景（TUIRoomKit）
- 会议控制（TUIRoomKit）
- 云端录制（TUIRoomKit）
- AI 降噪（TUIRoomKit）
- 会中聊天（TUIRoomKit）
- 机器人推流（TUIRoomKit）
- 更多特性（TUIRoomKit）
- 客户端 API（TUIRoomKit）
- 服务端 API（TUIRoomKit）
- 常见问题（TUIRoomKit）
- 错误码 (TUIRoomKit)
- SDK更新日志（TUIRoomKit）
- 在线直播（含 UI）
- 组件介绍（TUILiveKit）
- 开通服务（TUILiveKit）
- 跑通 Demo（TUILiveKit）
- 快速接入（TUILiveKit）
- 界面定制（TUILiveKit）
- 开播和观看（TUILiveKit）
- 房间列表（TUILiveKit）
- 关注主播（TUILiveKit）
- 主播连线（TUILiveKit）
- 主播 PK（TUILiveKit）
- 观众连麦（TUILiveKit）
- 互动弹幕（TUILiveKit）
- 互动礼物（TUILiveKit）
- 礼物特效（TUILiveKit）
- 美颜特效（TUILiveKit）
- 悬浮窗（TUILiveKit）
- 客户端API（TUILiveKit）
- 服务端 API（TUILiveKit）
- 错误码（TUILiveKit）
- 发布日志（TUILiveKit）
- 常见问题（TUILiveKit）
- 语音聊天室（含 UI）
- 无 UI 集成
- 高级功能
- 服务端 API
- 控制台指南
- 解决方案
- 常见问题
- 旧版文档
- 协议与策略
- TRTC 政策
- 词汇表
本文档旨在指导客户将
tencent_trtc_cloud 升级为新版本的 tencent_rtc_sdk。升级过程中，我们将详细介绍所需的步骤、注意事项以及可能遇到的问题和解决方案，以确保平滑过渡到新版本。升级指引
注意：
进行升级前请注意对当前项目做好备份。
tencent_rtc_sdk 目前尚未支持 tencent_trtc_cloud 中的 tx_beauty_manager。tencent_rtc_sdk 暂时没有支持 web 端的计划。如果您的项目涉及到了tencent_trtc_cloud的 web 端，我们并不建议您进行升级。1. 引入新 SDK
在控制台中进入项目目录：
cd <path to your flutter project>
移除旧版本
tencent_trtc_cloudflutter pub remove tencent_trtc_cloud
引入新版本
tencent_rtc_sdkflutter pub add tencent_rtc_sdk
2. 替换 import package
可以通过 IDE 提供的 替换/批量替换 功能，将当前项目中 import 的
tencent_trtc_cloud 替换为 tencent_rtc_sdk。注意：
如果您直接使用了我们
tencent_trtc_cloud example 中的 GenerateTestUserSig 来生成自身项目的 userSig ，麻烦删除掉其中 JsGenerateTestUserSig 相关逻辑。3. 替换 TRTCCloudDef 枚举值
tencent_rtc_sdk移除了tencent_trtc_cloud中提供的 TRTCCloudDef 类，将类中提供的各种 static 变量拆分为了众多 dart 枚举，以便利您对于部分参数的使用。对于您现有项目中使用的 TRTCCloudDef 类，您可以参照下方对照表将 static 变量替换为对应枚举：
tencent_trtc_cloud | tencent_rtc_sdk |
TRTCCloudDef.TRTC_VIDEO_RESOLUTION_* | TRTCVideoResolution |
TRTCCloudDef.TRTC_VIDEO_RESOLUTION_MODE_* | TRTCVideoResolutionMode |
TRTCCloudDef.TRTC_VIDEO_STREAM_TYPE_* | TRTCVideoStreamType |
TRTCCloudDef.TRTC_QUALITY_* | TRTCQuality |
TRTCCloudDef.TRTC_VIDEO_RENDER_MODE_* | TRTCVideoFillMode |
TRTCCloudDef.TRTC_VIDEO_ROTATION_* | TRTCVideoRotation |
TRTCCloudDef.TRTC_BEAUTY_STYLE_* | TRTCBeautyStyle |
TRTCCloudDef.TRTC_VIDEO_PIXEL_FORMAT_* | TRTCVideoPixelFormat |
TRTCCloudDef.TRTC_VIDEO_MIRROR_TYPE_* | TRTCVideoMirrorType |
TRTCCloudDef.TRTC_APP_SCENE_* | TRTCAppScene |
TRTCCloudDef.TRTCRole* | TRTCRoleType |
TRTCCloudDef.VIDEO_QOS_CONTROL_* | TRTCQosControlMode |
TRTCCloudDef.TRTC_VIDEO_QOS_PREFERENCE_* | TRTCVideoQosPreference |
TRTCCloudDef.TRTC_AUDIO_QUALITY_* | TRTCAudioQuality |
TRTCCloudDef.TRTC_AUDIO_ROUTE_* | TXAudioRoute (speakerPhone & earpiece) |
TRTCCloudDef.TRTC_REVERB_TYPE_ | TXVoiceReverbType |
TRTCCloudDef.TRTC_VOICE_CHANGER_TYPE_* | TXVoiceChangerType |
TRTCCloudDef.TRTC_AUDIO_FRAME_FORMAT_* | TRTCAudioFrameFormat |
TRTCCloudDef.TRTCSystemVolumeType* | (未支持) |
TRTCCloudDef.TRTC_DEBUG_VIEW_LEVEL_* | (未支持) |
TRTCCloudDef.TRTC_LOG_LEVEL_* | TRTCLogLevel |
TRTCCloudDef.TRTC_GSENSOR_MODE_* | TRTCGSensorMode |
TRTCCloudDef.TRTC_TranscodingConfigMode_* | (已废弃) |
TRTCCloudDef.TRTC_VideoView_* | (未支持) |
TRTCCloudDef.TXMediaDeviceType* | TXMediaDeviceType |
TRTCCloudDef.TRTCRecordType* | TRTCLocalRecordType |
4. 修改回调使用方法
在
tencent_trtc_cloud 中，回调需要使用者通过 switch 或 if 语句来捕获具体的回调，并手动解析 JSON 字符串以获取相关数据。这种使用方式可能会给用户带来不便。为此，我们在 tencent_rtc_sdk 中对回调机制进行了优化，以提升用户的接入体验，使其更加便捷和高效。以 TRTCCloudListener 为例：
在新的回调机制中，
registerListener 不再需要一个函数作为参数，而是需要一个 TRTCCloudListener 对象。您可以在初始化该对象时，选择性地为所需的回调函数赋值：TRTCCloudListener speedTestListener = TRTCCloudListener(onSpeedTestResult: (result) {// TODO});
5. 调用新方法
在本次升级中，我们删除了部分已被原生TRTC标注为废弃的接口，同时优化了部分接口的调用方法。
您可以在 API 概览 查找到我们目前支持的所有接口。
注意：
除 TRTCCloud.sharedInstance() 接口外，
tencent_rtc_sdk中所有接口均为同步调用。
是
否
本页内容是否解决了您的问题？