腾讯云即时通信IMUnity_AI解决方案_同尘科技
功能描述
在某些场景下,您可能需要对会话进行分组,例如分为 “产品体验”、”需求研发” 等,您可以调用以下接口实现。说明该功能仅对旗舰版客户开放,购买 旗舰版套餐包 后可使用。该功能仅增强版 Native SDK 6.5 及以上版本支持。
会话分组
新建会话分组
您可以调用 ConvCreateConversationGroup
(点击查看详情) 接口新建会话分组。说明 会话分组最大支持 20 个,超过后创建新的分组会报 51010
错误,不再使用的分组请及时删除。
属性 | 含义 | 说明 |
groupName | 会话分组名 | 长度要大于 0,最大支持 32 bytes,超过后会报 51011 错误 |
conversationIDList | 会话 ID 列表 | 不能为空 |
示例代码如下:
//创建会话分组 TIMResult res = TencentIMSDK.ConvCreateConversationGroup("groupName", new List { conv_id }, (int code, string desc, List results, string user_data)=>{ // 创建会话分组异步结果 });
删除会话分组
您可以调用 ConvDeleteConversationGroup
(点击查看详情) 接口删除会话分组。说明 如果会话分组不存在,删除对应分组会报 51009
错误。示例代码如下:
//删除会话分组 TIMResult res = TencentIMSDK.ConvDeleteConversationGroup("groupName", (int code, string desc, string result, string user_data)=>{ // 删除会话分组异步结果 });
重命名会话分组
您可以调用 ConvRenameConversationGroup
(点击查看详情) 接口重命名会话分组。示例代码如下:
//重命名会话分组 TIMResult res = TencentIMSDK.ConvRenameConversationGroup("oldGroupName", "newGroupName", (int code, string desc, string result, string user_data)=>{ // 重命名会话分组异步结果 });
获取会话分组列表
您可以调用 ConvGetConversationGroupList
(点击查看详情) 接口获取会话分组列表。示例代码如下:
//获取会话分组列表 TIMResult res = TencentIMSDK.ConvGetConversationGroupList((int code, string desc, List results, string user_data)=>{ // 获取会话分组列表异步结果 });
如果需要获取分组下面的会话列表,可以调用 ConvGetConversationListByFilter
(点击查看详情) 接口获取。示例代码如下:
//获取会话列表 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 } });
添加会话到一个分组
当分组创建成功后,您可以调用 ConvAddConversationsToGroup
(点击查看详情) 接口添加一个新会话到分组。示例代码如下:
//添加会话到一个会话分组 TIMResult res = TencentIMSDK.ConvAddConversationsToGroup("groupName", new List { conv_id }, (int code, string desc, List results, string user_data)=>{ // 添加会话到一个会话分组异步结果 });
从分组中删除某会话
您可以调用 ConvDeleteConversationsFromGroup
(点击查看详情) 从分组中删除某会话。示例代码如下:
//从一个会话分组中删除会话 TIMResult res = TencentIMSDK.ConvDeleteConversationsFromGroup("groupName", new List { conv_id }, (int code, string desc, List results, string user_data)=>{ // 从一个会话分组中删除会话异步结果 });
监听会话分组变更通知
您可以调用 SetConvEventCallback
(点击查看详情) 接口监听会话分组变更通知。示例代码如下:
//设置会话监听器 TencentIMSDK.SetConvEventCallback((TIMConvEvent conv_event, List conv_list, string user_data)=>{ // 处理回调逻辑 });
交流与反馈
点此进入IM社群,享有专业工程师的支持,解决您的难题
对即时通讯IM解决方案有疑惑?想了解解决方案收费? 联系解决方案专家
腾讯云限时活动1折起,即将结束: 马上收藏
同尘科技为腾讯云授权服务中心,购买腾讯云享受折上折,更有现金返利:同意关联,立享优惠
阿里云解决方案也看看?: 点击对比阿里云的解决方案
暂无评论,你要说点什么吗?