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