设置聊天标记

Chat Markers API 可控制聊天标记的创建。聊天标记可用于将消息标记为已读。此外，还用于为 Conversation List API 提供数据。此功能适用于频道和私信。

要设置对话的已读标记，请登录应用程序并使用 VivoxService.Instance.SetMessageAsReadAsync()。此方法使用 VivoxMessage 输入来确定所属的对话类型以及要设置为已读的消息的 MessageId。此方法在提供的 VivoxMessage 的 MessageId 处为相关对话设置一个已读检查点。

注意：即使 URI 或消息不存在，也会创建标记。将来，这些信息将用于扩充 Conversations API。

以下代码的示例说明如何设置聊天标记：

DateTime seenAt = DateTime.Now; // Optional timestamp for when the message was seen. Default is DateTime.Now converted to UTC.
var readMessage = await VivoxService.Instance.SetMessageAsReadAsync(message, seenAt);

完成后将返回 IsRead 属性设置为 true 的 VivoxMessage。

由于不能手动创建 VivoxMessage 实例，因此 VivoxService.Instance.SetMessageAsReadAsync() 的输入必须来自 SDK 中向客户端提供 VivoxMessage 的事件或方法之一。以下列举的一些事件和方法提供了可用作 VivoxService.Instance.SetMessageAsReadAsync() 的输入的 VivoxMessage 实例：

// Events
ChannelMessageReceived;
ChannelMessageEdited;
ChannelMessageDeleted;
DirectedMessageReceived;
DirectedMessageDeleted;
DirectedMessageEdited;

// Methods
GetChannelTextMessageHistoryAsync();
GetDirectTextMessageHistoryAsync();