发送群定向消息
SDK 支持往群聊会话中发送定向消息。定向消息只会发送给指定用户,群聊会话中的其它用户不会收到这条消息。
当前仅支持发送普通消息,不支持发送媒体消息。
开通服务
使用发送群组定向消息功能无需开通服务。注意,如需将群组定向消息存入服务端历史消息记录,需要开通以下服务:
- 单群聊历史消息云存储服务。可前往控制台 IM 服务管理页面为当前使用的 App Key 开启服务。IM 旗舰版或IM 尊享版可开通该服务。具体功能与费用 以融云官方价格说明页面及计费说明文档为准。
- 群定向消息云存储服务。您可在融云控制台,通过应用配置>IM 服务>免费基础功能>单群聊,开通群定向消息云存储。
默认情况下,客户端发送与接收的群定向消息默认都不会存入历史消息服务,因此客户端调用获取历史消息的 API 时,从融云服务端返回的结果中不会包含当前用户发送、接收的群组定向消息。
发送群组定向普通消息
在群组中发送普通消息给指定的单个或多个用户。
方法
int sendGroupMessageToDesignatedUsers(
RCIMMessage message,
List<string> userIds
)
参数说明
参数 | 类型 | 说明 |
---|---|---|
message | RCIMMessage | 发送的消息对象 |
userIds | List<string> | 指定的群成员列表 |
代码示例
int code = engine.sendGroupMessageToDesignatedUsers(
message,
userIds
);
回调方法
-
onGroupMessageToDesignatedUsersAttached
消息存入数据库的监听
delegate void OnGroupMessageToDesignatedUsersAttachedDelegate(
RCIMMessage message);
OnGroupMessageToDesignatedUsersAttachedDelegate onGroupMessageToDesignatedUsersAttached;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
message | RCIMMessage | 已存入数据库的 message 对象 |
代码示例
engine.onGroupMessageToDesignatedUsersAttached = delegate(RCIMMessage message) {
};
-
onGroupMessageToDesignatedUsersSent
消息发送收到结果的回调
delegate void OnGroupMessageToDesignatedUsersSentDelegate(int code,
RCIMMessage message);
OnGroupMessageToDesignatedUsersSentDelegate onGroupMessageToDesignatedUsersSent;
参数说明
参数名 | 参数类型 | 描述 |
---|---|---|
code | int | 接口回调的状态码,0 代表成功,非 0 代表出现异常 |
message | RCIMMessage | 已存入数据库的 message 对象 |
代码示例
engine.onGroupMessageToDesignatedUsersSent = delegate(code,
RCIMMessage message
)
{
};