GetMsgGroupMessageReadMemberList

功能介绍

获取群消息已读群成员列表

发送端在需要查看群消息已读或未读成员列表时,可以调用 GetMsgGroupMessageReadMemberList 接口分页拉取消息已读或未读群成员列表。

参数详解

参数名称 参数类型 是否必填 描述
message Message 单条群消息
filter TIMGroupMessageReadMembersFilter 指定拉取已读或未读群成员列表
next_seq ulong 分页拉取的游标,第一次默认取传 0,后续分页拉取时,传上一次分页拉取成功回调里的 next_seq
count int 分页拉取的个数,最大支持 100 个。
callback MsgGroupMessageReadMemberListCallback 回调 MsgGroupMessageReadMemberListCallback
stringCallback MsgGroupMessageReadMemberListStringCallback string 类型回调 MsgGroupMessageReadMemberListStringCallback

返回模板

TIMResult

调用成功后回调函数参数:
code:int
desc:string
json_param:List<GroupMemberInfo>
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.Collections.Generic;
public class GetMsgGroupMessageReadMemberList : MonoBehaviour
{
  public Text Header;
  public Dropdown SelectedConv;
  public Dropdown SelectedMsg;
  public Dropdown SelectedMemberFilter;
  public Text LastSeq;
  public Text Result;
  public Button Submit;
  public Button Copy;
  private List<ConvInfo> ConvList;
  private List<Message> MsgList;
  string[] Labels = new string[] { "SelectConvLabel", "SelectMsgLabel", "SelectMemberFilterLabel" };
  void Start()
  {
    foreach (string label in Labels)
    {
      GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
    }
    Header = GameObject.Find("HeaderText").GetComponent<Text>();
    SelectedConv = GameObject.Find("Dropdown").GetComponent<Dropdown>();
    SelectedMsg = GameObject.Find("MsgDropdown").GetComponent<Dropdown>();
    SelectedMemberFilter = GameObject.Find("MemberFilterDropdown").GetComponent<Dropdown>();
    foreach (string name in Enum.GetNames(typeof(TIMGroupMessageReadMembersFilter)))
    {
      Dropdown.OptionData option = new Dropdown.OptionData();
      option.text = name;
      SelectedMemberFilter.options.Add(option);
    }
    LastSeq = GameObject.Find("LastSeq").GetComponent<Text>();
    LastSeq.text = "0";
    Result = GameObject.Find("ResultText").GetComponent<Text>();
    Submit = GameObject.Find("Submit").GetComponent<Button>();
    Copy = GameObject.Find("Copy").GetComponent<Button>();
    Copy.GetComponentInChildren<Text>().text = Utils.t("Copy");
    Submit.onClick.AddListener(GetMsgGroupMessageReadMemberListSDK);
    Copy.onClick.AddListener(CopyText);
    SelectedConv.interactable = true;
    SelectedConv.onValueChanged.AddListener(delegate
    {
      GroupDropdownValueChanged(SelectedConv);
    });
    if (CurrentSceneInfo.info != null)
    {
      Header.text = Utils.IsCn() ? CurrentSceneInfo.info.apiText + " " + CurrentSceneInfo.info.apiName : CurrentSceneInfo.info.apiName;
      Submit.GetComponentInChildren<Text>().text = CurrentSceneInfo.info.apiName;
    }
    ConvGetConvListSDK();
  }

  void GroupDropdownValueChanged(Dropdown change)
  {
    SelectedMsg.captionText.text = "";
    SelectedMsg.ClearOptions();
    SelectedMsg.value = 0;
    MsgList = new List<Message>();
    if (ConvList.Count > 0)
    {
      string conv_id = ConvList[change.value].conv_id;
      TIMConvType conv_type = ConvList[change.value].conv_type;
      MsgGetMsgListSDK(conv_id, conv_type);
    }
  }

  void GetConvList(params object[] parameters)
  {
    try
    {
      ConvList = new List<ConvInfo>();
      SelectedConv.ClearOptions();
      string text = (string)parameters[1];
      List<ConvInfo> List = Utils.FromJson<List<ConvInfo>>(text);
      foreach (ConvInfo item in List)
      {
        if (item.conv_type == TIMConvType.kTIMConv_Group)
        {
          print(item.conv_id);
          ConvList.Add(item);
          Dropdown.OptionData option = new Dropdown.OptionData();
          option.text = item.conv_id;
          SelectedConv.options.Add(option);
        }
      }
      if (ConvList.Count > 0)
      {
        SelectedConv.captionText.text = ConvList[SelectedConv.value].conv_id;
        GroupDropdownValueChanged(SelectedConv);
      }
    }
    catch (Exception ex)
    {
      Toast.Show(Utils.t("getConvListFailed"));
    }
  }

  void GetMsgList(params object[] parameters)
  {
    try
    {
      string text = (string)parameters[1];
      List<Message> ListRes = Utils.FromJson<List<Message>>(text);
      foreach (Message item in ListRes)
      {
        if ((item.message_is_from_self == true) && (item.message_need_read_receipt == true))
        {
          print(item.message_msg_id);
          MsgList.Add(item);
          Dropdown.OptionData optionMsg = new Dropdown.OptionData();
          optionMsg.text = item.message_msg_id;
          SelectedMsg.options.Add(optionMsg);
        }
      }
      if (MsgList.Count > 0)
      {
        SelectedMsg.captionText.text = MsgList[SelectedMsg.value].message_msg_id;
      }
    }
    catch (Exception ex)
    {
      Toast.Show(Utils.t("getMsgListFailed"));
    }
  }

  void ConvGetConvListSDK()
  {
    TIMResult res = TencentIMSDK.ConvGetConvList(Utils.addAsyncStringDataToScreen(GetConvList));
    print($"ConvGetConvListSDK {res}");
  }

  void MsgGetMsgListSDK(string conv_id, TIMConvType conv_type)
  {
    var get_message_list_param = new MsgGetMsgListParam
    {
      msg_getmsglist_param_count = 20
    };
    print(conv_id + conv_type);
    TIMResult res = TencentIMSDK.MsgGetMsgList(conv_id, conv_type, get_message_list_param, Utils.addAsyncStringDataToScreen(GetMsgList));
  }

  void GetMsgGroupMessageReadMemberListSDK()
  {
    if (SelectedMsg.value > -1 && SelectedMsg.value < MsgList.Count)
    {
      print("Selected Message: " + MsgList[SelectedMsg.value].message_msg_id);
      TIMResult res = TencentIMSDK.GetMsgGroupMessageReadMemberList(MsgList[SelectedMsg.value], (TIMGroupMessageReadMembersFilter)SelectedMemberFilter.value, Convert.ToUInt64(LastSeq.text), 20, null, Utils.SetMsgGroupMessageReadMemberListCallback(GetResult));
      Result.text = Utils.SynchronizeResult(res);
    }
  }

  void GetResult(params object[] parameters)
  {
    Result.text += (string)parameters[0];
    bool is_finished = Convert.ToBoolean(parameters[3]);
    print($"next_seq: {parameters[2]}, is_finished: {parameters[3]}");
    if (is_finished)
    {
      LastSeq.text = "0";
      LastSeq.text = (string)parameters[2];
    }
    else
    {
      LastSeq.text = (string)parameters[2];
    }
  }

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

results matching ""

    No results matching ""