功能描述
在某些场景下,您可能需要对会话进行分组,例如分为 "产品体验"、"需求研发" 等,您可以调用以下接口实现。
会话分组
新建会话分组
说明
会话分组最大支持 20 个,超过后创建新的分组会报
51010
错误,不再使用的分组请及时删除。属性 | 含义 | 说明 |
groupName | 会话分组名 | 长度要大于 0,最大支持 32 bytes,超过后会报 51011 错误 |
conversationIDList | 会话 ID 列表 | 不能为空 |
示例代码如下:
//创建会话分组TIMResult res = TencentIMSDK.ConvCreateConversationGroup("groupName", new List<string> {conv_id}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{// 创建会话分组异步结果});
删除会话分组
说明
如果会话分组不存在,删除对应分组会报
51009
错误。示例代码如下:
//删除会话分组TIMResult res = TencentIMSDK.ConvDeleteConversationGroup("groupName", (int code, string desc, string result, string user_data)=>{// 删除会话分组异步结果});
重命名会话分组
示例代码如下:
//重命名会话分组TIMResult res = TencentIMSDK.ConvRenameConversationGroup("oldGroupName", "newGroupName", (int code, string desc, string result, string user_data)=>{// 重命名会话分组异步结果});
获取会话分组列表
示例代码如下:
//获取会话分组列表TIMResult res = TencentIMSDK.ConvGetConversationGroupList((int code, string desc, List<string> results, string user_data)=>{// 获取会话分组列表异步结果});
示例代码如下:
//获取会话列表ConversationListFilter filter = new ConversationListFilter{conversation_list_filter_conv_type: TIMConvType.kTIMConv_C2C,//会话类型conversation_list_filter_mark_type: TIMConversationMarkType.kTIMConversationMarkTypeStar,//会话标记类型conversation_list_filter_conversation_group: "groupName"//拉取的群组名};ulong next_seq = 0; // 拉取游标uint count = 10; // 拉取数量//获取会话列表的高级接口TIMResult res = TencentIMSDK.ConvGetConversationListByFilter(filter, next_seq, count, (int code, string desc, ConversationListResult result, string user_data)=>{// 获取会话列表异步结果if (code == 0) {//拉取成功bool isFinished = result.conversation_list_result_is_finished; //是否拉取完next_seq = result.conversation_list_result_next_seq; //后续分页拉取的游标var conversationList = result.conversation_list_result_conv_list; //此次拉取到的消息列表//如果没有拉取完,使用返回的nextSeq继续拉取直到isFinished为true}});
添加会话到一个分组
示例代码如下:
//添加会话到一个会话分组TIMResult res = TencentIMSDK.ConvAddConversationsToGroup("groupName", new List<string> {conv_id}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{// 添加会话到一个会话分组异步结果});
从分组中删除某会话
示例代码如下:
//从一个会话分组中删除会话TIMResult res = TencentIMSDK.ConvDeleteConversationsFromGroup("groupName", new List<string> {conv_id}, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{// 从一个会话分组中删除会话异步结果});
监听会话分组变更通知
示例代码如下:
//设置会话监听器TencentIMSDK.SetConvEventCallback((TIMConvEvent conv_event, List<ConvInfo> conv_list, string user_data)=>{// 处理回调逻辑});