腾讯云即时通信 IM SDK 5.3.425 版本于 2021 年 4 月 19 日正式发布了,这个版本支持了众多渴望已久的新功能,期待您的接入。
新版本更新特性:
- 支持会话置顶
- 发送不计入未读计数的消息
- 单聊消息免打扰
- 增加获取所有会话未读总数的接口
- Android SDK 转移到 Maven Central 仓库发布
- iOS SDK 新增 XCFramework 版本,正式支持 Mac Catalyst
下载地址:
Android:https://github.com/tencentyun/TIMSDK/tree/master/Android/SDK
iOS:https://github.com/tencentyun/TIMSDK/tree/master/iOS/ImSDK
Mac:https://github.com/tencentyun/TIMSDK/tree/master/Mac/ImSDK
会话置顶
会话置顶指的是把特定的好友或者群会话固定在会话列表的最前面,新版本 SDK 增加了主动设置或者取消会话置顶的接口,同时支持漫游和多端同步。
- 支持漫游:设置为置顶的会话,换另一台手机登录同一个账号后,对应的会话仍然保持置顶状态。
- 多端同步:相同账号在多台手机上同时登录时,设置为置顶的会话,其置顶状态可以实时同步到另一台手机。
下面以 Android 平台为例,简单介绍一下会话置顶的使用方法
1、设置或取消会话置顶,您可以直接调用 pinConversation 接口;
2、会话对象 V2TIMConversation 新增了 isPinned 接口,用于判断会话的置顶状态。当会话的置顶状态发生变更的时候,SDK 会向您的 App 回调 onConversationChanged,其参数是一个会话对象列表,指出了哪些会话有变更。调用会话对象的 isPinned 接口,即可得到最新的置顶状态。
发送不计入未读计数的消息
正常情况下,无论是发送 C2C 单聊消息还是发送 Group 群消息,都会计入未读消息数(通过会话对象 V2TIMConversation 的 getUnreadCount 接口,可以拿到一个会话的未读消息数)。
当您希望发送一些不计入未读计数的消息时,比如提示类或者控制类的消息,可以按照下面的方式来发送:
单聊消息免打扰
即时通信 IM SDK 支持三种类型的消息接收选项 - V2TIMMessage.V2TIM_RECEIVE_MESSAGE:在线时正常接收消息,离线时接收离线推送通知 - V2TIMMessage.V2TIM_NOT_RECEIVE_MESSAGE:在线和离线都不接收消息 - V2TIMMessage.V2TIM_RECEIVE_NOT_NOTIFY_MESSAGE:在线时正常接收消息,离线时不接收离线推送通知。
新版本 SDK 增加了 setC2CReceiveMessageOpt 接口,用于设置 C2C 消息接收选项(Group 群消息接收选项之前版本已经支持)。当您不希望接收某个人的消息时,可以调用该接口,将他的消息接收选项设置为:V2TIMMessage.V2TIM_NOT_RECEIVE_MESSAGE,即可实现单聊消息免打扰的能力。
增加获取所有会话未读总数的接口
为了提高接口的易用性,新版本 SDK 增加了获取所有会话未读总数的接口 getTotalUnreadMessageCount。您不用再遍历会话列表,把单个会话的未读数相加,才能得到未读总数。当会话的未读总数发生变更的时候,SDK 会主动向您的 App 回调 onTotalUnreadMessageCountChanged,把最新的未读总数通知给您。
Android SDK 转移到 Maven Central 仓库发布
众所周知,JCenter 官方将于 2021 年 5 月 1 日停止服务,为了不影响客户的正常使用,即时通信 IM SDK 从这个版本开始,正式发布到 Maven Central 仓库,您只需要在 Android Studio 项目的 build.gradle 脚本里增加 mavenCentral() 的依赖,即可正常使用。
iOS SDK 新增 XCFramework 版本,正式支持 Mac Catalyst
XCFramework 是苹果为了更好地支持 Mac Catalyst 和 ARM 芯片的 macOS,从 Xcode 11 开始支持的一种包括多个架构并且可以在多个平台(iOS,macOS,tvOS,watchOS,iPadOS,carPlayOS)上使用的框架库。即时通信 IM SDK 从这个版本开始,正式发布 XCFramework 版本。
腾讯云通信
一直致力于
让每个企业
都享受智慧服务带来的改变
END
未来可期
长按扫码关注腾讯云通信官方微信公众号
以获取更多更专业的云通信知识