获取会话

更新时间: 2023-06-29

本文主要介绍云上曲率即时通讯IM SDK的获取会话功能。

功能描述

云上曲率IM SDK为开发者提供如下内容：

从服务端获取全部会话列表

注意：获取全部会话列表一般适用于更换终端的场景。不建议在每次登录后从服务端重新拉取。

接口说明

获取全部会话列表

通过getConversationList接口实现从服务端获取全部产生的会话，并形成会话列表返回给客户端。返回的会话中包含该会话产生的最后一条消息，用于会话列表展示。

接口参数说明：

参数	含义	说明
mtime	时间戳	毫秒级时间戳。大于改时间戳的消息计为未读消息，最后一条未读消息设为会话的最后一套消息。如果不传该参数，默认使用上次离线时间。
conversationType	会话类型	包括P2P、群组
timeout	超时时间	获取会话列表定义的超时时间，单位为秒

代码示例

-(void)getConversation:(int64_t)mtime
      conversationType:(LDConversationType)conversationType
               timeout:(int)timeout
               success:(void(^)( NSArray <IMConversation*> *array))successCallback
                  fail:(IMAnswerFailCallBack)failCallback;

删除P2P会话

通过此接口可以删除指定会话。当前删除会话只提供删除P2P会话接口removeP2pConversation。

注意：

当删除的是P2P会话，发起用户会将此会话在服务端删除。服务端提供单向或双向删除。默认双向删除。

P2P会话，无论是A和B的会话，还是B和A的会话，均是一个会话，产生一个会话ID。

接口参数说明：

参数	含义	说明
toId	用户ID	要删除会话的用户ID
oneWay	删除好友方式	true-单项删除 false-双向删除
timeout	超时时间	请求的超时时间，单位为秒

代码示例

-(void)removeP2pConversation:(int64_t)toId
                      oneWay:(BOOL)oneWay
                     timeout:(int)timeout
                     success:(void(^)(void))successCallback
                        fail:(IMAnswerFailCallBack)failCallback;