消息管理–管理消息回执

更新时间：2022-07-06

用户在单聊中发送消息后，可以查看该消息的送达和已读状态，了解接收方是否及时收到并阅读了消息，也可以了解整个会话是否已读。

用户在群聊中发送信息后，可以查看该消息的已读状态。

本文介绍如何使用环信即时通讯 IM iOS SDK 的消息已读回执和送达回执在 app 中实现上述功能。

使用环信即时通讯 IM iOS SDK 可以实现消息的送达回执与已读回执。核心方法如下：

• enableRequireReadAck 开启送达回执；
• ackConversationRead 发出指定会话的已读回执；
• sendMessageReadAck 发出指定消息的已读回执；
• sendGroupMessageReadAck 发出群组消息的已读回执。

实现送达回执和已读回执逻辑分别如下：

消息送达回执：

1. 你可以通过设置 options.enableDeliveryAck 开启送达回执功能；
2. 消息接收方收到消息后，SDK 自动向发送方触发送达回执；
3. 消息发送方通过监听 OnMessageDelivered 回调接收消息送达回执。

已读回执：

• 单聊会话及消息已读回执
  1. 你可以通过设置 enableRequireReadAck 开启已读回执功能；
  2. 消息接收方收到消息后，调用 API sendConversationReadAck 或 sendMessageReadAck 发送会话或消息已读回执；
  3. 消息发送方通过监听 onConversationRead 或 OnMessageRead 回调接收会话或消息已读回执。
• 群聊只支持消息已读回执：
  1. 你可以通过设置 isNeedGroupAck 开启群聊消息已读回执功能；
  2. 消息接收方收到消息后通过 sendGroupMessageReadAck 发送群组消息的已读回执。

开始前，请确保满足以下条件：

• 完成 SDK 初始化，并连接到服务器，详见 快速开始。
• 了解环信即时通讯 IM 的使用限制，详见 使用限制。
• 在群组中实现消息已读回执功能默认不开启。如需使用，请联系商务开通。

1. 打开消息送达开关，即将 enableDeliveryAck 设置为 YES，当接收方收到消息后，SDK 底层会自动进行消息送达回执。

options.enableDeliveryAck = YES;

2. 发送方监听事件 onMessageDelivered 回调，收到接收方的送达回执。

// 继承并实现监听器。
EMChatManagerDelegate

// 收到消息送达回执。
- (void)messagesDidDeliver:(NSArray *)aMessages
{
    
}
// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];

// 记得在不需要的时候移除监听器，如在 viewController 的 dealloc 时。
[[EMClient sharedClient].chatManager removeDelegate:self];

消息已读回执用于告知单聊或群聊中的用户接收方已阅读其发送的消息。为降低消息已读回执方法的调用次数，SDK 还支持在单聊中使用会话已读回执功能，用于获知接收方是否阅读了会话中的未读消息。

单聊既支持消息已读回执，也支持会话已读回执。我们建议你按照如下逻辑结合使用两种回执，减少发送消息已读回执数量。

• 聊天页面未打开时，若有未读消息，进入聊天页面，发送会话已读回执；
• 聊天页面打开时，若收到消息，发送消息已读回执。

发送方若要接收消息已读回执，你首先需要设置打开已读回执，即将 enableRequireReadAck 设置为 YES，当接收方阅读消息后，SDK 底层会自动进行消息已读回执。

options.enableRequireReadAck = YES;

参考以下步骤在单聊中实现会话已读回执。

1. 接收方发送会话已读回执。

   消息接收方进入会话页面，查看会话中是否有未读消息。若有，发送会话已读回执，没有则不再发送。

[[EMClient sharedClient].chatManager ackConversationRead:conversationId completion:nil];

2. 消息发送方监听会话已读回执的回调。

// 继承并实现监听器。
EMChatManagerDelegate

// 收到会话已读回执。
- (void)onConversationRead:(NSString *)from to:(NSString *)to
  {
    // 添加刷新页面通知等逻辑。
  }
// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];

// 移除监听器。
[[EMClient sharedClient].chatManager removeDelegate:self];

同一用户 ID 登录多设备的情况下，用户在一台设备上发送会话已读回执，服务器会将会话的未读消息数置为 0，同时其他设备会收到 OnConversationRead 回调。

参考如下步骤在单聊中实现消息已读回执。

1. 接收方发送已读回执消息。

   消息接收方进入会话时，发送会话已读回执。

[[EMClient sharedClient].chatManager sendMessageReadAck:messageId toUser:conversationId completion:nil];

在会话页面，接收到消息时，根据消息类型发送消息已读回执，如下所示：

// 接收消息回调。
- (void)messagesDidReceive:(NSArray *)aMessages
  {
    for (EMChatMessage *message in aMessages) {
        //发送消息已读回执。
        [self sendReadAckForMessage:message];
    }
  }

/**
  * 发送已读回执。
  * @param message
  */
- (void)sendReadAckForMessage:(EMChatMessage *)aMessage
  {
    //这里是接收的消息，未发送过 read ack 消息且是单聊。
    if (aMessage.direction == EMMessageDirectionSend || aMessage.isReadAcked || aMessage.chatType != EMChatTypeChat)
        return;

    EMMessageBody *body = aMessage.body;
    // 视频、语音及文件需要点击后再发送,可以根据需求进行调整。
    if (body.type == EMMessageBodyTypeFile || body.type == EMMessageBodyTypeVoice || body.type == EMMessageBodyTypeImage)
        return;

    [[EMClient sharedClient].chatManager sendMessageReadAck:aMessage.messageId toUser:aMessage.conversationId completion:nil];
  }

2. 消息发送方监听消息已读回调。

可以调用接口监听某个消息是否已读，示例代码如下：

// 继承并实现监听器。
EMChatManagerDelegate

// 接收到已读回执。
- (void)messagesDidRead:(NSArray *)aMessages
  {
    for (EMChatMessage *message in aMessages) {
        // 添加刷新页面通知等逻辑。
    }
  }
// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];

// 移除监听器。
[[EMClient sharedClient].chatManager removeDelegate:self];

对于群消息，消息发送方（目前为群主和群管理员）可设置指定消息是否需要已读回执。

群消息已读回执功能为增值服务，仅旗舰版及以上支持。

1. 设置 EMChatMessage 的属性 isNeedGroupAck 为 YES。

EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:to from:from to:to body:aBody ext:aExt];
message.isNeedGroupAck = YES;

2. 发送群组消息的已读回执。

- (void)sendGroupMessageReadAck:(EMChatMessage *)msg
  {
    if (msg.isNeedGroupAck && !msg.isReadAcked) {
        [[EMClient sharedClient].chatManager sendGroupMessageReadAck:msg.messageId toGroup:msg.conversationId content:@"123" completion:^(EMError *error) {
            if (error) {

            }
        }];
    }
  }

3. 消息发送方监听群组消息已读回调。

群消息已读回调在回调代理 EMChatManagerDelegate 中实现。

// 继承并实现监听器。
EMChatManagerDelegate

// 接收到群组消息的已读回执, 消息的接收方已经阅读此消息。
- (void)groupMessageDidRead:(EMChatMessage *)aMessage groupAcks:(NSArray *)aGroupAcks
  {
    for (GroupMessageAck *messageAck in aGroupAcks) {
        //receive group message read ack
    }
  }

// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];

// 移除监听器。
[[EMClient sharedClient].chatManager removeDelegate:self];

接收到群组消息已读回执后，发出消息的属性 groupAckCount 会有相应变化；

4. 消息发送方获取群组消息的已读回执详情。

你可以调用 asyncFetchGroupMessageAcksFromServer 获取到已读回执的详情。

/**
 * 从服务器获取指定群已读回执。
 *
 * 异步方法
 *
 * @param  aMessageId           要获取的消息 ID。
 * @param  aGroupId             要获取回执对应的群 ID。
 * @param  aGroupAckId          要获取的群回执 ID。
 * @param  aPageSize            获取消息条数。
 * @param  aCompletionBlock     获取消息结束的回调。
 */
[[EMClient sharedClient].chatManager asyncFetchGroupMessageAcksFromServer:messageId groupId:groupId startGroupAckId:nil pageSize:pageSize completion:^(EMCursorResult *aResult, EMError *error, int totalCount) {
   // 页面刷新等操作。
   }];

你可以参考如下文档，在项目中实现更多的消息相关功能：

• 消息管理功能概述；
• 发送和接收消息；
• 管理本地消息数据；
• 从服务器获取会话和消息（消息漫游）；
• 实现翻译功能。