ProfileGetUserProfileList
功能介绍
获取用户信息列表
您可以调用 ProfileGetUserProfileList 接口查询非好友资料,其中参数 friendship_getprofilelist_param_identifier_array 填入非好友的 UserID 即可。
可以通过该接口获取任何人的个人资料,包括自己的个人资料。
不能修改非好友的资料。
参数详解
重载1
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
json_get_user_profile_list_param | FriendShipGetProfileListParam | 是 | 用户信息列表参数 |
callback | ValueCallback< List< UserProfile > > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
json_get_user_profile_list_param | FriendShipGetProfileListParam | 是 | 用户信息列表参数 |
callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数:
code:int
desc:string
json_param:
'[
{
"user_profile_add_permission" : 1,
"user_profile_birthday" : 0,
"user_profile_face_url" : "",
"user_profile_gender" : 0,
"user_profile_identifier" : "user1",
"user_profile_language" : 0,
"user_profile_level" : 0,
"user_profile_location" : "",
"user_profile_nick_name" : "User1NickName",
"user_profile_role" : 0,
"user_profile_self_signature" : ""
},
{
"user_profile_add_permission" : 0,
"user_profile_birthday" : 0,
"user_profile_face_url" : "",
"user_profile_gender" : 0,
"user_profile_identifier" : "user2",
"user_profile_language" : 0,
"user_profile_level" : 0,
"user_profile_location" : "",
"user_profile_nick_name" : "",
"user_profile_role" : 0,
"user_profile_self_signature" : ""
}
]' // Json Key请参考[UserProfile]
user_data:string
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
TIMResult | TIMResult | 调用接口的返回值 |
code | int | 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码 |
desc | string | 错误描述字符串 |
json_param | string | Json字符串,不同的接口,Json字符串不一样 Json Key请参考UserProfile |
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 com.tencent.im.unity.demo.utils;
using System.Collections;
using System.Collections.Generic;
using EasyUI.Toast;
public class ProfileGetUserProfileList : MonoBehaviour
{
public List<FriendProfile> UserList = new List<FriendProfile>();
public HashSet<string> SelectedUser = new HashSet<string>();
public Text Header;
public Text Result;
public Button Submit;
public Button Copy;
void Start()
{
GameObject.Find("SelectUserLabel").GetComponent<Text>().text = Utils.t("SelectUserLabel");
FriendshipGetFriendProfileList();
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(ProfileGetUserProfileListSDK);
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)
{
SelectedUser.Add(userID);
}
else
{
SelectedUser.Remove(userID);
}
}
void GenerateToggle()
{
var Parent = GameObject.Find("ToggleContent");
var Toggler = GameObject.Find("Toggler").GetComponent<Toggle>();
foreach (FriendProfile user in UserList)
{
var obj = Instantiate(Toggler, Parent.transform);
obj.GetComponentInChildren<Text>().text = "userID:" + user.friend_profile_identifier;
obj.isOn = false;
obj.onValueChanged.AddListener(delegate
{
ToggleValueChanged(obj);
});
}
}
void SetUserList(params object[] parameters)
{
try
{
string text = (string)parameters[1];
print(text);
List<FriendProfile> List = Utils.FromJson<List<FriendProfile>>(text);
UserList.AddRange(List);
GenerateToggle();
}
catch (Exception ex)
{
print(ex);
Toast.Show(Utils.t("getFriendListFailed"));
}
}
public void FriendshipGetFriendProfileList()
{
var Users = UserList;
var cb = Utils.addAsyncStringDataToScreen(SetUserList);
TIMResult res = TencentIMSDK.FriendshipGetFriendProfileList(cb);
}
public void ProfileGetUserProfileListSDK()
{
FriendShipGetProfileListParam json_get_user_profile_list_param = new FriendShipGetProfileListParam();
json_get_user_profile_list_param.friendship_getprofilelist_param_identifier_array = new List<string>(SelectedUser);
TIMResult res = TencentIMSDK.ProfileGetUserProfileList(json_get_user_profile_list_param, Utils.addAsyncStringDataToScreen(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();
}
}