聚焦会话
IMKit 提供聚焦会话功能,支持在宽屏设备多栏布局下,将当前打开的会话在会话列表中高亮显示,提升用户的聚焦体验。
接口定义
TypeScript
focusConversation(conversation?: ConversationIdentifier, isUpdateOperationTime?: boolean): void
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
conversation | ConversationIdentifier | 否 | 要聚焦的会话。可选,不传时将取消当前聚焦状态。 |
isUpdateOperationTime | boolean | 否 | 是否刷新该会话的最近操作时间(用于排序)。 • 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 的配置项。