文档中心

子区消息消息类型属于群聊消息类型，与普通群组消息的区别是需要添加 isChatThread 标记。本文介绍环信即时通讯 IM iOS SDK 如何发送、接收以及撤回子区消息。

技术原理

环信即时通讯 IM iOS SDK 提供 EMManager、EMChatMessage 和 EMChatThreadInfo 类，用于管理子区消息，支持你通过调用 API 在项目中实现如下功能：

• 发送子区消息
• 接收子区消息
• 撤回子区消息
• 获取子区消息

消息收发流程如下：

1. 客户端从应用服务器获取 token。
2. 客户端 A 和 B 登录即时通讯。
3. 客户端 A 向客户端 B 发送消息。消息发送至即时通讯 IM 服务器，服务器将消息传递给客户端 B。对于子区消息，服务器投递给子区内其他每一个成员。客户端 B 收到消息后，SDK 触发事件。客户端 B 监听事件并获取消息。

子区创建和查看如下图：

前提条件

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

• 完成 3.9.3 以上版本 SDK 初始化，详见 快速开始。
• 了解环信即时通讯 IM API 的 使用限制。
• 了解子区和子区成员数量限制，详见 使用限制。
• 联系商务开通子区功能。

实现方法

本节介绍如何使用环信即时通讯 IM SDK 提供的 API 实现上述功能。

发送子区消息

发送子区消息和发送群组消息的方法基本一致，详情请参考 发送消息。唯一不同的是，发送子区消息需要指定标记 isChatThread 为 YES。

单设备登录时，子区所属群组的所有成员会收到 EMChatThreadManagerDelegate#onChatThreadUpdated 回调。

示例代码如下：

// 创建一条文本消息，`content` 为消息文字内容，`chatThreadId` 为子区 ID。 NSString *from 

= [[EMClient sharedClient] currentUsername]; NSString *to = self.currentConversation.conversa

tionId; EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:to from:from 

to:to body:aBody ext:aExt]; // 是否需要消息已读回执。 if([aExt objectForKey:MSG_EXT_READ_RECEIPT]) 

{ message.isNeedGroupAck = YES; } message.chatType = (EMChatType)self.conversationType; message.

isChatThread = self.isChatThread; // 发送消息。 [[EMClient sharedClient].chatManager sendMessage:

message progress:nil completion:^(EMChatMessage *message, EMError *error) { }]; 

接收子区消息

接收消息的具体逻辑，请参考 接收消息，此处只介绍子区消息和其他消息的区别。

子区成员可以设置消息监听回调 EMManagerDelegate#messagesDidReceive 对子区消息的接收进行监听。

示例代码如下：

- (void)messagesDidReceive:(NSArray *)aMessages { // 做相关处理。 } // 添加消息监听器。

 [[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil]; // 移除消息监听器。

 [[EMClient sharedClient].chatManager removeDelegate:self]; 

撤回子区消息

撤回消息的具体逻辑，请参考 撤回消息，此处只介绍子区消息和其他消息的区别。

子区成员可以设置消息监听回调 EMChatManagerDelegate#messagesInfoDidRecall 对子区消息的撤回进行监听。

示例代码如下：

- (void)messagesInfoDidRecall:(NSArray<EMRecallMessageInfo *> *)aRecallMessagesInfo {} 

获取子区消息

从服务器还是本地数据库获取子区消息取决于你的生产环境。

进入单个子区会话后默认展示最早消息，用户可以从服务器获取子区历史消息；若需要合并本地和服务器拉取到的消息（例如有用户撤回子区消息的提示是 SDK 在本地生成的一条消息，可以选择从本地获取子区消息。

从服务器获取子区消息 (消息漫游)

从服务器获取子区消息，请参考 从服务器获取消息（消息漫游）。

从内存和本地数据库中获取子区消息

调用 EMChatManager#getAllConversations 方法只能获取单聊或群聊会话。要获取子区会话中的消息，参考以下示例代码：

// 需设置会话类型为 `EMConversationTypeGroupChat` 和 `isThread` 为 `YES` EMConversation* conversation

 = [EMClient.sharedClient.chatManager getConversation:conversationId type:EMConversationTypeGroupChat

 createIfNotExist:NO isThread:YES]; // 获取此子区会话的消息 [conversation loadMessagesStartFromId:@""

 count:20 searchDirection:EMMessageSearchDirectionUp completion:^(NSArray<EMChatMessage *> * _Nullable

 aMessages, EMError * _Nullable aError) { }];