FriendshipSearchFriends
功能介绍
搜索好友
接口返回本地存储的用户资料，可以根据 FriendInfoGetResult 中的 friendship_friend_info_get_result_relation_type 来判断是否为好友。
用户搜索只能搜索本地存储过的用户，比如拉取过的好友列表，拉取过的用户资料等。
您可以设置搜索关键字 friendship_search_param_keyword_list，并指定搜索的范围，即是否搜索用户的 userID、nickName、remark 字段。
参数详解
重载1
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| json_search_friends_param | FriendSearchParam | 是 | 搜索参数 |
| callback | ValueCallback< List< FriendInfoGetResult > > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| json_search_friends_param | FriendSearchParam | 是 | 搜索参数 |
| callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数：
code:int
desc:string
json_param:
'[
{
"friendship_friend_info_get_result_error_code": 0,
"friendship_friend_info_get_result_error_message": "OK",
"friendship_friend_info_get_result_field_info": {
"friend_profile_add_source": "",
"friend_profile_add_time": 0,
"friend_profile_add_wording": "",
"friend_profile_custom_string_array": [{
"friend_profile_custom_string_info_key": "Tag_Profile_Custom_Str",
"friend_profile_custom_string_info_value": "test3-lamar-value"
}],
"friend_profile_group_name_array": [],
"friend_profile_identifier": "98826",
"friend_profile_remark": "",
"friend_profile_user_profile": {
"user_profile_add_permission": 1,
"user_profile_birthday": 2000,
"user_profile_custom_string_array": [{
"user_profile_custom_string_info_key": "Tag_Profile_Custom_Str",
"user_profile_custom_string_info_value": "test3-lamar-value"
}],
"user_profile_face_url": "test1-www.google.com",
"user_profile_gender": 2,
"user_profile_identifier": "98826",
"user_profile_language": 1000,
"user_profile_level": 3000,
"user_profile_location": "shenzhen",
"user_profile_nick_name": "test change8888",
"user_profile_role": 4000,
"user_profile_self_signature": "1111111"
}
},
"friendship_friend_info_get_result_identifier": "98826",
"friendship_friend_info_get_result_relation_type": 0
}
]' // Json Key请参考[FriendInfoGetResult]
user_data:string
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| TIMResult | TIMResult | 调用接口的返回值 |
| code | int | 值为ERR_SUCC表示成功，其他值表示失败。详情请参考 错误码 |
| desc | string | 错误描述字符串 |
| json_param | string | Json字符串，不同的接口，Json字符串不一样 Json Key请参考[FriendInfoGetResult] |
| 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.Text;
using System.Collections.Generic;
public class FriendshipSearchFriends : MonoBehaviour
{
string[] Labels = new string[] { "KeywordLabel", "FriendSearchFieldLabel" };
public Text Header;
public InputField Input;
public Dropdown FriendSearchField;
public Text Result;
public Button Submit;
public Button Copy;
public int[] EnumFriendSearchField = (int[])Enum.GetValues(typeof(TIMFriendshipSearchFieldKey));
void Start()
{
foreach (string label in Labels)
{
GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
}
Header = GameObject.Find("HeaderText").GetComponent<Text>();
Input = GameObject.Find("InputField").GetComponent<InputField>();
FriendSearchField = GameObject.Find("FriendSearchField").GetComponent<Dropdown>();
foreach (string name in Enum.GetNames(typeof(TIMFriendshipSearchFieldKey)))
{
Dropdown.OptionData option = new Dropdown.OptionData();
option.text = name;
FriendSearchField.options.Add(option);
}
Result = GameObject.Find("ResultText").GetComponent<Text>();
Submit = GameObject.Find("Submit").GetComponent<Button>();
Copy = GameObject.Find("Copy").GetComponent<Button>();
Submit.onClick.AddListener(FriendshipSearchFriendsSDK);
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 FriendshipSearchFriendsSDK()
{
var param = new FriendSearchParam
{
friendship_search_param_keyword_list = new List<string>
{
Input.text
},
friendship_search_param_search_field_list = new List<TIMFriendshipSearchFieldKey>
{
(TIMFriendshipSearchFieldKey) EnumFriendSearchField[FriendSearchField.value]
}
};
TIMResult res = TencentIMSDK.FriendshipSearchFriends(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();
}
}