GroupInviteMember
功能介绍
邀请用户进群
权限说明:
只有私有群可以拉用户入群
公开群、聊天室邀请用户入群
需要用户同意;直播大群不能邀请用户入群。
此接口支持批量邀请成员加入群组,Json Key详情请参考GroupInviteMemberParam
参数详解
重载1
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
param | GroupInviteMemberParam | 是 | 邀请人员信息 |
callback | ValueCallback< List< GroupInviteMemberResult > > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
参数名称 | 参数类型 | 是否必填 | 描述 |
---|---|---|---|
param | GroupInviteMemberParam | 是 | 邀请人员信息 |
callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数:
code:int
desc:string
json_param:
'[
{
"group_invite_member_result_identifier" : "user2",
"group_invite_member_result_result" : 1
},
{
"group_invite_member_result_identifier" : "user3",
"group_invite_member_result_result" : 1
}
]' // Json Key请参考[GroupInviteMemberResult]
user_data:string
返回值详解
名称 | 数值类型 | 描述 |
---|---|---|
TIMResult | TIMResult | 调用接口的返回值 |
code | int | 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码 |
desc | string | 错误描述字符串 |
json_param | string | Json字符串,不同的接口,Json字符串不一样 Json Key请参考GroupInviteMemberResult |
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.Collections.Generic;
public class GroupInviteMember : MonoBehaviour
{
public Text Header;
public InputField UserId;
public InputField CustomData;
public Dropdown SelectedGroup;
public Text Result;
public Button Submit;
public Button Copy;
private List<string> GroupList;
void Start()
{
GameObject.Find("SelectGroupLabel").GetComponent<Text>().text = Utils.t("SelectGroupLabel");
GroupGetJoinedGroupListSDK();
Header = GameObject.Find("HeaderText").GetComponent<Text>();
SelectedGroup = GameObject.Find("Dropdown").GetComponent<Dropdown>();
UserId = GameObject.Find("UserId").GetComponent<InputField>();
CustomData = GameObject.Find("CustomData").GetComponent<InputField>();
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(GroupInviteMemberSDK);
Copy.onClick.AddListener(CopyText);
SelectedGroup.interactable = true;
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 GetGroupList(params object[] parameters)
{
try
{
GroupList = new List<string>();
SelectedGroup.ClearOptions();
string text = (string)parameters[1];
List<GroupBaseInfo> List = Utils.FromJson<List<GroupBaseInfo>>(text);
foreach (GroupBaseInfo item in List)
{
print(item.group_base_info_group_id);
GroupList.Add(item.group_base_info_group_id);
Dropdown.OptionData option = new Dropdown.OptionData();
option.text = item.group_base_info_group_id;
SelectedGroup.options.Add(option);
}
SelectedGroup.value = 0;
if (List.Count > 0)
{
SelectedGroup.captionText.text = List[0].group_base_info_group_id;
}
else
{
SelectedGroup.captionText.text = "";
}
}
catch (Exception ex)
{
Toast.Show(Utils.t("getGroupListFailed"));
}
}
void GroupGetJoinedGroupListSDK()
{
TIMResult res = TencentIMSDK.GroupGetJoinedGroupList(Utils.addAsyncStringDataToScreen(GetGroupList));
print($"GroupGetJoinedGroupListSDK {res}");
}
void GroupInviteMemberSDK()
{
if (GroupList.Count < 1)
{
return;
}
print(GroupList[SelectedGroup.value]);
string groupID = GroupList[SelectedGroup.value];
var param = new GroupInviteMemberParam
{
group_invite_member_param_group_id = groupID,
group_invite_member_param_identifier_array = new List<string> {
UserId.text
},
group_invite_member_param_user_data = CustomData.text
};
TIMResult res = TencentIMSDK.GroupInviteMember(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();
}
}