群组定向消息
功能简介
群定向消息,指在群内发送一条仅对部分成员可见或不可见的消息。
群成员是否可见定向消息的判断逻辑如下:
| 用户身份 | 消息是否对指定用户列表可见 | 用户是否在指定用户列表中 | 是否可见 |
|---|---|---|---|
| 发送者 | - | 发送者不可以列入指定用户列表中。 | ✔ |
| 非发送者 | ✔ | ✔ | ✔ |
| 非发送者 | ✔ | ✘ | ✘ |
| 非发送者 | ✘ | ✔ | ✘ |
| 非发送者 | ✘ | ✘ | ✔ |
注意
群定向消息不会计入未读数,且不支持回复、表态、回执和编辑等操作。
发送定向消息
调用服务端接口 发送群组消息 时,可通过传入 TargetOption 对象,配置接收用户列表(ReceiverUserIds),并通过设置 Inclusive 为 true 或 false 来指定消息是否对这些用户可见。
接收定向消息
成功登录 ZIM SDK 后,当本用户在某个群聊内接收到一条自己可见的群定向消息时,会触发 groupMessageReceived 回调。且收到的 ZIMMessage 中,isGroupTargetedMessage 的值为 true。
如需了解 groupMessageReceived 回调示例,请参考 收发消息 - 接收消息

