tencent cloud

文档反馈

Android&iOS&Windows&Mac

最后更新时间:2022-11-25 16:41:23

    功能描述

    群定向消息是指向群内部分成员发送消息,其他群成员无法收到该消息。

    说明:

    1. 仅增强版 SDK 6.0.1975 及以上版本支持。
    2. 该功能仅对旗舰版客户开放,详情请参考 基础服务详情
    3. 创建定向群消息的原始消息对象不支持群 @ 消息。
    4. 社群(Community)和直播群(AVChatRoom)不支持发送定向群消息。
    5. 定向群消息默认不计入群会话的未读计数。

    发送群定向消息

    定向消息是指,向群内部分指定的成员发送消息,而未被指定的群成员无法收到该消息。

    • 如果您希望向群里的单个群成员发定向消息,同时传入 groupID 和 receiver 即可。
    • 如果您希望向群里的多个群成员发定向消息,可以按照下面的方式实现:
      1. 调用 createXxxMessage (其中 Xxx 表示具体的消息类型) 接口创建一条原始消息对象 V2TIMMessage
      2. 调用 createTargetedGroupMessage (Android / iOS & Mac / Windows) 接口根据原始消息对象创建定向消息对象 V2TIMMessage,并指定消息接收成员列表。
      3. 调用 sendMessage 接口发送定向消息。

    示例代码如下:

    // 创建原始消息对象
    V2TIMMessage v2TIMMessage = V2TIMManager.getMessageManager().createTextMessage("这是一个群定向消息");
    // 创建定向群消息对象,指定群消息接收者 "vinson" "denny"
    List<String> targetGroupMemberList = new ArrayList<>();
    targetGroupMemberList.add("vinson");
    targetGroupMemberList.add("denny");
    V2TIMMessage targetGroupMessage = V2TIMManager.getMessageManager().createTargetedGroupMessage(v2TIMMessage, targetGroupMemberList);
    // 在群 "groupA" 发送群定向消息
    V2TIMManager.getMessageManager().sendMessage(targetGroupMessage, null, "groupA",  V2TIMMessage.V2TIM_PRIORITY_DEFAULT, false, null, new V2TIMSendCallback<V2TIMMessage>() {
     @Override
     public void onError(int code, String desc) {
         // 发送失败
     }
     @Override
     public void onSuccess(V2TIMMessage v2TIMMessage) {
         // 发送成功
     }
     @Override
     public void onProgress(int progress) {
      }
    });
    

    接收群定向消息

    定向群消息默认不计入群会话的未读计数。
    接收群定向消息跟接收普通消息是一样的操作步骤,参考 接收消息

    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持