跳到主要内容

发送群定向消息

SDK 支持往群聊会话中发送定向消息。定向消息只会发送给指定用户,群聊会话中的其它用户不会收到这条消息。

开通服务

使用发送群组定向消息功能无需开通服务。注意,如需将群组定向消息存入服务端历史消息记录,需要开通以下服务:

  • 单群聊历史消息云存储服务,可前往控制台 IM 服务管理页面为当前使用的 App Key 开启服务。IM 旗舰版IM 尊享版可开通该服务。具体功能与费用以融云官方价格说明页面及计费说明文档为准。
  • 群定向消息云存储服务,需要提交工单申请开通。

默认情况下,客户端发送与接收的群定向消息默认都不会存入历史消息服务,因此客户端调用获取历史消息的 API 时,从融云服务端返回的结果中不会包含当前用户发送、接收的群组定向消息。

发送定向普通消息

在群组中发送普通消息给指定的单个或多个用户。

以发送文本消息为例,您需要构造 RCMessage,然后调用 sendDirectionalMessage:toUserIdList:pushContent:pushData:attached:successBlock:errorBlock: 发送消息。注意,RCMessage 中仅保存群组 ID(Target ID),不会保存接收用户 ID 列表。

RCTextMessage *text = [RCTextMessage messageWithContent:@"你好"];
RCMessage *message = [[RCMessage alloc] initWithType:ConversationType_GROUP targetId:@"Group1" direction:MessageDirection_SEND messageId:-1 content:text];

[[RCCoreClient sharedCoreClient] sendDirectionalMessage:message
toUserIdList:@[@"user1",@"user2"]
pushContent:nil
pushData:nil
successBlock:^(RCMessage *successMessage) {

} errorBlock:^(RCErrorCode nErrorCode, RCMessage *errorMessage) {

}];
参数类型说明
messageRCMessage消息对象
userIdListNSArray将要发送的用户列表
pushContentNSString自定义推送显示内容
pushDataNSString远程推送的附加信息
successBlockBlock发送消息成功的回调
errorBlockBlock发送消息失败的回调,其中包含错误码 RCErrorCode 和发送失败的消息

发送定向媒体消息

提示

SDK 从 5.2.5 版本开始支持往群聊中发送定向媒体消息。

在群聊中发送多媒体消息给指定的单个或多个用户。

以发送图片消息为例,您需要构造 RCMessage,然后调用 sendDirectionalMediaMessage:toUserIdList:pushContent:pushData:attached:progress:successBlock:errorBlock:cancel: 发送消息。注意,RCMessage 中仅保存群组 ID(Target ID),不会保存接收用户 ID 列表。

RCImageMessage *imageMessage = [RCImageMessage messageWithImageURI:@"https://test.png"];
RCMessage *message = [[RCMessage alloc] initWithType:ConversationType_GROUP targetId:@"Group1" direction:MessageDirection_SEND messageId:-1 content:imageMessage];

[[RCCoreClient sharedCoreClient] sendDirectionalMediaMessage:message toUserIdList:@[@"user1",@"user2"] pushContent:nil pushData:nil progress:^(int progress, RCMessage * _Nonnull progressMessage) {
// 多媒体上传进度回调
} successBlock:^(RCMessage * _Nonnull successMessage) {
// 发送成功
} errorBlock:^(RCErrorCode nErrorCode, RCMessage * _Nonnull errorMessage) {
// 发送失败
} cancel:^(RCMessage * _Nonnull cancelMessage) {
// 用户取消发送
}];
参数类型说明
messageRCMessage消息对象
userIdListNSArray将要发送的用户列表
pushContentNSString自定义推送显示内容
pushDataNSString远程推送的附加信息
progressBlock发送消息进度更新的回调
successBlockBlock发送消息成功的回调
errorBlockBlock发送消息失败的回调,其中包含错误码 RCErrorCode 和发送失败的消息
cancelBlock用户取消消息发送的回调