跳到主要内容

聚焦会话

IMKit 提供聚焦会话功能,支持在宽屏设备多栏布局下,将当前打开的会话在会话列表中高亮显示,提升用户的聚焦体验。

接口定义

TypeScript
focusConversation(conversation?: ConversationIdentifier, isUpdateOperationTime?: boolean): void

参数说明

参数名类型必填说明
conversationConversationIdentifier要聚焦的会话。可选,不传时将取消当前聚焦状态。
isUpdateOperationTimeboolean是否刷新该会话的最近操作时间(用于排序)。
true:更新该会话在内存中的操作时间(operationTime)为当前时间;将该会话在内存会话列表中移至首位;若内存中不存在,则从数据库查找;若数据库也不存在,则创建一个空会话。
false:仅设置聚焦效果,不更新操作时间、不调整排序、不查库。

使用示例

TypeScript
import { ConversationIdentifier, ConversationType } from '@rongcloud/imkit'

const conversation = new ConversationIdentifier()
conversation.targetId = '会话 ID'
conversation.conversationType = ConversationType.Private

RongIM.getInstance().conversationListService().focusConversation(conversation, true)

修改聚焦会话高亮颜色

如需修改 IMKit SDK 的默认会话聚焦高亮颜色,您需要在应用的 entry/src/main/resources/base/element/color.json 文件中,添加资源名为 rc_color_conversation_item_focused 的配置项。