FriendshipGetFriendProfileList
功能介绍
获取好友列表信息
此接口通过回调返回所有好友资料FriendProfile.
增强版 SDK 中用户资料的更新分好友和陌生人两种情况：
好友资料：由于好友资料更新时，后台会主动向 SDK 发送系统通知，因此好友资料可以实时更新。
陌生人资料：陌生人资料更新时，由于没有好友关系，后台无法向 SDK 发送系统通知，因此无法实时更新；为了避免每次获取用户资料都向后台发起网络请求，SDK 增加了缓存逻辑，对同一个用户主动向后台拉取资料的时间间隔为 10 分钟。
参数详解
重载1
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| callback | ValueCallback< List< FriendProfile > > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数：
code:int
desc:string
json_param:
'[
{
"friend_profile_add_source" : "AddSource_Type_android",
"friend_profile_add_time" : 1562229520,
"friend_profile_add_wording" : "",
"friend_profile_group_name_array" : [],
"friend_profile_identifier" : "asd12341",
"friend_profile_item_custom_string_array" : [
{
"friend_profile_custom_string_info_key" : "Tag_Profile_Custom_Str",
"friend_profile_custom_string_info_value" : "qcloud"
}
],
"friend_profile_remark" : "",
"friend_profile_user_profile" : {
"user_profile_add_permission" : 0,
"user_profile_birthday" : 20190419,
"user_profile_face_url" : "faceUrl",
"user_profile_gender" : 0,
"user_profile_identifier" : "asd12341",
"user_profile_item_custom_string_array" : [
{
"user_profile_custom_string_info_key" : "Tag_Profile_Custom_Str",
"user_profile_custom_string_info_value" : "qcloud"
}
],
"user_profile_language" : 1,
"user_profile_level" : 3,
"user_profile_location" : "sz\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000\u0000",
"user_profile_nick_name" : "nick_test23",
"user_profile_role" : 4,
"user_profile_self_signature" : "sig_test"
}
},
{
"friend_profile_add_source" : "AddSource_Type_Android",
"friend_profile_add_time" : 1555659941,
"friend_profile_add_wording" : "",
"friend_profile_group_name_array" : [],
"friend_profile_identifier" : "lttest1",
"friend_profile_remark" : "",
"friend_profile_user_profile" : {
"user_profile_add_permission" : 0,
"user_profile_birthday" : 0,
"user_profile_face_url" : "",
"user_profile_gender" : 0,
"user_profile_identifier" : "lttest1",
"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请参考[FriendProfile]
user_data:string
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| TIMResult | TIMResult | 调用接口的返回值 |
| code | int | 值为ERR_SUCC表示成功，其他值表示失败。详情请参考 错误码 |
| desc | string | 错误描述字符串 |
| json_param | string | Json字符串，不同的接口，Json字符串不一样 Json Key请参考FriendProfile |
| 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.Linq;
using com.tencent.im.unity.demo.utils;
using System.Collections.Generic;
public class FriendshipGetFriendProfileList : MonoBehaviour
{
public Text Header;
public Text Result;
public Button Submit;
public Button Copy;
public List<string> ResultText;
private string Data;
void Start()
{
Result = GameObject.Find("ResultText").GetComponent<Text>();
Header = GameObject.Find("HeaderText").GetComponent<Text>();
Submit = GameObject.Find("Submit").GetComponent<Button>();
if (CurrentSceneInfo.info != null)
{
Header.text = Utils.IsCn() ? CurrentSceneInfo.info.apiText + " " + CurrentSceneInfo.info.apiName : CurrentSceneInfo.info.apiName;
Submit.GetComponentInChildren<Text>().text = CurrentSceneInfo.info.apiName;
}
Copy = GameObject.Find("Copy").GetComponent<Button>();
Copy.GetComponentInChildren<Text>().text = Utils.t("Copy");
Submit.onClick.AddListener(FriendshipGetFriendProfileListSDK);
Copy.onClick.AddListener(CopyText);
}
void FriendshipGetFriendProfileListSDK()
{
TIMResult res = TencentIMSDK.FriendshipGetFriendProfileList(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();
}
}