GroupCreate
功能介绍
创建群
在某些场景下，您可能需要对好友进行分组，例如分为 "大学同学"、"公司同事" 等，您可以调用以下接口实现。
创建群组时可以指定群ID，若未指定时IM通讯云服务器会生成一个唯一的ID，以便后续操作，群组ID通过创建群组时传入的回调返回
不支持在同一个 SDKAppID 下创建两个相同 groupID 的群
create_group_param_group_member_array 指定初始的群成员（直播群 AVChatRoom create_group_param_group_member_array 请传 null）
社群（Community）需 购买旗舰版套餐包 并 申请开通 后方可使用。
专业版或旗舰版 SDKAppID 下，所有群类型日净增群组数上限为 1 万个。免费峰值群组数为 10 万个/月，超出免费量将产生 套餐外超量费用。
参数详解
重载1
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| group | CreateGroupParam | 是 | 创建群信息 |
| callback | ValueCallback< CreateGroupResult > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| group | CreateGroupParam | 是 | 创建群信息 |
| callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数：
code:int
desc:string
json_param:
'{
"create_group_result_groupid" : "first group id"
}'// Json Key请参考[CreateGroupResult]
user_data:string
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| TIMResult | TIMResult | 调用接口的返回值 |
| code | int | 值为ERR_SUCC表示成功，其他值表示失败。详情请参考 错误码 |
| desc | string | 错误描述字符串 |
| json_param | string | Json字符串，不同的接口，Json字符串不一样 Json Key请参考CreateGroupResult |
| 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;
public class GroupCreate : MonoBehaviour
{
public Text Header;
public InputField GroupID;
public InputField GroupName;
public Dropdown GroupType;
public Text Result;
public Button Submit;
public Button Copy;
string[] Labels = new string[] { "GroupIDLabel", "GroupNameLabel", "SelectGroupTypeLabel" };
void Start()
{
foreach (string label in Labels)
{
GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
}
Header = GameObject.Find("HeaderText").GetComponent<Text>();
GroupID = GameObject.Find("GroupID").GetComponent<InputField>();
GroupName = GameObject.Find("GroupName").GetComponent<InputField>();
GroupType = GameObject.Find("Dropdown").GetComponent<Dropdown>();
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(GroupCreateSDK);
Copy.onClick.AddListener(CopyText);
GroupType.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;
}
foreach (string name in Enum.GetNames(typeof(TIMGroupType)))
{
Dropdown.OptionData option = new Dropdown.OptionData();
option.text = name;
GroupType.options.Add(option);
}
}
public void GroupCreateSDK()
{
print(GroupID.text);
print(GroupName.text);
print(GroupType.value);
CreateGroupParam param = new CreateGroupParam();
param.create_group_param_group_id = GroupID.text;
param.create_group_param_group_name = GroupName.text;
param.create_group_param_group_type = (TIMGroupType)GroupType.value;
param.create_group_param_add_option = TIMGroupAddOption.kTIMGroupAddOpt_Any;
param.create_group_param_notification = "create_group_param_notification";
param.create_group_param_introduction = "create_group_param_introduction";
param.create_group_param_face_url = "https://yq.sukeni.com/Logo.jpg";
TIMResult res = TencentIMSDK.GroupCreate(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();
}
}