チャット履歴のクエリオプション
Query chat history with various filtering options.
読み終わるまでの所要時間 1 分最終更新 7ヶ月前
ChatHistoryQueryOptions は、どのようなメッセージを返すかを指定するために または の呼び出しに含めることができる、任意のオプションのモデルです。
VivoxService.Instance.GetDirectTextMessageHistoryAsyncVivoxService.Instance.GetChannelTextMessageHistoryAsyncSearchText
ChatHistoryQueryOptionsvar options = new ChatHistoryQueryOptions();options.SearchText = "Hello, lobby!";var historyMessages = await VivoxService.Instance.GetChannelTextMessageHistoryAsync(LobbyChannelName, 10, options);
TimeStart - TimeEnd
ChatHistoryQueryOptionsDateTimesvar options = new ChatHistoryQueryOptions();options.TimeStart = DateTime.Now().AddDays(-1);options.TimeEnd = DateTime.Now().AddDays(-0.5);var historyMessages = await VivoxService.Instance.GetChannelTextMessageHistoryAsync(LobbyChannelName, 10, options);
テキストエビデンス管理を有効にしない場合、チャット履歴は 7 日間しか保存されないことに注意してください。
PlayerId
ChannelTextMessageHistoryIReadOnlyCollection<VivoxMessage> GetMessagesFromPlayerAsync(VivoxParticipant participant){ var options = new ChatHistoryQueryOptions(); options.PlayerId = participant.PlayerId; var historyMessages = await VivoxService.Instance.GetChannelTextMessageHistoryAsync(LobbyChannelName, 10, options); return historyMessages;}
ブロックされた参加者に対するチャンネルベースのチャット履歴
history_sessionチャンネルからチャット履歴を取得するときに、SDK により、ブロックされたユーザーからのメッセージが除外されます。ユーザー A がアプリケーションでユーザー B をブロックしている場合、ユーザー A にはユーザー B が送信したメッセージは表示されません。
ブロックされた参加者がいる場合の履歴セッション
リクエストに含まれるすべてのメッセージがブロックされた参加者からのものである場合、履歴リクエストは空で返される可能性があります。この場合、応答には、後続のページにチャンネルのメッセージがさらにあることを示すカーソルが含まれます。1 回の履歴リクエストで返されるメッセージのデフォルトの数は、1 ページあたり 10 件です。次ページのメッセージを取得するには、その後のリクエストでカーソル値を使用します。
チャンネルにブロックされたユーザーがいる場合、最大ページサイズの引数 (Max) には、リクエストされた数よりも少ないメッセージが表示されます。チャット履歴で特定のページサイズをリクエストする際は、チャンネルにブロックされたユーザーがいる場合に、選択した数よりも少ないメッセージが で表示される可能性があることに注意してください。この機能は、プライバシーを確保し、不要なインタラクションを防ぐために重要です。
history_session最後に読まれたメッセージでは、未読メッセージの数が表示されます。Vivox は読まれたメッセージを追跡し、未読メッセージの数を表示します。ただし、この数には応答から意図的にフィルターされた、ブロックされたメッセージが含まれることに注意してください。チャンネルにブロックされたユーザーがいる場合、未読メッセージの数が不正確になる可能性があります。
ブロックされた参加者に対するアカウントのチャット履歴
アカウントのチャット履歴のリクエストを送信すると、クエリではそのユーザーが送信したメッセージのみが表示されます。