MsgSetMessageExtensions

功能介绍

设置消息扩展

Native SDK 6.7 及其以上版本支持

该功能需要购买旗舰版套餐包,购买 旗舰版套餐包 后可使用。

参数详解

重载1

参数名称 参数类型 是否必填 描述
message Message 消息,消息需满足三个条件:1、消息发送前需设置 supportMessageExtension 为 true,2、消息必须是发送成功的状态,3、消息不能是社群(Community)和直播群(AVChatRoom)消息。
extensions List< MessageExtension > 消息扩展信息,如果扩展 key 已经存在,则修改扩展的 value 信息,如果扩展 key 不存在,则新增扩展
callback ValueCallback< List< MessageExtensionResult > > 异步回调 返回值的json_param的格式为json

重载2

参数名称 参数类型 是否必填 描述
message Message 消息,消息需满足三个条件:1、消息发送前需设置 supportMessageExtension 为 true,2、消息必须是发送成功的状态,3、消息不能是社群(Community)和直播群(AVChatRoom)消息。
extensions List< MessageExtension > 消息扩展信息,如果扩展 key 已经存在,则修改扩展的 value 信息,如果扩展 key 不存在,则新增扩展
callback ValueCallback< string > 异步回调 返回值的json_param的格式为string

返回模板

TIMResult

调用成功后回调函数参数:
code:int
desc:string
json_param:List<MessageExtensionResult>
user_data:string

返回值详解

名称 数值类型 描述
TIMResult TIMResult 调用接口的返回值
code int 值为ERR_SUCC表示成功,其他值表示失败。详情请参考 错误码
desc string 错误描述字符串
json_param string Json字符串,不同的接口,Json字符串不一样
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.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();
  }
}

results matching ""

    No results matching ""