会话相关接口

TIM_DECL int TIMConvCreate(const char* conv_id, enum TIMConvType conv_type, TIMCommCallback cb, const void* user_data);

const void* user_data = nullptr; // 回调函数回传
const char* userid = "Windows-02";
int ret = TIMConvCreate(userid, kTIMConv_C2C, [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
    if (ERR_SUCC != code) {
        return;
    }
    // 回调返回会话的具体信息
}, user_data);
if (ret != TIM_SUCC) {
    // 调用 TIMConvCreate 接口失败
}

const void* user_data = nullptr; // 回调函数回传
const char* userid = "Windows-Group-01";
int ret = TIMConvCreate(userid, kTIMConv_Group, [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
    if (ERR_SUCC != code) {
        return;
    }
    // 回调返回会话的具体信息
}, user_data);
if (ret != TIM_SUCC) {
    // 调用 TIMConvCreate 接口失败
}

TIM_DECL int TIMConvDelete(const char* conv_id, enum TIMConvType conv_type, TIMCommCallback cb, const void* user_data);

TIM_DECL int TIMConvGetConvList(TIMCommCallback cb, const void* user_data);

TIM_DECL int TIMConvGetConversationListByFilter(const char* filter, uint64_t next_seq, uint32_t count, TIMCommCallback cb, const void* user_data);

json::Object filter;
filter[kTIMConversationListFilterConvType] = kTIMConv_Group;
filter[kTIMConversationListFilterMarkType] = kTIMConversationMarkTypeStar;
filter[kTIMConversationListFilterConversationGroup] = "my_group_name";

TIMConvGetConversationListByFilter(json::Serialize(filter).c_str(), 0, 20, [](int32_t code, const char* desc, const char* json_param, const void* 
user_data) {
    printf("TIMConvGetConversationListByFilter code:%d|desc:%s|json_param %s\\n", code, desc, json_param);

    // 读取 json_param 存放的结果
    json::Value json = json::Deserialize(json_param);
    // 可以通过 json[TIMConversationListResultConvList] 来读取到 array ConvInfo 会话列表
    uint64_t next_seq = json[TIMConversationListResultNextSeq].ToUInt64();
    bool is_finished = json[TIMConversationListResultIsFinished].ToBool();
    if (!is_finished) {
        // 继续调用 TIMConvGetConversationListByFilter 获取下一页，filter 参数的字段填写如下所示
        // json::Object filter;
        // filter[kTIMConversationListFilterConvType] = kTIMConv_Group;
        // filter[kTIMConversationListFilterMarkType] = kTIMConversationMarkTypeStar;
        // filter[kTIMConversationListFilterConversationGroup] = "my_group_name";
    }
}, nullptr);

TIM_DECL int TIMConvGetConvInfo(const char* json_get_conv_list_param, TIMCommCallback cb, const void* user_data);

Json::Object json_obj;
json_obj[kTIMGetConversationListParamConvId] = "98826";
json_obj[kTIMGetConversationListParamConvType] = kTIMConv_C2C;

Json::Array json_arry;
json_arry.append(json_obj);

TIMConvGetConvInfo(json_arry.toStyledString().c_str(),
   [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
   printf("TIMConvGetConvInfo|code:%d|desc:%s\\n", code, desc);
}, nullptr);

// json_params 示例。 具体请参考 [ConvInfo](TIMCloudDef.h)
[{
  "conv_active_time": 5,
  "conv_id": "98826",
  "conv_is_has_draft": false,
  "conv_is_has_lastmsg": true,
  "conv_is_pinned": false,
  "conv_last_msg": {
      "message_client_time": 1620877708,
      "message_conv_id": "98826",
      "message_conv_type": 1,
      "message_custom_int": 0,
      "message_custom_str": "",
      "message_elem_array": [{
          "elem_type": 0,
          "text_elem_content": "11111"
  }],
      "message_is_from_self": false,
      "message_is_online_msg": false,
      "message_is_peer_read": false,
      "message_is_read": false,
      "message_msg_id": "144115233874815003-1620877708-1038050731",
      "message_platform": 0,
      "message_priority": 1,
      "message_rand": 1038050731,
      "message_sender": "98826",
      "message_sender_profile": {
          "user_profile_add_permission": 1,
          "user_profile_birthday": 0,
          "user_profile_custom_string_array": [],
          "user_profile_face_url": "test1-www.google.com",
          "user_profile_gender": 0,
          "user_profile_identifier": "98826",
          "user_profile_language": 0,
          "user_profile_level": 0,
          "user_profile_location": "",
          "user_profile_nick_name": "test change8888",
          "user_profile_role": 0,
          "user_profile_self_signature": ""
      },
      "message_seq": 15840,
      "message_server_time": 1620877708,
      "message_status": 2,
      "message_unique_id": 6961616747713488299
   },
   "conv_type": 1,
   "conv_unread_num": 1
}]

TIM_DECL int TIMConvSetDraft(const char* conv_id, enum TIMConvType conv_type, const char* json_draft_param);

Json::Value json_value_text;  // 构造消息
json_value_text[kTIMElemType] = kTIMElem_Text;
json_value_text[kTIMTextElemContent] = "this draft";
Json::Value json_value_msg;
json_value_msg[kTIMMsgElemArray].append(json_value_text);

Json::Value json_value_draft; // 构造草稿
json_value_draft[kTIMDraftEditTime] = time(NULL);
json_value_draft[kTIMDraftUserDefine] = "this is userdefine";
json_value_draft[kTIMDraftMsg] = json_value_msg;

if (TIM_SUCC != TIMConvSetDraft(userid.c_str(), TIMConvType::kTIMConv_C2C, json_value_draft.toStyledString().c_str())) {
    // TIMConvSetDraft 接口调用失败
} 

// json_value_draft.toStyledString().c_str() 得到 json_draft_param JSON 字符串如下
{
   "draft_edit_time" : 1551271429,
   "draft_msg" : {
      "message_elem_array" : [
         {
            "elem_type" : 0,
            "text_elem_content" : "this draft"
         }
      ]
   },
   "draft_user_define" : "this is userdefine"
}

TIM_DECL int TIMConvCancelDraft(const char* conv_id, enum TIMConvType conv_type);

TIM_DECL int TIMConvSetConversationCustomData(const char* conversation_id_array, const char* custom_data, TIMCommCallback cb, const void* user_data);

json::Array conversation_id_array;
conversation_id_array.push_back("c2c_conversation_id1");
conversation_id_array.push_back("group_conversation_id2");

std::string custom_data = "my_custom_data";

TIMConvSetConversationCustomData(json::Serialize(conversation_id_array).c_str(), custom_data.c_str(), [](int32_t code, const char* desc, const 
char* json_param, const void* user_data) {
    printf("TIMConvSetConversationCustomData code:%d|desc:%s|json_param %s\\n", code, desc, json_param);

    // 遍历读取 json_param 存放的操作结果，参见 TIMConversationOperationResult 的定义
}, nullptr);

TIM_DECL int TIMConvPinConversation(const char* conv_id, TIMConvType conv_type, bool is_pinned, TIMCommCallback cb, const void* user_data);

// json_param 返回值为空字符串， 直接判断 code 即可
TIMConvPinConversation(
     [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
     printf("TIMConvPinConversation|code:%d|desc:%s\\n", code, desc);
}, nullptr);

TIM_DECL int TIMConvMarkConversation(const char* conversation_id_array, uint64_t mark_type, bool enable_mark, TIMCommCallback cb, const void* user_data);

json::Array conversation_id_array;
conversation_id_array.push_back("c2c_conversation_id1");
conversation_id_array.push_back("group_conversation_id2");

uint64_t mark_type = (uint64_t)kTIMConversationMarkTypeUnread | (0x1LL << 32);
bool enable_mark = true;

TIMConvMarkConversation(json::Serialize(conversation_id_array).c_str(), mark_type, enable_mark, [](int32_t code, const char* desc, const char* 
son_param, const void* user_data) {
    printf("TIMConvMarkConversation code:%d|desc:%s|json_param %s\\n", code, desc, json_param);
    // 遍历读取 json_param 存放的操作结果，参见 TIMConversationOperationResult 的定义
}, nullptr);

TIM_DECL int TIMConvGetTotalUnreadMessageCount(TIMCommCallback cb, const void* user_data);

TIMConvGetTotalUnreadMessageCount(
    [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
    printf("TIMConvGetTotalUnreadMessageCount|code:%d|desc:%s\\n", code, desc);
}, nullptr);

// json_param 的示例。 json key 请参考 [GetTotalUnreadNumberResult](TIMCloudDef.h)
// {"conv_get_total_unread_message_count_result_unread_count":4}

TIM_DECL int TIMConvGetUnreadMessageCountByFilter(const char* filter, TIMCommCallback cb, const void* user_data);

json::Object filter;
filter[kTIMConversationListFilterConvType] = kTIMConv_Group;
filter[kTIMConversationListFilterConversationGroup] = "my_group_name";
filter[kTIMConversationListFilterMarkType] = kTIMConversationMarkTypeStar;

TIMConvGetUnreadMessageCountByFilter(json::Serialize(filter).c_str(), [](int32_t code, const char* desc, const char* json_param, const void* 
user_data) {
    // json key 请参考 [GetTotalUnreadNumberResult](TIMCloudDef.h)
    printf("TIMConvGetTotalUnreadMessageCount|code:%d|desc:%s|json_param:%s\\n", code, desc, json_param);
}, nullptr);

TIM_DECL int TIMConvSubscribeUnreadMessageCountByFilter(const char* filter);

json::Object filter;
filter[kTIMConversationListFilterConvType] = kTIMConv_Group;
filter[kTIMConversationListFilterConversationGroup] = "my_group_name";
filter[kTIMConversationListFilterMarkType] = kTIMConversationMarkTypeStar;

TIMConvSubscribeUnreadMessageCountByFilter(json::Serialize(filter).c_str());

TIM_DECL int TIMConvUnsubscribeUnreadMessageCountByFilter(const char* filter);

json::Object filter;
filter[kTIMConversationListFilterConvType] = kTIMConv_Group;
filter[kTIMConversationListFilterConversationGroup] = "my_group_name";
filter[kTIMConversationListFilterMarkType] = kTIMConversationMarkTypeStar;

TIMConvUnsubscribeUnreadMessageCountByFilter(json::Serialize(filter).c_str());

TIM_DECL int TIMConvCreateConversationGroup(const char* group_name, const char* conversation_id_array, TIMCommCallback cb, const void* user_data);

std::string group_name = "my_group_name";

json::Array conversation_id_array;
conversation_id_array.push_back("c2c_conversation_id1");
conversation_id_array.push_back("group_conversation_id2");

TIMConvCreateConversationGroup(group_name.c_str(), json::Serialize(conversation_id_array).c_str(), [](int32_t code, const char* desc, const char* json_param, const void* user_data) {
    printf("TIMConvCreateConversationGroup code:%d|desc:%s|json_param %s\\n", code, desc, json_param);

    // 遍历读取 json_param 存放的操作结果，参见 TIMConversationOperationResult 的定义
}, nullptr);