options.enableDeliveryAck = YES;
// 继承并实现监听器。
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;
== 会话已读回执 ==
参考以下步骤在单聊中实现会话已读回执。
接收方发送会话已读回执。
消息接收方进入会话页面，查看会话中是否有未读消息。若有，发送会话已读回执，没有则不再发送。
[[EMClient sharedClient].chatManager ackConversationRead:conversationId completion:nil];
// 继承并实现监听器。
EMChatManagerDelegate
// 收到会话已读回执。
- (void)onConversationRead:(NSString *)from to:(NSString *)to
{
// 添加刷新页面通知等逻辑。
}
// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
// 移除监听器。
[[EMClient sharedClient].chatManager removeDelegate:self];
同一用户 ID 登录多设备的情况下，用户在一台设备上发送会话已读回执，服务器会将会话的未读消息数置为 ''%%0%%''，同时其他设备会收到 ''%%OnConversationRead%%'' 回调。
== 消息已读回执 ==
参考如下步骤在单聊中实现消息已读回执。
接收方发送已读回执消息。
消息接收方进入会话时，发送会话已读回执。
[[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];
}
// 继承并实现监听器。
EMChatManagerDelegate
// 接收到已读回执。
- (void)messagesDidRead:(NSArray *)aMessages
{
for (EMChatMessage *message in aMessages) {
// 添加刷新页面通知等逻辑。
}
}
// 注册监听器。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
// 移除监听器。
[[EMClient sharedClient].chatManager removeDelegate:self];
=== 群聊 ===
对于群消息，消息发送方（目前为群主和群管理员）可设置指定消息是否需要已读回执。
群消息已读回执功能为增值服务，仅旗舰版及以上支持。
- 设置 ''%%EMChatMessage%%'' 的属性 ''%%isNeedGroupAck%%'' 为 ''%%YES%%''。
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:to from:from to:to body:aBody ext:aExt];
message.isNeedGroupAck = YES;
- (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) {
}
}];
}
}
// 继承并实现监听器。
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%%'' 会有相应变化；
/**
* 从服务器获取指定群已读回执。
*
* 异步方法
*
* @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) {
// 页面刷新等操作。
}];
===== 更多操作 =====
你可以参考如下文档，在项目中实现更多的消息相关功能：
* [[ccim:ios:message1|消息管理功能概述]]；
* [[https://docs-im.easemob.com/ccim/ios/message2|发送和接收消息]]；
* [[https://docs-im.easemob.com/ccim/unity/message3|管理本地消息数据]]；
* [[https://docs-im.easemob.com/ccim/unity/message4|从服务器获取会话和消息（消息漫游）]]；
* [[https://docs-im.easemob.com/ccim/unity/translation|实现翻译功能]]。