tencent cloud

文档反馈

Android & iOS & Mac

最后更新时间:2023-01-29 16:10:44

    功能描述

    在某些场景下,您可能需要对会话进行分组,例如分为 "产品体验"、"需求研发" 等,您可以调用以下接口实现。

    说明:

    • 该功能仅对旗舰版客户开放,购买 旗舰版 后可使用。
    • 该功能仅增强版 6.5.2803 及以上版本支持。

    会话分组

    新建会话分组

    您可以调用 createConversationGroup (Android / iOS & Mac / Windows) 接口新建会话分组。

    说明:

    会话分组最大支持 20 个,超过后创建新的分组会报 51010 错误,不再使用的分组请及时删除。

    属性 含义 说明
    groupName 会话分组名 长度要大于 0,最大支持 32 bytes,超过后会报 51011 错误
    conversationIDList 会话 ID 列表 不能为空

    示例代码如下:

    List<String> conversationIDList = new ArrayList<>();
    conversationIDList.add("c2c_user1");
    V2TIMManager.getConversationManager().createConversationGroup("conversation_group", conversationIDList, new V2TIMValueCallback<List<V2TIMConversationOperationResult>>() {
       @Override
       public void onSuccess(List<V2TIMConversationOperationResult> v2TIMConversationOperationResults) {
           // 创建会话分组成功
       }
        @Override
       public void onError(int code, String desc) {
           // 创建会话分组失败
       }
    });
    

    删除会话分组

    您可以调用 deleteConversationGroup (Android / iOS & Mac / Windows) 接口删除会话分组。

    说明:

    如果会话分组不存在,删除对应分组会报 51009 错误。

    示例代码如下:

    V2TIMManager.getConversationManager().deleteConversationGroup("conversation_group", new V2TIMCallback() {
       @Override
       public void onSuccess() {
           // 删除会话分组成功
       }
        @Override
       public void onError(int code, String desc) {
           // 删除会话分组失败
       }
    });
    

    重命名会话分组

    您可以调用 renameConversationGroup (Android / iOS & Mac / Windows) 接口重命名会话分组。

    示例代码如下:

    V2TIMManager.getConversationManager().renameConversationGroup("conversation_group", "conversation_group_rename", new V2TIMCallback() {
       @Override
       public void onSuccess() {
           // 重命名会话分组成功
       }
        @Override
       public void onError(int code, String desc) {
           // 重命名会话分组失败
       }
    });
    

    获取会话分组列表

    您可以调用 getConversationGroupList (Android / iOS & Mac / Windows) 接口获取会话分组列表。

    示例代码如下:

    V2TIMManager.getConversationManager().getConversationGroupList(new V2TIMValueCallback<List<String>>() {
       @Override
       public void onSuccess(List<String> strings) {
           // 获取分组列表成功
       }
        @Override
       public void onError(int code, String desc) {
           // 获取分组列表失败
       }
    });
    

    如果需要获取分组下面的会话列表,可以调用 getConversationListByFilter (Android / iOS & Mac / Windows) 接口获取。

    示例代码如下:

    V2TIMConversationListFilter filter = new V2TIMConversationListFilter();
    filter.setGroupName("conversation_group");
    filter.setCount(50);
    filter.setNextSeq(0);
    V2TIMManager.getConversationManager().getConversationListByFilter(filter, new V2TIMValueCallback<V2TIMConversationResult>() {
       @Override
       public void onSuccess(V2TIMConversationResult v2TIMConversationResult) {
           // 获取会话列表成功
       }
        @Override
       public void onError(int code, String desc) {
           // 获取会话列表失败
       }
    });
    

    添加会话到一个分组

    当分组创建成功后,您可以调用 addConversationsToGroup (Android / iOS & Mac / Windows) 接口添加一个新会话到分组。

    示例代码如下:

    List<String> conversationIDList = new ArrayList<>();
    conversationIDList.add("c2c_user2");
    V2TIMManager.getConversationManager().addConversationsToGroup("conversation_group", conversationIDList, new V2TIMValueCallback<List<V2TIMConversationOperationResult>>() {
       @Override
       public void onSuccess(List<V2TIMConversationOperationResult> v2TIMConversationOperationResults) {
           // 添加会话到分组成功
       }
        @Override
       public void onError(int code, String desc) {
           // 添加会话到分组失败
       }
    });
    

    从分组中删除某会话

    您可以调用 deleteConversationsFromGroup (Android / iOS & Mac / Windows) 从分组中删除某会话。

    示例代码如下:

    List<String> conversationIDList = new ArrayList<>();
    conversationIDList.add("c2c_user2");
    V2TIMManager.getConversationManager().deleteConversationsFromGroup("conversation_group", conversationIDList, new V2TIMValueCallback<List<V2TIMConversationOperationResult>>() {
       @Override
       public void onSuccess(List<V2TIMConversationOperationResult> v2TIMConversationOperationResults) {
           // 从分组删除会话成功
       }
        @Override
       public void onError(int code, String desc) {
           // 从分组删除会话失败
       }
    });
    

    监听会话分组变更通知

    您可以调用 addConversationListener (Android / iOS & Mac / Windows) 接口监听会话分组变更通知。

    示例代码如下:

    V2TIMConversationListener listener = new V2TIMConversationListener() {
       @Override
       public void onConversationGroupCreated(String groupName, List<V2TIMConversation> conversationList) {
           // 收到会话分组创建通知
       }
        @Override
       public void onConversationGroupDeleted(String groupName) {
           // 收到会话分组删除通知
       }
        @Override
       public void onConversationGroupNameChanged(String oldName, String newName) {
           // 收到会话分组重命名通知
       }
        @Override
       public void onConversationsAddedToGroup(String groupName, List<V2TIMConversation> conversationList) {
           // 收到会话分组添加会话通知
       }
        @Override
       public void onConversationsDeletedFromGroup(String groupName, List<V2TIMConversation> conversationList) {
           // 收到会话分组删除会话通知
       }
    };
    V2TIMManager.getConversationManager().addConversationListener(listener);
    

    联系我们

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

    技术支持

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

    7x24 电话支持