频道消息
Send, receive and manage text messages in Vivox channels.
阅读时间4 分钟最后更新于 8 个月前
VivoxMessages 可以发送到使用 TextOnly 或 TextAndAudio 的 ChatCapability 启用了文本的特定 Vivox 频道。
发送频道消息
您可以使用 向频道发送消息，其中 是消息的目标频道， 是要发送的消息。
VivoxService.Instance.SendChannelTextMessageAsync(string channelName, string message)channelNamemessage以下代码片段的示例实现了将消息发送到设置的 Lobby 频道并从 MessageInputField InputField 对象提取文本。
public async void SendMessageAsync(){ if (string.IsNullOrEmpty(MessageInputField.text)) { return; } VivoxService.Instance.SendChannelTextMessageAsync(LobbyChannelName, MessageInputField.text); MessageInputField.text = string.Empty;}
接收频道消息
为了从启用了文本的频道接收消息，必须订阅 操作。
VivoxService.Instance.ChannelMessageReceived发送到频道的 VivoxMessages 与定向消息几乎相同，只是在 中添加了 ChannelName，并根据消息是否来自当前登录用户设置了 字段。
VivoxMessage.ChannelNameVivoxMessage.FromSelf以下代码片段是订阅以上操作的代码行示例，以及在收到 VivoxMessage 时从中提取所有可用信息的示例。
//Subscribe to this event at some point in the Vivox initialization process,//preferably before joining any channels.. . .VivoxService.Instance.ChannelMessageReceived += OnChannelMessageReceived;. . .void OnChannelMessageReceived(VivoxMessage message){ var channelName = message.ChannelName; var senderName = message.SenderDisplayName; var senderId = message.SenderPlayerId; var messageText = message.MessageText; var timeReceived = message.ReceivedTime; var language = message.Language; var fromSelf = message.FromSelf; var messageId = message.MessageId;}
频道文本消息历史记录
Vivox 允许用户使用 访问频道文本活动的历史记录，其中 是要请求相应历史记录的频道的名称， 是最多要返回的消息数（默认值为 10）， 是一个可选参数，可以执行多种操作，例如指定消息中包含的单词或短语、消息的特定 PlayerId 发送方，或前后查询时间。如需了解有关 s 的更多具体信息，请参阅聊天历史记录查询选项。
VivoxService.Instance.GetChannelTextMessageHistoryAsync(string channelName, int requestSize = 10, ChatHistoryQueryOptions chatHistoryQueryOptions = null)channelNamerequestSizechatHistoryQueryOptionsChatHistoryQueryOptionIReadOnlyCollection注意
聊天历史记录保存 7 天。如果正在使用文本证据管理，聊天历史记录的保存期限将延长至 30 天。
以下代码片段的示例说明如何从设置的 LobbyChannelName 中提取最近 25 条消息，然后按从旧到新的顺序记录发送方的显示名称和消息，而无需使用可选的 ChatHistoryQueryOptions。
public async void FetchHistoryAsync(){ var historyMessages = await VivoxService.Instance.GetChannelTextMessageHistoryAsync(LobbyChannelName, 10); //Reversing the messages so they display from oldest to newest var reversedMessages = historyMessages.Reverse(); foreach(VivoxMessage message in reversedMessages) { Debug.Log($"{message.SenderDisplayName}: {message.MessageText}"); }}
编辑频道消息
Vivox 允许用户使用 编辑他们发送到频道的消息文本，其中 channelName 是消息发送到的频道的名称，messageId 是要更改的消息的 ID，newMessage 是更新的消息文本。
VivoxService.Instance.EditChannelTextMessageAsync(string channelName, string messageId, string newMessage)当频道中的任何人成功编辑消息后，频道中的所有人都将收到一个 操作，其中包含已编辑的 VivoxMessage 以及更新的 MessageText。
VivoxService.Instance.ChannelMessageEditedpublic async void UpdateChannelMessageAsync(VivoxMessage messageToUpdate, string updatedMessageText){ await VivoxService.Instance.EditChannelTextMessageAsync(messageToUpdate.ChannelName, messageToUpdate.MessageId, updatedMessageText);}
删除频道消息
Vivox 允许用户使用 删除他们发送到频道的消息，其中 channelName 是消息发送到的频道的名称，messageId 是要删除的消息的 ID。
VivoxService.Instance.DeleteChannelTextMessageAsync(string channelName, string messageId)当频道中的任何人成功删除消息后，频道中的所有人都将收到一个 操作，其中包含已删除的 VivoxMessage。
VivoxService.Instance.ChannelMessageDeletedpublic async void DeleteChannelMessageAsync(VivoxMessage messageToDelete){ await VivoxService.Instance.DeleteChannelTextMessageAsync(messageToDelete.ChannelName, messageToDelete.MessageId)}