文档导航
Flutter
SDK 版本:  5.X

发送群定向消息

更新时间:2024-02-23 PDF

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

当前仅支持发送普通消息,不支持发送媒体消息。

开通服务

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

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

发送群组定向普通消息

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

方法

Future<int> sendGroupMessageToDesignatedUsers(RCIMIWMessage message, List<String> userIds, {RCIMIWSendGroupMessageToDesignatedUsersCallback? callback});
              
已复制
1

参数说明

参数名 参数类型 描述
message RCIMIWMessage 要发送的消息
userIds List<String> 群成员集合
callback RCIMIWSendGroupMessageToDesignatedUsersCallback 事件回调。SDK 从 5.3.1 版本开始支持 callback 方式回调。从 5.4.0 版本废弃该接口的其他回调方式。如果传入了 callback 参数,仅触发 callback 回调。

返回值

返回值 描述
Future<int> 当次接口操作的状态码。0 代表调用成功 具体结果需要实现接口回调,非 0 代表当前接口调用操作失败,不会触发接口回调,详细错误参考错误码

代码示例

RCIMIWSendGroupMessageToDesignatedUsersCallback? callback = RCIMIWSendGroupMessageToDesignatedUsersCallback(onMessageSaved: (RCIMIWMessage? message) {
//...
}, onMessageSent: (int? code, RCIMIWMessage? message) {
//...
});

int? ret = await engine?.sendGroupMessageToDesignatedUsers(message, userIds, callback:callback);
              
已复制
1
2
3
4
5
6
7

回调方法

  • onGroupMessageToDesignatedUsersAttached

    消息存入数据库的监听

Function(RCIMIWMessage? message)? onGroupMessageToDesignatedUsersAttached;
              
已复制
1

参数说明

参数名 参数类型 描述
message RCIMIWMessage 发送的消息内容

代码示例

engine?.onGroupMessageToDesignatedUsersAttached = (RCIMIWMessage? message) {
//...
};
              
已复制
1
2
3

  • onGroupMessageToDesignatedUsersSent

    消息发送收到结果的回调

Function(int? code, RCIMIWMessage? message)? onGroupMessageToDesignatedUsersSent;
              
已复制
1

参数说明

参数名 参数类型 描述
code int 接口回调的状态码,0 代表成功,非 0 代表出现异常
message RCIMIWMessage 发送的消息内容

代码示例

engine?.onGroupMessageToDesignatedUsersSent = (int? code, RCIMIWMessage? message) {
//...
};
              
已复制
1
2
3

文档反馈
意见反馈

您的改进建议

意见反馈

问题类型

联系我们

提交工单

技术支持|集成使用|产品方案


商务咨询

7 x 24 小时

为您解答方案与报价问题

131 6185 6839

文档反馈