一、功能描述
群定向消息是指向群内部分成员发送消息,其他群成员无法收到该消息。
注意:说明:
注意:1. 该功能仅对旗舰版或企业版客户开放,详情请参见 基础服务计费说明。
注意:2. 创建群 @ 消息不支持指定消息接收成员列表 receiverList。
注意:3. 直播群(AVChatRoom)不支持发送群定向消息。
注意:4. 群定向消息默认不计入群会话的未读计数。
二、效果展示
使用群定向消息功能,你可以实现如下所示的效果:
三、发送群定向消息
定向消息是指,向群内部分指定的成员发送消息,而未被指定的群成员不会通过 TencentCloudChat.EVENT.MESSAGE_RECEIVED 事件收到该消息。
如果你希望向群组内特定的群成员发消息,可以按照下面的方式实现:
·调用 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);});
四、接收群定向消息
群定向消息默认不计入群会话的未读计数。
接收群定向消息跟接收普通消息是一样的操作步骤,详情请参见 接收消息。