ConvSetConversationCustomData
introduction
Set Conversation Custom Data
Parameter details
overload1
Parameter name |
Parameter type |
Required |
Description |
conversation_id_array |
List< string > |
Required |
Conversation ID List |
custom_data |
string |
Required |
Custom Data, Maximum 256 bytes |
callback |
ValueCallback< List< ConversationOperationResult > > |
Required |
Asynchronous callback. |
overload2
Parameter name |
Parameter type |
Required |
Description |
conversation_id_array |
List< string > |
Required |
Conversation ID List |
custom_data |
string |
Required |
Custom Data, Maximum 256 bytes |
callback |
ValueCallback< string > |
Required |
Asynchronous callback. The format of json_param in the return value is string |
Returned template
TIMResult
The parameters of the callback function after successfully calling the API:
code:int
desc:string
json_param:'ValueCallback<List<ConversationOperationResult>>
user_data:string
Return value details
name |
type |
description |
TIMResult |
TIMResult |
Return value of calling API |
code |
int |
Result error code: Error Codes |
desc |
string |
The description of the error. |
json_param |
string |
Json string. Calling different API will get different Json strings. |
user_data |
string |
User-defined data transfered by ImSDK without any processing |
Code example
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 ConvSetConversationCustomData : MonoBehaviour
{
public Text Header;
public Dropdown SelectedConv;
public Text Result;
public InputField CustomData;
public Button Submit;
public Button Copy;
private List<ConvInfo> ConvList;
void Start()
{
ConvGetConvListSDK();
Header = GameObject.Find("HeaderText").GetComponent<Text>();
SelectedConv = GameObject.Find("Dropdown").GetComponent<Dropdown>();
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(ConvSetConversationCustomDataSDK);
Copy.onClick.AddListener(CopyText);
SelectedConv.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 GetConvList(params object[] parameters)
{
try
{
ConvList = new List<ConvInfo>();
SelectedConv.ClearOptions();
string text = (string)parameters[1];
List<ConvInfo> List = Utils.FromJson<List<ConvInfo>>(text);
foreach (ConvInfo item in List)
{
print(item.conv_id);
ConvList.Add(item);
Dropdown.OptionData option = new Dropdown.OptionData();
option.text = item.conv_id;
SelectedConv.options.Add(option);
}
if (List.Count > 0)
{
SelectedConv.captionText.text = List[SelectedConv.value].conv_id;
}
}
catch (Exception ex)
{
Toast.Show(Utils.t("getConvListFailed"));
}
}
void ConvGetConvListSDK()
{
TIMResult res = TencentIMSDK.ConvGetConvList(Utils.addAsyncStringDataToScreen(GetConvList));
print($"ConvGetConvListSDK {res}");
}
void ConvSetConversationCustomDataSDK()
{
if (ConvList.Count == 0)
{
return;
}
print(ConvList[SelectedConv.value].conv_id);
string conv_id = ConvList[SelectedConv.value].conv_id;
if (!Utils.IsValidConvID(conv_id))
{
conv_id = Utils.SetConvIDPrefix(conv_id, ConvList[SelectedConv.value].conv_type);
}
TIMResult res = TencentIMSDK.ConvSetConversationCustomData(new List<string> {
conv_id
}, CustomData.text, 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();
}
}