tencent cloud

文档反馈

最后更新时间:2024-02-06 17:38:16

    功能描述

    在某些场景下,您可能需要对会话进行标记,例如 "会话标星"、"会话折叠"、"会话隐藏"、“会话标记未读”等,您可以调用以下接口实现。
    说明:
    该功能仅对旗舰版客户开放,购买 旗舰版 后可使用。
    该功能仅 Native SDK 6.5 及以上版本支持。

    会话标记

    标记会话

    您可以调用 ConvMarkConversation (点击查看详情) 接口标记或者取消标记会话。
    注意:
    当用户标记了会话,SDK 只是简单记录了会话的标记值,并不会改变会话的底层逻辑,例如标记会话为 kTIMConversationMarkTypeUnread,会话的底层的未读数并不会发生改变。
    标记会话接口入参详解如下:
    属性
    含义
    说明
    conversationIDList
    会话 ID 列表
    一次标记最大支持 100 个会话
    markType
    标记类型
    会话标星、会话标记未读、会话折叠、会话隐藏等
    enableMark
    标记/取消标记
    标记或取消标记
    说明:
    SDK 提供了四个默认标记("会话标星"、"会话折叠"、"会话隐藏"、“会话标记未读”),如果已有标记不能满足您的需求,您可以自定义扩展标记,扩展标记需要满足以下两个条件:
    扩展标记值不能和已有的标记值冲突。
    扩展标记值必须是 0x1LL << n 的位移值(32 <= n < 64,即 n 必须大于等于 32 并且小于 64),例如扩展标记值 0x1LL << 32 表示 "iPhone 在线"。
    示例代码如下:
    //标记会话
    TIMResult res = TencentIMSDK.ConvMarkConversation(new List<string> {
    conv_id
    }, TIMConversationMarkType.kTIMConversationMarkTypeStar, true, (int code, string desc, List<ConversationOperationResult> results, string user_data)=>{
    // 标记会话异步结果
    });

    监听会话标记变更通知

    会话被标记或者取消标记后,会话 ConvInfoconv_mark_array (点击查看详情) 字段会发生变更,您可以调用 SetConvEventCallback (点击查看详情) 接口监听会话变更通知。
    示例代码如下:
    //设置会话监听器
    TencentIMSDK.SetConvEventCallback((TIMConvEvent conv_event, List<ConvInfo> conv_list, 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
    }
    });
    
    联系我们

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

    技术支持

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

    7x24 电话支持