获取会话
Update:
本文主要介绍 云上曲率即时通讯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;
本文主要介绍 云上曲率即时通讯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;