GroupGetGroupInfoList
功能介绍
获取群信息
此接口用于获取当前用户已加入的群组列表,返回群组的基础信息。具体返回的群组信息字段参考GroupBaseInfoGroupDetailInfo
您可以调用 GroupGetGroupInfoList 获取群资料。该接口支持一次传入多个 group_id_list,批量获取多个群的群资料。
参数详解
重载1
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
group_id_list | List< string > | 是 | 群ID列表 |
callback | ValueCallback< List< GetGroupInfoResult > > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
group_id_list | List< string > | 是 | 群ID列表 |
callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数:
code:int
desc:string
json_param:
'[
{
"get_groups_info_result_code" : 0,
"get_groups_info_result_desc" : "",
"get_groups_info_result_info" : {
"group_detial_info_add_option" : 2,
"group_detial_info_create_time" : 1551344977,
"group_detial_info_custom_info" : {},
"group_detial_info_face_url" : "group face url",
"group_detial_info_group_id" : "first group id",
"group_detial_info_group_name" : "first group name",
"group_detial_info_group_type" : "Public",
"group_detial_info_info_seq" : 7,
"group_detial_info_introduction" : "group introduction",
"group_detial_info_is_shutup_all" : false,
"group_detial_info_last_info_time" : 1551344977,
"group_detial_info_last_msg_time" : 0,
"group_detial_info_max_member_num" : 2000,
"group_detial_info_member_num" : 1,
"group_detial_info_next_msg_seq" : 0,
"group_detial_info_notification" : "group notification",
"group_detial_info_online_member_num" : 0,
"group_detial_info_owener_identifier" : "user1",
"group_detial_info_searchable" : 2,
"group_detial_info_visible" : 2
}
}
]' // Json Key请参考[GetGroupInfoResult]
user_data:string
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
TIMResult | TIMResult | 调用接口的返回值 |
code | int | 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码 |
desc | string | 错误描述字符串 |
json_param | string | Json字符串,不同的接口,Json字符串不一样 Json Key请参考GetGroupInfoResult |
user_data | string | ImSDK负责透传的用户自定义数据,未做任何处理 |
代码示例
using UnityEngine;
using UnityEngine.UI;
using com.tencent.im.unity.demo.types;
using UnityEngine.SceneManagement;
using com.tencent.imsdk.unity;
using com.tencent.imsdk.unity.types;
using com.tencent.imsdk.unity.enums;
using System;
using System.Linq;
using com.tencent.im.unity.demo.utils;
using System.Collections;
using System.Collections.Generic;
using EasyUI.Toast;
public class GroupGetGroupInfoList : MonoBehaviour
{
public HashSet<string> SelectedGroup = new HashSet<string>();
public Text Header;
public Text Result;
private string Data;
public List<string> ResultText;
public Button Submit;
public Button Copy;
void Start()
{
GameObject.Find("SelectGroupLabel").GetComponent<Text>().text = Utils.t("SelectGroupLabel");
GroupGetJoinedGroupListSDK();
Header = GameObject.Find("HeaderText").GetComponent<Text>();
Result = GameObject.Find("ResultText").GetComponent<Text>();
Submit = GameObject.Find("Submit").GetComponent<Button>();
Copy = GameObject.Find("Copy").GetComponent<Button>();
Submit.onClick.AddListener(GroupGetGroupInfoListSDK);
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 ToggleValueChanged(Toggle change)
{
string userID = change.GetComponentInChildren<Text>().text.Split(':')[1];
if (change.isOn)
{
SelectedGroup.Add(userID);
}
else
{
SelectedGroup.Remove(userID);
}
}
void GenerateToggle(List<GroupBaseInfo> group_infos)
{
var Parent = GameObject.Find("ToggleContent");
var Toggler = GameObject.Find("Toggler").GetComponent<Toggle>();
foreach (GroupBaseInfo info in group_infos)
{
var obj = Instantiate(Toggler, Parent.transform);
obj.GetComponentInChildren<Text>().text = "group_id:" + info.group_base_info_group_id;
obj.isOn = false;
obj.onValueChanged.AddListener(delegate
{
ToggleValueChanged(obj);
});
}
}
void SetGroupList(params object[] parameters)
{
try
{
string text = (string)parameters[1];
List<GroupBaseInfo> List = Utils.FromJson<List<GroupBaseInfo>>(text);
GenerateToggle(List);
}
catch (Exception ex)
{
print(ex);
Toast.Show(Utils.t("getGroupListFailed"));
}
}
public void GroupGetJoinedGroupListSDK()
{
var cb = Utils.addAsyncStringDataToScreen(SetGroupList);
TIMResult res = TencentIMSDK.GroupGetJoinedGroupList(cb);
}
public void GroupGetGroupInfoListSDK()
{
List<string> group_ids = new List<string>(SelectedGroup);
TIMResult res = TencentIMSDK.GroupGetGroupInfoList(group_ids, Utils.addAsyncStringDataToScreen(GetResult));
Result.text = Utils.SynchronizeResult(res);
}
void GenerateResultText()
{
var Parent = GameObject.Find("ResultPanel");
foreach (Transform child in Parent.transform)
{
GameObject.Destroy(child.gameObject);
}
foreach (string resultText in ResultText)
{
var obj = Instantiate(Result, Parent.transform);
obj.text = resultText;
}
}
void GetResult(params object[] parameters)
{
ResultText = new List<string>();
// ArgumentException: Mesh can not have more than 65000 vertices
// Deal with a single Text cannot render too many words issue
string CallbackData = (string)parameters[0];
string[] DataList = CallbackData.Split('\n');
int count = 0;
while (count < DataList.Length)
{
// Every 400 lines render a new Text
int end = count + 400;
if (end > DataList.Length)
{
end = DataList.Length;
}
string[] textList = DataList.Skip(count).Take(end - count).ToArray();
ResultText.Add(string.Join("\n", textList));
count = end;
}
Data = (string)parameters[0];
GenerateResultText();
}
void CopyText()
{
Utils.Copy(Data);
}
void OnApplicationQuit()
{
TencentIMSDK.Uninit();
}
}