MsgSetMessageExtensions
introduction
Set message extensions
Available on native SDK v6.7 or higher
Ultimate package only, Buy Ultimate package to enable it.
Parameter details
overload1
Parameter name | Parameter type | Required | Description |
---|---|---|---|
message | Message | Required | Message fulfills 1. Sending message with true for supportMessageExtension. 2. Message status is sent. 3. Message not for Community and AVChatRoom |
extensions | List< MessageExtension > | Required | Message extensions |
callback | ValueCallback< List< MessageExtensionResult > > | Required | Asynchronous callback The format of json_param in the return value is json |
overload2
Parameter name | Parameter type | Required | Description |
---|---|---|---|
message | Message | Required | Message fulfills 1. Sending message with true for supportMessageExtension. 2. Message status is sent. 3. Message not for Community and AVChatRoom |
extensions | List< MessageExtension > | Required | Message extensions |
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:List<MessageExtensionResult>
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.Text;
using System.Collections.Generic;
public class MsgSetMessageExtensions : MonoBehaviour
{
string[] Labels = new string[] { "CustomKeyPlaceHolder", "CustomValuePlaceHolder" };
public Text Header;
public InputField MsgID;
public InputField Keys;
public InputField Values;
public Text Result;
public Button Submit;
public Button Copy;
void Start()
{
foreach (string label in Labels)
{
GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
}
Header = GameObject.Find("HeaderText").GetComponent<Text>();
MsgID = GameObject.Find("MsgID").GetComponent<InputField>();
Keys = GameObject.Find("Keys").GetComponent<InputField>();
Values = GameObject.Find("Values").GetComponent<InputField>();
Result = GameObject.Find("ResultText").GetComponent<Text>();
Submit = GameObject.Find("Submit").GetComponent<Button>();
Copy = GameObject.Find("Copy").GetComponent<Button>();
Submit.onClick.AddListener(MsgFindMessages);
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 MsgFindMessages()
{
TIMResult res = TencentIMSDK.MsgFindMessages(new List<string> { MsgID.text }, Utils.addAsyncStringDataToScreen(GetMessage));
print("MsgFindMessages: " + res);
}
void MsgSetMessageExtensionsSDK(Message msg)
{
var list = new List<MessageExtension>();
var keys = Keys.text.Split(',');
var values = Values.text.Split(',');
for (int i = 0; i < Math.Min(keys.Length, values.Length); i++)
{
if (!string.IsNullOrEmpty(keys[i]))
{
list.Add(new MessageExtension
{
message_extension_key = keys[i],
message_extension_value = values[i]
});
}
}
TIMResult res = TencentIMSDK.MsgSetMessageExtensions(msg, list, Utils.addAsyncStringDataToScreen(GetResult));
Result.text = Utils.SynchronizeResult(res);
}
void GetMessage(params object[] parameters)
{
string text = (string)parameters[1];
print(text);
var list = Utils.FromJson<List<Message>>(text);
if (list.Count > 0)
{
MsgSetMessageExtensionsSDK(list[0]);
}
}
void GetResult(params object[] parameters)
{
Result.text += (string)parameters[0];
}
void CopyText()
{
Utils.Copy(Result.text);
}
void OnApplicationQuit()
{
TencentIMSDK.Uninit();
}
}