会话置顶
会话置顶功能提供以下能力:
- 在会话列表中置顶会话:通过会话(
RCConversation
)的置顶(isTop
)属性控制。 - 在携带同一标签的会话中置顶(需配合使用会话标签功能):通过 RCConversationTagInfo 类的
isTop
属性控制。
在会话列表中置顶会话
设置指定会话在会话列表中置顶后,SDK 将修改 RCConversation 的 isTop
字段,该状态将会被同步到服务端。融云会在为用户自动同步会话置顶的状态数据。客户端可以主动获取或通过监听器获取到最新数据。
设置会话置顶
使用 setConversationToTop:targetId:isTop:completion: 设置会话置顶。
// Set the conversation type and target ID
RCConversationType conversationType = ConversationType_PRIVATE;
NSString *targetId = @"your_target_id";
// Set the conversation to top or not
BOOL isTop = YES;
[[RCCoreClient sharedCoreClient] setConversationToTop:conversationType
targetId:targetId
isTop:isTop
completion:^(BOOL success) {}];
参数 | 类型 | 说明 |
---|---|---|
conversationType | RCConversationType | 会话类型,支持单聊、群聊、系统会话。 |
targetId | NSString | 会话 id |
isTop | BOOL | 是否置顶 |
completion | Block | 设置置顶结果回调 |
客户端通过本地消息数据自动生成会话与会话列表,并会在用户登录的多个设备之间同步置顶状态。如果在调用该 API 时,要置顶的会话在本地或该用户登录的其他设备上不存在(会话尚未生成,或者已被移除),SDK SDK 将直接创建会话并置顶。