发送和接收消息
发送和接收消息
登录即时通讯服务后,用户可以在单聊、群聊、聊天室中发送如下类型的消息:
- 文字消息,包含超链接和表情消息。
- 附件消息,包含图片、语音、视频及文件消息。
- 位置消息。
- 透传消息。
- 自定义消息。
- 合并消息。
- 定向消息。
针对聊天室消息并发量较大的场景,即时通讯服务提供消息分级功能。你可以通过设置消息优先级,将消息划分为高、普通和低三种级别。你可以在创建消息时,将指定消息类型,或指定成员的所有消息设置为高优先级,确保此类消息优先送达。这种方式可以确保在聊天室内消息并发量较大或消息发送频率过高的情况下,服务器首先丢弃低优先级消息,将资源留给高优先级消息,确保重要消息(如打赏、公告等)优先送达,以此提升重要消息的可靠性。请注意,该功能并不保证高优先级消息必达。在聊天室内消息并发量过大的情况下,为保证用户实时互动的流畅性,即使是高优先级消息仍然会被丢弃。
本文介绍如何使用即时通讯 IM SDK 实现发送和接收这些类型的消息。
技术原理
环信即时通讯 IM iOS SDK 提供 ChatManager
类和 EMChatMessage
类,支持发送、接收消息,发送、接收消息已读回执,并管理用户设备上存储的消息会话数据,其中包含如下主要方法:
sendMessage
发送消息给某个用户,群组或者聊天室;recallMessage
撤回自己发出的消息;addMessageListener
添加消息接收的回调通知;ackConversationRead
发送会话已读通知;ackMessageRead
发送指定消息已读的通知;
消息的收发流程如下:
- 用户 A 发送一条消息到环信即时通讯 IM 消息服务器。
- 消息服务器投递消息给用户 B,用户 B 收到该消息。
前提条件
开始前,请确保满足以下条件:
实现方法
发送文本消息
你可以利用 EMChatMessage
类构造一条消息,然后通过 ChatManager
将该消息发出。
默认情况下,SDK 对单个用户发送消息的频率未做限制。如果你联系了环信商务设置了该限制,一旦在单聊、群聊或聊天室中单个用户的消息发送频率超过设定的上限,SDK 会上报错误,即错误码 509 EMErrorMessageCurrentLimiting
。
示例代码:
// 创建一条文本消息,`content` 为消息文字内容,`toChatUsername` 为对方用户或者群聊的 ID,`fromChatUsername` 为发送方用户或群聊的 ID,`textMessageBody` 为消息体,`messageExt` 为消息扩展,后文皆是如此。
EMTextMessageBody *textMessageBody = [[TextMessageBody alloc] initWithText:content];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:textMessageBody ext:messageExt];
// 构造消息时需设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeChat;
// 发送消息,异步方法。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
// 发送消息时可以设置发送回调,获得消息发送状态。可以在该回调中更新消息的显示状态。例如消息发送失败后的提示等等。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:^(EMChatMessage *message, EMError *error) {
if (!error) {
// 发送消息成功!
} else {
// 发送消息失败!
}
}];
对于聊天室消息,可设置消息优先级。示例代码如下:
EMTextMessageBody* textBody = [[EMTextMessageBody alloc] initWithText:@"Hi"];
EMChatMessage* message = [[EMChatMessage alloc] initWithConversationID:@"roomId" body:textBody ext:nil];
message.chatType = EMChatTypeChatRoom;
// 聊天室消息的优先级。如果不设置,默认值为 `Normal`,即“普通”优先级。
message.priority = EMChatRoomMessagePriorityHigh;
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
接收消息
你可以用注册监听 EMChatManagerDelegate
接收消息。
该 EMChatManagerDelegate
可以多次添加,请记得在不需要的时候移除 Delegate
,如在ViewController
dealloc()
时。
在新消息到来时,你会收到 messagesDidReceive
的回调,消息接收时可能是一条,也可能是多条。你可以在该回调里遍历消息队列,解析并显示收到的消息。
// 添加代理。
[[EMClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
// 收到消息回调。
- (void)messagesDidReceive:(NSArray *)aMessages
{
// 收到消息,遍历消息列表。
for (EMChatMessage *message in aMessages) {
// 消息解析和展示。
}
}
// 移除代理。
- (void)dealloc
{
[[EMClient sharedClient].chatManager removeDelegate:self];
}
撤回消息
发送方可以撤回一条发送成功的消息。默认情况下,发送方可撤回发出 2 分钟内的消息。你可以在 环信即时通讯云控制台的服务管理 > 服务概览 页面设置消息撤回时长,该时长不超过 7 天。
// 异步方法
[[EMClient sharedClient].chatManager recallMessageWithMessageId:messageId completion:^(EMError *aError) {
if (!aError) {
NSLog(@"撤回消息成功");
} else {
NSLog(@"撤回消息失败的原因 --- %@", aError.errorDescription);
}
}];
设置消息撤回回执
- (void)messagesDidRecall:(NSArray *)aMessages
{
// `aMessages` 为被撤回的消息列表
}
发送和接收附件类型的消息
除文本消息外,SDK 还支持发送附件类型消息,包括语音、图片、视频和文件消息。
附件消息的发送和接收过程如下:
- 创建和发送附件类型消息。SDK 将附件上传到环信服务器。
- 接收附件消息。SDK 自动下载语音消息,默认自动下载图片和视频的缩略图。若下载原图、视频和文件,需调用
downloadAttachment
方法。 - 获取附件的服务器地址和本地路径。
此外,发送附件类型消息时,可以在 progress 回调中获取附件上传的进度,以百分比表示,示例代码如下:
// 发送消息时可以设置 completion 回调,在该回调中更新消息的显示状态。例如消息发送失败后的提示等等。
[[EMClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
// progress 为附件上传进度块的百分比。
} completion:^(EMChatMessage *message, EMError *error) {
// error 为发送结果,message 为发送的消息。
}];
发送和接收语音消息
发送和接收语音消息的过程如下:
- 发送语音消息前,在应用层录制语音文件。
- 发送方调用
initWithLocalPath
和initWithConversationID
方法传入语音文件的 URI、语音时长和接收方的用户 ID(群聊或聊天室分别为群组 ID 或聊天室 ID)创建语音消息,然后调用sendMessage
方法发送消息。SDK 会将文件上传至环信服务器。
// `localPath` 为语音文件本地资源路径,`displayName` 为附件的显示名称。
EMVoiceMessageBody *body = [[EMVoiceMessageBody alloc] initWithLocalPath:localPath displayName:displayName];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
接收方收到语音消息时,自动下载语音文件。
接收方收到
messagesDidReceive
回调,调用remotePath
或localPath
方法获取语音文件的服务器地址或本地路径,从而获取语音文件。
EMVoiceMessageBody *voiceBody = (EMVoiceMessageBody *)message.body;
// 获取语音文件在服务器的地址。
NSString *voiceRemotePath = voiceBody.remotePath;
// 本地语音文件的资源路径。
NSString *voiceLocalPath = voiceBody.localPath;
发送和接收图片消息
发送和接收图片消息的流程如下:
- 发送方调用
initWithData
和initWithConversationID
方法传入图片的本地资源标志符 URI、设置是否发送原图以及接收方的用户 ID (群聊或聊天室分别为群组 ID 或聊天室 ID)创建图片消息,然后调用sendMessage
方法发送该消息。SDK 会将图片上传至环信服务器,服务器自动生成图片缩略图。
// `imageData` 为图片本地资源,`displayName` 为附件的显示名称。
EMImageMessageBody *body = [[EMImageMessageBody alloc] initWithData:imageData displayName:displayName];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
// 发送成功后,获取图片消息缩略图及附件。
EMImageMessageBody *body = (EMImageMessageBody *)message.body;
// 从服务器端获取图片文件。
NSString *remotePath = body.remotePath;
// 从服务器端获取图片缩略图。
NSString *thumbnailPath = body.thumbnailRemotePath;
// 从本地获取图片文件。
NSString *localPath = body.localPath;
// 从本地获取图片缩略图。
NSString *thumbnailLocalPath = body.thumbnailLocalPath;
- 接收方收到图片消息,自动下载图片缩略图。
SDK 默认自动下载缩略图,即 [EMClient sharedClient].options.isAutoDownloadThumbnail;
为 YES
。若设置为手动下载缩略图,即 [EMClient sharedClient].options.isAutoDownloadThumbnail(NO);
,需调用 [[EMClient sharedClient].chatManager downloadMessageThumbnail:message progress:nil completion:nil];
下载。
- 接收方收到
messagesDidReceive
回调,调用downloadMessageAttachment
下载原图。
下载完成后,在回调里调用相应消息 body
的 thumbnailLocalPath
获取缩略图路径。
EMImageMessageBody *imageBody = (EMImageMessageBody *)message.body;
// 图片文件的本地缩略图资源路径。
NSString *thumbnailLocalPath = imageBody.thumbnailLocalPath;
- 获取图片消息的附件。
[[EMClient sharedClient].chatManager downloadMessageAttachment:message progress:nil completion:^(EMChatMessage *message, EMError *error) {
if (!error) {
EMImageMessageBody *imageBody = (EMImageMessageBody *)message.body;
NSString *localPath = imageBody.localPath;
}
}];
发送和接收视频消息
发送和接收视频消息的流程如下:
发送视频消息前,在应用层完成视频文件的选取或者录制。
发送方调用
initWithLocalPath
方法传入视频文件的本地资源标志符、消息的显示名称和视频时长,构建视频消息体。然后,调用initWithConversationID
方法传入会话 ID 和视频消息体,构建视频消息。最后,调用sendMessage
方法发送消息。SDK 会将视频文件上传至环信消息服务器,自动将视频的首帧作为视频缩略图。
// `localPath` 为本地资源路径,`displayName` 为视频的显示名称。
EMVideoMessageBody *body = [[EMVideoMessageBody alloc] initWithLocalPath:localPath displayName:@"displayName"];
body.duration = duration;// 视频时长。
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
- 接收方收到视频消息时,自动下载视频缩略图。
SDK 默认自动下载缩略图,即 [EMClient sharedClient].options.isAutoDownloadThumbnail;
为 YES
。若设置为手动下载缩略图,即 [EMClient sharedClient].options.isAutoDownloadThumbnail(NO);
,需调用 [[EMClient sharedClient].chatManager downloadMessageThumbnail:message progress:nil completion:nil];
下载。
接收方收到
messagesDidReceive
回调,可以调用downloadMessageAttachment
方法下载视频原文件。获取视频缩略图和视频原文件。
// 发送成功后,获取视频消息缩略图及附件。
EMVideoMessageBody *body = (EMVideoMessageBody *)message.body;
// 从服务器端获取视频文件的地址。
NSString *remotePath = body.remotePath;
// 从服务器端获取视频缩略图。
NSString *thumbnailPath = body.thumbnailRemotePath;
// 从本地获取视频文件。
NSString *localPath = body.localPath;
// 从本地获取视频缩略图。
NSString *thumbnailLocalPath = body.thumbnailLocalPath;
发送和接收文件消息
发送和接收文件消息的流程如下:
- 发送方调用
initWithData
和initWithConversationID
方法传入文件的本地资源标志符和接收方的用户 ID(群聊或聊天室分别为群组 ID 或聊天室 ID)创建文件消息,然后调用sendMessage
方法发送文件消息。SDK 将文件上传至环信服务器。
// `fileData` 为本地资源,`fileName` 为附件的显示名称。
EMFileMessageBody *body = [[EMFileMessageBody alloc] initWithData:fileData displayName:fileName];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
- 接收方收到
messagesDidReceive
回调,调用downloadMessageAttachment
方法下载文件。
[[EMClient sharedClient].chatManager downloadMessageAttachment:message progress:nil completion:^(EMChatMessage *message, EMError *error) {
if (!error) {
// 附件下载成功
}
}];
- 调用以下方法从服务器或本地获取文件附件:
EMFileMessageBody *body = (EMFileMessageBody *)message.body;
// 从服务器端获取文件路径。
NSString *remotePath = body.remotePath;
// 从本地获取文件路径。
NSString *localPath = body.localPath;
发送位置消息
当你需要发送位置时,需要集成第三方的地图服务,获取到位置点的经纬度信息。接收方接收到位置消息时,需要将该位置的经纬度,借由第三方的地图服务,将位置在地图上显示出来。
// `latitude` 为纬度,`longitude` 为经度,`address` 为具体位置内容。
EMLocationMessageBody *body = [[EMLocationMessageBody alloc] initWithLatitude:latitude longitude:longitude address:aAddress];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
message.chatType = EMChatTypeChat;
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
发送透传消息
可以把透传消息理解为一条指令,通过发送这条指令给对方,通知对方要执行的操作,收到消息可以自定义处理。(透传消息不会存入本地数据库中,所以在 UI 上不会显示)。另外,以 “em_” 和 “easemob::” 开头的 action
为内部保留字段,注意不要使用。
透传消息适用于更新头像、更新昵称等场景。
// `action` 自定义 `NSString` 类型的命令内容。
EMCmdMessageBody *body = [[EMCmdMessageBody alloc] initWithAction:action];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
// 若为群聊,添加下行代码。
message.chatType = EMChatTypeGroupChat;
// 若为聊天室,添加下行代码。
//message.chatType = EMChatTypeChatRoom;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
请注意透传消息的接收方,也是由单独的回调进行通知,方便用户进行不同的处理。
// 收到透传消息。
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages{
for (EMChatMessage *message in aCmdMessages) {
EMCmdMessageBody *body = (EMCmdMessageBody *)message.body;
// 进行透传消息 body 解析。
}
}
通过透传消息实现输入指示器
输入指示器显示其他用户何时输入消息。通过该功能,用户之间可进行有效沟通,增加了用户对聊天应用中交互的期待感。
你可以通过透传消息实现输入指示器。
下图为输入指示器的工作原理。
监听用户 A 的输入状态。一旦有文本输入,通过透传消息将输入状态发送给用户 B,用户 B 收到该消息,了解到用户 A 正在输入文本。
- 用户 A 向用户 B 发送消息,通知其开始输入文本。
- 收到消息后,如果用户 B 与用户 A 的聊天页面处于打开状态,则显示用户 A 的输入指示器。
- 如果用户 B 在几秒后未收到用户 A 的输入,则自动取消输入指示器。
提示
用户 A 可根据需要设置透传消息发送间隔。
以下示例代码展示如何发送输入状态的透传消息。
//发送表示正在输入的透传消息
#define MSG_TYPING_BEGIN @"TypingBegin"
- (void)textViewDidChange:(UITextView *)textView
{
long long currentTimestamp = [self getCurrentTimestamp];
// 5 秒内不能重复发送消息
if ((currentTimestamp - _previousChangedTimeStamp) > 5) {
// 发送开始输入的透传消息
[self _sendBeginTyping];
_previousChangedTimeStamp = currentTimestamp;
}
}
- (void)_sendBeginTyping
{
EMCmdMessageBody *body = [[EMCmdMessageBody alloc] initWithAction:MSG_TYPING_BEGIN];
body.isDeliverOnlineOnly = YES;
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId body:body ext:nil];
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
}
以下示例代码展示如何接受和解析输入状态的透传消息。
#define TypingTimerCountNum 10
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages
{
NSString *conId = self.currentConversation.conversationId;
for (EMChatMessage *message in aCmdMessages) {
if (![conId isEqualToString:message.conversationId]) {
continue;
}
EMCmdMessageBody *body = (EMCmdMessageBody *)message.body;
// 收到正在输入的透传消息
if ([body.action isEqualToString:MSG_TYPING_BEGIN]) {
if (_receiveTypingCountDownNum == 0) {
[self startReceiveTypingTimer];
}else {
_receiveTypingCountDownNum = TypingTimerCountNum;
}
}
}
}
- (void)startReceiveTypingTimer {
[self stopReceiveTypingTimer];
_receiveTypingCountDownNum = TypingTimerCountNum;
_receiveTypingTimer = [NSTimer scheduledTimerWithTimeInterval:1.0 target:self selector:@selector(startReceiveCountDown) userInfo:nil repeats:YES];
[[NSRunLoop currentRunLoop] addTimer:_receiveTypingTimer forMode:UITrackingRunLoopMode];
[_receiveTypingTimer fire];
// 这里需更新 UI,显示“对方正在输入”
}
- (void)startReceiveCountDown
{
if (_receiveTypingCountDownNum == 0) {
[self stopReceiveTypingTimer];
// 这里需更新 UI,不再显示“对方正在输入”
return;
}
_receiveTypingCountDownNum--;
}
- (void)stopReceiveTypingTimer {
_receiveTypingCountDownNum = 0;
if (_receiveTypingTimer) {
[_receiveTypingTimer invalidate];
_receiveTypingTimer = nil;
}
}
发送自定义类型消息
除了几种消息之外,你可以自己定义消息类型,方便业务处理,即首先设置一个消息类型名称,然后可添加多种自定义消息。自定义消息内容为 String 类型的 key-value 格式,你需要自己添加并解析该内容。
// event 为需要传递的自定义消息事件,比如名片消息,可以设置 "userCard";`ext` 为事件扩展字段,比如可以设置 `uid`,`nickname`,`avatar`。
EMCustomMessageBody* body = [[EMCustomMessageBody alloc] initWithEvent:@"userCard" ext:@{@"uid":aUid ,@"nickname":aNickName,@"avatar":aUrl}];
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:body ext:messageExt];
message.chatType = EMChatTypeChat;
// 设置 `EMChatMessage` 类的 `ChatType` 属性,可设置为 `EMChatTypeChat`、`EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`,即单聊、群聊或聊天室消息,默认为单聊。
message.chatType = EMChatTypeGroupChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
发送和接收合并消息
为了方便消息互动,即时通讯 IM 自 4.1.0 版本开始支持将多个消息合并在一起进行转发。你可以采取以下步骤进行消息的合并转发:
- 利用原始消息列表创建一条合并消息。
- 发送合并消息。
- 对端收到合并消息后进行解析,获取原始消息列表。
创建和发送合并消息
你可以调用 EMCombineMessageBody#initWithTitle:summary:compatibleText:messageList
方法构造一条合并消息体,然后创建消息 EMChatMessage
并调用 sendMessage
方法发送该条消息。
创建合并消息体时,需要设置以下参数:
属性 | 类型 | 描述 |
---|---|---|
title | String | 合并消息的标题。 |
summary | String | 合并消息的概要。 |
compatibleText | String | 合并消息的兼容文本。 兼容文本起向下兼容不支持消息合并转发的版本的作用。当支持合并消息的 SDK 向不支持合并消息的低版本 SDK 发送消息时,低版本的 SDK 会将该属性解析为文本消息的消息内容。 |
messageIdList | List | 合并消息的原始消息 ID 列表。该列表最多包含 300 个消息 ID。 |
提示
- 合并转发支持嵌套,最多支持 10 层嵌套,每层最多 300 条消息。
- 只有成功发送或接收的消息才能合并转发。
- 不论
EMOptions#isAutoTransferMessageAttachments
设置为false
或true
,SDK 都会将合并消息附件上传到环信服务器。
示例代码如下:
EMCombineMessageBody* combineMsgBody = [[EMCombineMessageBody alloc] initWithTitle:@"combineTitle" summary:@"combineSummary" compatibleText:@"combineCompatibleText" messageIdList:@[@"messageId1",@"messageId2"]];
EMChatMessage* msg = [[EMChatMessage alloc] initWithConversationID:@"conversationId" body:combineMsgBody ext:nil];
[EMClient.sharedClient.chatManager sendMessage:msg progress:nil completion:^(EMChatMessage * _Nullable message, EMError * _Nullable error) {
}];
接收合并消息与接收普通消息的操作相同,详见接收消息。
对于不支持合并转发消息的 SDK 版本,该类消息会被解析为文本消息,消息内容为 compatibleText
携带的内容,其他字段会被忽略。
解析合并消息
合并消息实际上是一种附件消息。收到合并消息后,你可以调用 downloadAndParseCombineMessage
方法下载合并消息附件并解析出原始消息列表。
对于一条合并消息,首次调用该方法会下载和解析合并消息附件,然后返回原始消息列表,而后续调用会存在以下情况:
- 若附件已存在,该方法会直接解析附件并返回原始消息列表。
- 若附件不存在,该方法首先下载附件,然后解析附件并返回原始消息列表。
- (void)messagesDidReceive:(NSArray<EMChatMessage *> *)aMessages
{
for (EMChatMessage* msg in aMessages) {
if (msg.body.type == EMMessageBodyTypeCombine) {
// 合并消息类型,解析合并消息
[EMClient.sharedClient.chatManager downloadAndParseCombineMessage:msg completion:^(NSArray<EMChatMessage *> * _Nullable messages, EMError * _Nullable error) {
}];
}
}
}
发送和接收定向消息
发送定向消息是指向群组或聊天室的单个或多个指定的成员发送消息,其他成员不会收到该消息。
该功能适用于文本消息、图片消息和音视频消息等全类型消息,最多可向群组或聊天室的 20 个成员发送定向消息。
提示
- 仅 SDK 4.0.3 及以上版本支持。
- 定向消息不计入群组会话或聊天室会话的未读计数。
发送定向消息的流程与发送普通消息相似,唯一区别是需要设置消息的接收方,具体操作如下:
- 创建一条群组或聊天室消息。
- 设置消息的接收方。
- 发送定向消息。
下面以文本消息为例介绍如何发送定向消息,示例代码如下:
// 创建一条文本消息。
EMTextMessageBody* textBody = [[EMTextMessageBody alloc] initWithText:@"hello"];
EMChatMessage* msg = [[EMChatMessage alloc] initWithConversationID:@"groupId" body:textBody ext:nil];
// 会话类型:群组和聊天室聊天,分别为 `EMChatTypeGroupChat` 和 `EMChatTypeChatRoom`。
msg.chatType = EMChatTypeGroupChat;
// 设置消息接收方列表。最多可传 20 个接收方的用户 ID。若传入 `nil`,则消息发送给群组或聊天室的所有成员。
msg.receiverList = @[@"A",@"B"];
// 发送消息。
[EMClient.sharedClient.chatManager sendMessage:msg progress:nil completion:^(EMChatMessage * _Nullable message, EMError * _Nullable error) {
}];
接收定向消息与接收普通消息的操作相同,详见接收消息。
使用消息的扩展字段
当 SDK 提供的消息类型不满足需求时,你可以通过消息扩展字段来传递自定义的内容,从而生成自己需要的消息类型。
当目前消息类型不满足用户需求时,可以在扩展部分保存更多信息,例如消息中需要携带被回复的消息内容或者是图文消息等场景。
EMTextMessageBody *textMessageBody = [[EMTextMessageBody alloc] initWithText:content];
// 增加自定义属性。
NSDictionary *messageExt = @{@"attribute":@"value"};
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:toChatUsername from:fromChatUsername to:toChatUsername body:textMessageBody ext:messageExt];
message.chatType = EMChatTypeChat;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];
// 接收消息的时候获取扩展属性。
- (void)messagesDidReceive:(NSArray *)aMessages
{
// 收到消息,遍历消息列表。
for (EMChatMessage *message in aMessages) {
// value 为消息扩展里 attribute 字段的值。
NSString *value = [message.ext objectForKey:@"attribute"]; }
}