获取会话

本文主要介绍 云上曲率即时通讯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;