GetMsgGroupMessageReadMemberList
introduction
Get group message read member list
To view the list of members who have or have not read a group message, the sender can call the GetMsgGroupMessageReadMemberList to pull the member list by page.
Parameter details
Parameter name | Parameter type | Required | Description |
---|---|---|---|
message | Message | yes | Group message |
filter | TIMGroupMessageReadMembersFilter | yes | Group message read member's filter |
next_seq | ulong | yes | Next seq as page index, default: 0 and use the last next_seq returned from the callback as the next seq |
count | int | yes | Page size, maximum 100 |
callback | MsgGroupMessageReadMemberListCallback | yes | MsgGroupMessageReadMemberListCallback |
stringCallback | MsgGroupMessageReadMemberListStringCallback | yes | MsgGroupMessageReadMemberListStringCallback |
Returned template
TIMResult
The parameters of the callback function after successfully calling the API:
code:int
desc:string
json_param:List<GroupMemberInfo>
user_data:string
Return value details
name | type | description |
---|---|---|
TIMResult | TIMResult | Return value of calling API |
code | int | Result error code: Error Codes |
desc | string | The description of the error. |
json_param | string | Json string. Calling different API will get different Json strings. |
user_data | string | User-defined data transfered by ImSDK without any processing |
Code example
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();
}
}