MsgSendMessageReadReceipts

功能介绍

发送消息已读回执

消息已读回执指的是，发送端往会话中发送消息，如果他想知道哪些人读过/还没读过这条消息，那么他就需要开启消息已读回执功能。

开启后，发送端发送消息时可以设置消息是否需要已读回执。如果设置为“需要”，接收端查看消息后才会发送自己已读给发送端。

单聊和群聊均支持消息已读回执功能，操作步骤一致。

如果是群消息已读回执，需要先在 即时通信 IM 控制台 >功能配置>登录与消息>群已读消息回执配置 中设置支持已读回执消息的群类型。

该接口调用成功后，会话未读数不会变化，消息发送者会收到 MsgReadedReceiptCallback 回调，回调里面会携带消息的最新已读信息。

接收端收到消息后，可以通过消息对象 Message 的 message_need_read_receipt(c#) 字段判断消息是否需要已读回执，如果需要已读回执，当用户查看消息后，调用 MsgSendMessageReadReceipts(c#) 接口发送消息已读回执。

该功能需要购买旗舰版套餐包，购买 旗舰版套餐包 后可使用。

该接口只支持 c2c 与 Group 消息。 当使用对象为 Group 消息时，msg_array 里的消息Id必须在同一个 Group 会话中。

参数详解

重载1

参数名称 参数类型 是否必填 描述
msg_array List< Message > 是 消息列表
callback NullValueCallback 是 异步回调

重载2

参数名称 参数类型 是否必填 描述
msg_array List< Message > 是 消息列表
callback ValueCallback< string > 是 异步回调 返回值的json_param的格式为string

返回模板

TIMResult

调用成功后回调函数参数：
code:int
desc:string
json_param:'' // json_params为空字符串""
user_data:string

返回值详解

名称 数值类型 描述
TIMResult TIMResult 调用接口的返回值
code int 值为ERR_SUCC表示成功，其他值表示失败。详情请参考 错误码
desc string 错误描述字符串
json_param string Json字符串，不同的接口，Json字符串不一样
user_data string ImSDK负责透传的用户自定义数据，未做任何处理

代码示例

using UnityEngine;
using UnityEngine.UI;
using com.tencent.im.unity.demo.types;
using com.tencent.imsdk.unity;
using com.tencent.imsdk.unity.types;
using com.tencent.imsdk.unity.enums;
using System;
using com.tencent.im.unity.demo.utils;
using EasyUI.Toast;
using System.Collections;
using System.Text;
using System.Collections.Generic;
public class MsgSendMessageReadReceipts : MonoBehaviour
{
  string[] Labels = new string[] { "SelectGroupLabel" };
  public Text Header;
  public Dropdown SelectedGroup;
  public Text Result;
  public Button Submit;
  public Button Copy;
  private List<string> GroupList;
  void Start()
  {
    foreach (string label in Labels)
    {
      GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
    }
    GroupGetJoinedGroupListSDK();
    Header = GameObject.Find("HeaderText").GetComponent<Text>();
    SelectedGroup = GameObject.Find("Group").GetComponent<Dropdown>();
    Result = GameObject.Find("ResultText").GetComponent<Text>();
    Submit = GameObject.Find("Submit").GetComponent<Button>();
    Copy = GameObject.Find("Copy").GetComponent<Button>();
    Submit.onClick.AddListener(MsgGetMsgListSDK);
    Copy.GetComponentInChildren<Text>().text = Utils.t("Copy");
    Copy.onClick.AddListener(CopyText);
    if (CurrentSceneInfo.info != null)
    {
      Header.text = Utils.IsCn() ? CurrentSceneInfo.info.apiText + " " + CurrentSceneInfo.info.apiName : CurrentSceneInfo.info.apiName;
      Submit.GetComponentInChildren<Text>().text = CurrentSceneInfo.info.apiName;
    }
  }

  void GetGroupList(params object[] parameters)
  {
    try
    {
      GroupList = new List<string>();
      SelectedGroup.ClearOptions();
      string text = (string)parameters[1];
      List<GroupBaseInfo> List = Utils.FromJson<List<GroupBaseInfo>>(text);
      foreach (GroupBaseInfo item in List)
      {
        print(item.group_base_info_group_id);
        GroupList.Add(item.group_base_info_group_id);
        var option = new Dropdown.OptionData();
        option.text = item.group_base_info_group_id;
        SelectedGroup.options.Add(option);
      }
      if (List.Count > 0)
      {
        SelectedGroup.captionText.text = List[SelectedGroup.value].group_base_info_group_id;
      }
      else
      {
        SelectedGroup.captionText.text = "";
      }
    }
    catch (Exception ex)
    {
      Toast.Show(Utils.t("getGroupListFailed"));
    }
  }

  void HandleMsgListRes(params object[] parameters)
  {
    try
    {
      string text = (string)parameters[1];
      List<Message> msg_list = Utils.FromJson<List<Message>>(text);
      print($"msg_list: {parameters[1]}");
      MsgSendMessageReadReceiptsSDK(msg_list);
    }
    catch (Exception ex)
    {
      Toast.Show(Utils.t("getMsgListFailed"));
    }
  }

  void MsgGetMsgListSDK()
  {
    var get_message_list_param = new MsgGetMsgListParam
    {
      msg_getmsglist_param_count = 20
    };
    print(GroupList[SelectedGroup.value]);
    TIMResult res = TencentIMSDK.MsgGetMsgList(GroupList[SelectedGroup.value], TIMConvType.kTIMConv_Group, get_message_list_param, Utils.addAsyncStringDataToScreen(HandleMsgListRes));
  }

  void GroupGetJoinedGroupListSDK()
  {
    TIMResult res = TencentIMSDK.GroupGetJoinedGroupList(Utils.addAsyncStringDataToScreen(GetGroupList));
    print($"GroupGetJoinedGroupListSDK {res}");
  }

  void MsgSendMessageReadReceiptsSDK(List<Message> msg_list)
  {
    print(GroupList[SelectedGroup.value]);
    if (msg_list.Count < 1)
    {
      Toast.Show("No Message Found");
      return;
    }
    TIMResult res = TencentIMSDK.MsgSendMessageReadReceipts(msg_list, Utils.addAsyncNullDataToScreen(GetResult));
    Result.text = Utils.SynchronizeResult(res);
  }

  void GetResult(params object[] parameters)
  {
    Result.text += (string)parameters[0];
  }

  void CopyText()
  {
    Utils.Copy(Result.text);
  }
  void OnApplicationQuit()
  {
    TencentIMSDK.Uninit();
  }
}

results matching ""

    No results matching ""