功能描述
群定向消息是指向群内部分成员发送消息,其他群成员无法收到该消息。
说明:
1. 该功能仅对旗舰版客户开放,详情请参见 基础服务详情。
2. 创建群 @ 消息不支持指定消息接收成员列表
receiverList
。3. 直播群(AVChatRoom)不支持发送群定向消息。
4. 群定向消息默认不计入群会话的未读计数。
效果展示
使用群定向消息功能,您可以实现如下图所示的效果:
发送群定向消息
如果您希望向群组内特定的群成员发消息,可以按照下面的方式实现:
调用
createXxxMessage
(其中 Xxx 表示具体的消息类型) 接口创建一条消息,并指定消息接收成员列表 receiverList
。调用
sendMessage
接口发送消息。示例
// 发送群定向消息// 注意:群定向消息不计入会话未读,receiverList 最大支持50个接收者。let message = chat.createTextMessage({to: 'test',conversationType: TencentCloudChat.TYPES.CONV_GROUP,payload: {text: 'Hello world!'},// 如果您需要发群定向消息,需购买旗舰版套餐,并且创建消息时通过 receiverList 指定消息接收者receiverList: ['user0', 'user1']});// 发送消息let promise = chat.sendMessage(message);promise.then(function(imResponse) {// 发送成功console.log(imResponse);}).catch(function(imError) {// 发送失败console.warn('sendMessage error:', imError);});
接收群定向消息