TIMSDK/README_ZH.md

English | 简体中文

公告：TUIKit Android 与 iOS 端开放 Pull Request，merge 成功后会在 README.md 上留下您的大名并超链到您的 Github 主页！

即时通信 IM

产品简介

即时通信 IM（Instant Messaging）基于 QQ 底层 IM 能力开发，仅需植入 IM SDK 即可轻松集成聊天、会话、群组、资料管理和直播弹幕能力，也支持通过信令消息与白板等其他产品打通，全面覆盖您的业务场景，支持各大平台小程序接入使用，全面满足通信需要。

Android 体验 App	iOS 体验 App

我们提供了一套基于 IM SDK 的 TUIKit 组件库，组件库包含了会话、聊天、搜索、关系链、群组、音视频通话等功能。基于 UI 组件您可以像搭积木一样快速搭建起自己的业务逻辑。

镜像下载

腾讯云分流下载地址： DOWNLOAD

SDK下载

终端 SDK	下载地址	集成指引文档	更新日志
Android	Github(推荐)	【极速集成】导入TUIKit (Android) 【常规集成】快速导入到工程 (Android)	更新日志(终端)
iOS	Github(推荐)	【极速集成】导入TUIKit (iOS) 【常规集成】快速导入到工程 (iOS)
Mac	Github(推荐)	【常规集成】快速导入到工程 (Mac)
Windows	Github(推荐)	【常规集成】快速导入到工程 (Windows)

TUIKit集成

功能模块	平台	文档链接
TUIKit 界面库	iOS	TUIKit-iOS界面库
	Android	TUIKit-Android界面库
快速集成	iOS	TUIKit-iOS快速集成
	Android	TUIKit-Android快速集成
修改界面主题	iOS	TUIKit-iOS修改界面主题
	Android	TUIKit-Android修改界面主题
设置界面风格	iOS	TUIKit-iOS设置界面风格
	Android	TUIKit-Android设置界面风格
添加自定义消息	iOS	TUIKit-iOS添加自定义消息
	Android	TUIKit-Android添加自定义消息
添加自定义表情	iOS	TUIKit-iOS添加自定义表情
	Android	TUIKit-Android添加自定义表情
实现本地搜索	iOS	TUIKit-iOS实现本地搜索
	Android	TUIKit-Android实现本地搜索
接入离线推送	iOS	TUIKit-iOS接入离线推送
	Android	TUIKit-Android接入离线推送

基础版与增强版差异对比

• SDK 从 5.4 版本开始，原有精简版改名为增强版，原有标准版改名为基础版。
• 增强版与基础版同时支持 V2 API；但增强版不再支持旧版 API，基础版继续支持旧版 API。
• 如果您没有接入过旧版 API，建议您直接使用 V2 API，选择增强版 SDK。
• 如果您已经接入了旧版 API，推荐您升级到 V2 API，逐步切换到增强版 SDK。
• 在 SDK 体积和安装包增量上，增强版与基础版相比有大幅度缩减。
• 在 SDK 功能支持上，增强版与基础版相比提供了更多新功能特性。
• 后续新功能开发，只在增强版上提供支持；基础版后续只做例行维护与现有问题修复。
• SDK 从 6.8 版本开始，发布增强版 Pro，支持网络层双线路加速，提供更强的网络抗性。

SDK 体积大小对比

平台	对比项	基础版	增强版
Android	aar 大小	7.8 MB	3.1 MB
iOS	framework 大小	57.7 MB	11.2 MB

App 体积增量对比

平台	架构	基础版	增强版
apk 增量	armeabi-v7a	3.2 MB	1.1 MB
	arm64-v8a	5.2 MB	1.7 MB
ipa 增量	arm64	2.1 MB	1.1 MB

IMSDK 升级 V2API 接口指引

接口升级指引

最新增强版 7.3.4358 @2023.06.21

SDK

• 支持服务器消息搜索
• 支持按照是否含有未读消息过滤会话列表和会话未读总数
• 支持按照是否含有 @消息过滤会话列表和会话未读总数
• 获取群成员列表接口，增加群成员在线标识
• 所有类型的群都支持获取在线人数
• 优化从后台切换到前台时的重连速度
• 优化弱网时拉取本地消息缓慢问题
• 修复标记加群申请已读后，拉取加群申请列表缺失问题
• 修复发送第一条消息给非好友的账号，拉取不到会话问题
• 修复切换帐号登录偶现对方会话个人资料为前一个帐号资料的问题
• 修复拉取历史消息偶现本地字段消失问题
• 修复 iOS 偶现不抛出信令通知的问题
• 修复一键清空未读数后，会话未读数回调不生效问题
• 修复删除或重命名会话分组后，会话更新回调里的会话对象没有 showName、faceUrl 、lastMessage 信息的问题
• 修复对于本地不存在的会话，会话标记和会话分组信息变更通知会被丢弃的问题
• 修复删除会话偶现清空消息数据库的问题
• 修复 SDK 与用户代码发生符号冲突的问题

TUIKit & Demo

• 支持多会话分组和会话标记
• 新增快速会议功能
• 语言消息支持自动播放下一条语音
• 图片视频查看支持缩小放大以及自适应横竖屏
• 图片视频上传下载支持显示进度
• 图片视频消息支持多选发送
• 群资料页面支持修改邀请选项
• iOS 发送图片支持增加后缀名

最新基础版 5.1.66 @2021.09.22

Android

• 去掉 WiFi 信息的获取

问题反馈

• 为了更好的了解您使用TIMSDK所遇到的问题，方便快速有效定位解决TIMSDK问题，希望您按如下反馈指引反馈issue，方便我们尽快解决您的问题
• TIMSDK issue反馈指引