为什么推荐 V4
V4 SDK (@tencentcloud/lite-chat) 是 V3 SDK (@tencentcloud/chat) 的优化和升级版本，V4 版本已完全覆盖 V3 提供的所有功能。推荐升级到 V4 的主要优势如下：
1. 包体积优化与按需集成
- 多版本并行： V4 提供了精简版、标准版、完整版三种版本，开发者可以根据实际业务需求灵活选择。
- 包体最小化： 精简版 SDK 的包体积可降至最小 200 KB，极大地优化了 Web 和小程序等对包体积有严格要求的场景。
2. 集成流程简化
- 无需额外插件： 升级到 V4 后，您无需额外引入和注册上传插件 (
tim-upload-plugin)，简化了富媒体消息的初始化流程。
3. 面向未来的持续迭代
- 功能全覆盖与迭代： V4 版本完全兼容 V3 所有功能，并且未来所有的新功能也将基于 V4 版本进行持续新增和迭代。
关键差异与兼容性变动
V4 SDK (@tencentcloud/lite-chat) 在核心 API 上与 V3 SDK (@tencentcloud/chat) 保持高度兼容，大部分逻辑无需修改即可平滑过渡。请开发者重点关注以下两大关键变动：
1. 核心变更：包名切换与版本选择
- V4 SDK 包名： @tencentcloud/lite-chat
- V3 SDK 包名： @tencentcloud/chat
升级时，请卸载旧包并安装新包。
| V4 版本 | 大小 (Size) | 导入路径 (Import Path) | 业务场景 (Scenario) |
|---|---|---|---|
| 精简版 (Basic) | 200 KB | import TencentCloudChat from '@tencentcloud/lite-chat/basic'; |
* 初始化，事件监听。 * 登录登出。 * 支持文本消息收发。 * 支持自定义消息收发（可自由定制发送内容）。 * 支持用户资料和用户状态。 |
| 标准版 (Standard) | 516 KB | import TencentCloudChat from '@tencentcloud/lite-chat'; (默认) |
包含精简版全部功能外 * 支持获取历史消息、消息操作、合并转发、已读回执、消息扩展等功能。 * 支持图片消息、视频消息、语音消息、文件消息收发功能。 * 支持云端消息（Message）搜索、用户（User）搜索、群组（Group）搜索、群成员搜索等功能。 * 支持会话列表、会话资料、会话操作等功能。 * 支持群组管理、群成员管理等功能。 * 支持社群。 * 支持直播群。 |
| 完整版 (Professional) | 609 KB | import TencentCloudChat from '@tencentcloud/lite-chat/professional'; |
包含标准版全部功能外 * 支持黑名单、好友管理、好友分组等功能。 * 支持关注和粉丝功能。 * 支持会话分组。 * 支持话题。 |
2. 兼容性变动：不支持的平台与特性
| 平台/特性 | V3 SDK | V4 SDK |
|---|---|---|
| React Native | 支持 | 不再支持 RN 环境下的集成。 |
| uni-app 特定小程序 | 支持 | 暂不支持：支付宝小程序、抖音小程序、百度小程序、QQ 小程序。 |
接口
V4 的接口向下兼容 V3。