MsgReportReaded
功能介绍
消息已读上报 C2C
message 可以填 NULL 空字符串指针或者""空字符串，此时以会话当前最新消息的时间戳（如果会话存在最新消息）或当前时间为已读时间戳上报.
当要指定消息时，则以该指定消息的时间戳为已读时间戳上报，最好用接收新消息获取的消息数组里面的消息Json或者用消息定位符查找到的消息Json，避免重复构造消息Json。
参数详解
重载1
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| conv_id | string | 是 | 会话ID |
| conv_type | TIMConvType | 是 | 会话类型 |
| message | Message | 是 | 消息体 |
| callback | NullValueCallback | 是 | 异步回调 |
重载2
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| conv_id | string | 是 | 会话ID |
| conv_type | TIMConvType | 是 | 会话类型 |
| message | Message | 是 | 消息体 |
| callback | ValueCallback< string > | 是 | 异步回调 返回值的json_param的格式为string |
返回模板
TIMResult
调用成功后回调函数参数：
code:int
desc:string
json_param:'' // json_params为空字符串""
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 MsgReportReaded : MonoBehaviour
{
string[] Labels = new string[] { "SelectFriendLabel" };
public Text Header;
public Dropdown SelectedFriend;
public Text Result;
public Button Submit;
public Button Copy;
private List<string> FriendList;
void Start()
{
foreach (string label in Labels)
{
GameObject.Find(label).GetComponent<Text>().text = Utils.t(label);
}
FriendshipGetFriendProfileListSDK();
Header = GameObject.Find("HeaderText").GetComponent<Text>();
SelectedFriend = GameObject.Find("Friend").GetComponent<Dropdown>();
Result = GameObject.Find("ResultText").GetComponent<Text>();
Submit = GameObject.Find("Submit").GetComponent<Button>();
Copy = GameObject.Find("Copy").GetComponent<Button>();
Submit.onClick.AddListener(MsgReportReadedSDK);
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 GetFriendList(params object[] parameters)
{
try
{
FriendList = new List<string>();
SelectedFriend.ClearOptions();
string text = (string)parameters[1];
List<FriendProfile> List = Utils.FromJson<List<FriendProfile>>(text);
foreach (FriendProfile item in List)
{
print(item.friend_profile_identifier);
FriendList.Add(item.friend_profile_identifier);
var option = new Dropdown.OptionData();
option.text = item.friend_profile_identifier;
SelectedFriend.options.Add(option);
}
if (List.Count > 0)
{
SelectedFriend.captionText.text = List[SelectedFriend.value].friend_profile_identifier;
}
else
{
SelectedFriend.captionText.text = "";
}
}
catch (Exception ex)
{
Toast.Show(Utils.t("getFriendListFailed"));
}
}
void FriendshipGetFriendProfileListSDK()
{
TIMResult res = TencentIMSDK.FriendshipGetFriendProfileList(Utils.addAsyncStringDataToScreen(GetFriendList));
print($"FriendshipGetFriendProfileListSDK {res}");
}
void MsgReportReadedSDK()
{
print(FriendList[SelectedFriend.value]);
// 可以填 NULL 空字符串指针或者""空字符串，此时以会话当前最新消息的时间戳（如果会话存在最新消息）或当前时间为已读时间戳上报.当要指定消息时，则以该指定消息的时间戳为已读时间戳上报，最好用接收新消息获取的消息数组里面的消息Json或者用消息定位符查找到的消息Json，避免重复构造消息
TIMResult res = TencentIMSDK.MsgReportReaded(FriendList[SelectedFriend.value], TIMConvType.kTIMConv_C2C, null, 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();
}
}