GroupGetPendencyList
功能介绍
获取群未决信息列表
此处的群未决消息泛指所有需要审批的群相关的操作。例如：加群待审批，拉人入群待审批等等。即便审核通过或者拒绝后，该条信息也可通过此接口拉回，拉回的信息中有已决标志。
UserA申请加入群GroupA，则群管理员可获取此未决相关信息，UserA因为没有审批权限，不需要获取此未决信息。
如果AdminA拉UserA进去GroupA，则UserA可以拉取此未决相关信息，因为该未决信息待UserA审批
权限说明：
只有审批人有权限拉取相关未决信息。
group_pendency_option_start_time 设置拉取时间戳,第一次请求填0,后边根据server返回的 GroupPendencyResult 键 group_pendency_result_next_start_time 指定的时间戳进行填写。
group_pendency_option_max_limited 拉取的建议数量,server可根据需要返回或多或少,不能作为完成与否的标志
参数详解
重载1
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| json_group_getpendence_list_param | GroupPendencyOption | 是 | 获取信息参数 |
| callback | ValueCallback< GroupPendencyResult > | 是 | 异步回调 返回值的json_param的格式为json |
重载2
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| json_group_getpendence_list_param | GroupPendencyOption | 是 | 获取信息参数 |
| callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数：
code:int
desc:string
json_param:
'{
"group_pendency_result_next_start_time" : 0,
"group_pendency_result_pendency_array" : [
{
"group_pendency_add_time" : 1551414487947,
"group_pendency_apply_invite_msg" : "Want Join Group, Thank you",
"group_pendency_approval_msg" : "",
"group_pendency_form_identifier" : "user2",
"group_pendency_form_user_defined_data" : "",
"group_pendency_group_id" : "four group id",
"group_pendency_handle_result" : 0,
"group_pendency_handled" : 0,
"group_pendency_pendency_type" : 0,
"group_pendency_to_identifier" : "user1",
"group_pendency_to_user_defined_data" : ""
}
],
"group_pendency_result_read_time_seq" : 0,
"group_pendency_result_unread_num" : 1
}' // Json Key请参考[GroupPendencyResult]
user_data:string
返回值详解
| 名称 | 数值类型 | 描述 |
|---|---|---|
| TIMResult | TIMResult | 调用接口的返回值 |
| code | int | 值为ERR_SUCC表示成功，其他值表示失败。详情请参考 错误码 |
| desc | string | 错误描述字符串 |
| json_param | string | Json字符串，不同的接口，Json字符串不一样 Json Key请参考GroupPendencyResult |
| 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 GroupGetPendencyList : MonoBehaviour
{
public Text Header;
public Text LastSeq;
public Text Result;
public Button Submit;
public Button Copy;
void Start()
{
Header = GameObject.Find("HeaderText").GetComponent<Text>();
LastSeq = GameObject.Find("LastSeq").GetComponent<Text>();
LastSeq.text = "0";
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(GroupGetPendencyListSDK);
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 GroupGetPendencyListSDK()
{
GroupPendencyOption param = new GroupPendencyOption
{
group_pendency_option_start_time = Convert.ToUInt64(LastSeq.text)
};
TIMResult res = TencentIMSDK.GroupGetPendencyList(param, Utils.addAsyncStringDataToScreen(GetResult));
Result.text = Utils.SynchronizeResult(res);
}
void GetResult(params object[] parameters)
{
Result.text += (string)parameters[0];
string text = (string)parameters[1];
var res = Utils.FromJson<GroupPendencyResult>(text);
LastSeq.text = res.group_pendency_result_next_start_time.ToString();
}
void CopyText()
{
Utils.Copy(Result.text);
}
void OnApplicationQuit()
{
TencentIMSDK.Uninit();
}
}