直接送信メッセージ
Send direct messages between users.
読み終わるまでの所要時間 2 分最終更新 7ヶ月前
サービスにサインインしている個々のプレイヤーに対して、VivoxMessage を送信できます。この機能はしばしば DM と呼ばれます。
直接送信メッセージを送信する
VivoxService.Instance.SendDirectTextMessageAsync(string playerId, string message)以下のコードスニペットは、マネージチャンネルロースターから渡されたプレイヤーに、専用のメッセージ InputField からプルされたメッセージを送信するための実装例です。
void SendMessageAsync(string playerId){ if (string.IsNullOrEmpty(MessageInputField.text)) { return; } VivoxService.Instance.SendChannelTextMessageAsync(playerId, MessageInputField.text); MessageInputField.text = string.Empty;}
直接送信メッセージを受信する
他のユーザーからのメッセージを受信するには、 イベントにサブスクライブする必要があります。
VivoxService.Instance.DirectedMessageReceived直接送信 VivoxMessage は チャンネルメッセージ とほぼ同じですが、 が null に設定され、 が false に設定されるという注意点があります。
VivoxMessage.ChannelNameVivoxMessage.FromSelf以下のコードスニペットは、このイベントにサブスクライブする行の例と、受信時に VivoxMessage から利用可能なすべての情報をプルする例です。
//Subscribe to this event at some point in the Vivox initialization process,//preferably before joining any channels.. . .VivoxService.Instance.DirectedMessageReceived += OnDirectedMessageReceived;. . .void OnDirectedMessageReceived(VivoxMessage message){ var senderName = message.SenderDisplayName; var senderId = message.SenderPlayerId; var messageText = message.MessageText; var timeReceived = message.ReceivedTime; var language = message.Language; var messageId = message.MessageId;}
ダイレクトテキストメッセージの履歴
また、Vivox では を使用して、ユーザーが 2 人のプレイヤー間のダイレクトメッセージによる対話の履歴にアクセスできるようにします。playerId は履歴をリクエストするプレイヤーの ID、requestSize は返すメッセージの最大数 (デフォルトは 10) で、chatHistoryQueryOptions はメッセージに含まれる単語やフレーズ、クエリの対象とする時刻 (その時刻の前または後) の指定などができる任意のパラメーターです。ChatHistoryQueryOptions のより具体的な情報については、チャット履歴のクエリオプション のページを参照してください。
VivoxService.Instance.GetDirectTextMessageHistoryAsync(string playerId, int requestSize = 10, ChatHistoryQueryOptions chatHistoryQueryOptions = null)IReadOnlyCollection以下のコードスニペットは、設定された LobbyChannelName から最新の 25 件のメッセージをプルし、任意の は使用せずに、送信者の表示名とメッセージを古いものから新しいものへの順でログ記録する例です。
ChatHistoryQueryOptionsvoid FetchHistoryAsync(){ var historyMessages = await VivoxService.Instance.GetDirectTextMessageHistoryAsync(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 では、 を使用して、ユーザーがチャンネルに送信したメッセージのテキストを編集できるようにします。messageId は変更するメッセージの ID、newMessage はメッセージの更新後のテキストです。
VivoxService.Instance.EditDirectTextMessageAsync(string messageId, string newMessage)メッセージが正常に編集されると、ダイレクトメッセージに関連付けられているサインイン中のプレイヤーは、編集された VivoxMessage と更新後の MessageText を含む アクションを受信します。
VivoxService.Instance.DirectedMessageEditedpublic async void UpdateDirectedMessageAsync(VivoxMessage messageToUpdate, string updatedMessageText){ await VivoxService.Instance.EditDirectTextMessageAsync(messageToUpdate.MessageId, updatedMessageText);}
ダイレクトメッセージの削除
Vivox では、 を使用して、ユーザーが送信したダイレクトメッセージを削除できるようにします。messageId は削除するメッセージの ID です。
VivoxService.Instance.DeleteDirectTextMessageAsync(string messageId)メッセージが正常に削除されると、直接送信メッセージに関連付けられているサインイン中のプレイヤーは、削除された VivoxMessage を含む アクションを受信します。
VivoxService.Instance.DirectedMessageDeletedpublic async void DeleteDirectMessageAsync(VivoxMessage messageToDelete){ await VivoxService.Instance.DeleteDirectTextMessageAsync(messageToDelete.MessageId)}