JMSGConversationDelegate Protocol Reference

Conforms to NSObject
Declared in JMSGConversationDelegate.h

Overview

会话相关变更通知

– onConversationChanged:

会话信息变更通知

- (void)onConversationChanged:(JMSGConversation *)conversation

Parameters

conversation

变更后的会话对象

Discussion

当前有二个属性: 会话标题(title), 会话图标

收到此通知后, 建议处理: 如果 App 当前在会话列表页,刷新整个列表;如果在聊天界面,刷新聊天标题。

Declared In

JMSGConversationDelegate.h

– onSyncOfflineMessageConversation:offlineMessages:

同步离线消息、离线事件通知

- (void)onSyncOfflineMessageConversation:(JMSGConversation *)conversation offlineMessages:(NSArray JMSG_GENERIC ( __kindof JMSGMessage *) *)offlineMessages

Parameters

conversation

同步离线消息的会话

offlineMessages

离线消息、离线事件数组

Discussion

注意:

SDK 会将消息下发分为在线下发和离线下发两种情况, 其中用户在离线状态(包括用户登出或者网络断开)期间所收到的消息我们称之为离线消息.

当用户上线收到这部分离线消息后,这里的处理与之前版本不同的是:

3.1.0 版本之前: SDK 会和在线时收到的消息一样,每收到一条消息都会上抛一个在线消息 JMSGMessage 来通知上层.

3.1.0 版本之后: SDK 会以会话为单位,不管该会话有多少离线消息,SDK同步完成后每个会话只上抛一次.

3.2.1 版本之后: SDK 会以会话为单位,不管该会话有多少离线事件,SDK同步完成后每个会话只上抛一次

注意:一个会话最多触发两次这个代理,即:离线消息和离线事件各一次,这样会大大减轻上层在收到消息刷新 UI 的压力.

上层通过此代理方法监听离线消息同步的会话,详见官方文档.

Declared In

JMSGConversationDelegate.h

– onSyncRoamingMessageConversation:

同步漫游消息通知

- (void)onSyncRoamingMessageConversation:(JMSGConversation *)conversation

Parameters

conversation

同步漫游消息的会话

Availability

3.1.0

Discussion

注意:

当 SDK 触发此函数时,说明该会话有同步下漫游消息,并且已经存储到本地数据库中, 上层可通过 JMSGConversation 类中的获取message的方法刷新UI.

Declared In

JMSGConversationDelegate.h

– onReceiveChatRoomConversation:messages:

接收聊天室消息

- (void)onReceiveChatRoomConversation:(JMSGConversation *)conversation messages:(NSArray JMSG_GENERIC ( __kindof JMSGMessage *) *)messages

Parameters

conversation

聊天室会话

messages

接收到的消息数组,元素是 JMSGMessage

Availability

3.4.0

Discussion

注意:

接收聊天室的消息与单聊、群聊消息不同,聊天室消息都是通过这个代理方法来接收的。

Declared In

JMSGConversationDelegate.h

– onUnreadChanged:

当前剩余的全局未读数

- (void)onUnreadChanged:(NSUInteger)newCount

Parameters

newCount

变更后的数量

Declared In

JMSGConversationDelegate.h