채팅 이력 쿼리 옵션
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_sessionSDK는 채널에서 채팅 이력을 검색할 때 차단된 사용자의 메시지를 생략합니다. 사용자 A가 애플리케이션에서 사용자 B를 차단한 경우 사용자 A는 사용자 B가 보낸 메시지를 볼 수 없습니다.
차단된 참가자가 참여한 경우 이력 세션
요청의 모든 메시지가 차단된 참가자가 보낸 것인 경우 이력 요청이 비어 있을 수 있습니다. 이 경우 응답에는 후속 페이지의 채널에 더 많은 메시지가 있음을 나타내는 커서가 포함됩니다. 이력 요청당 반환되는 기본 메시지 양은 페이지당 10개입니다. 메시지의 다음 페이지를 검색하려면 다음 요청에서 커서 값을 사용하십시오.
최대 페이지 크기 인수(Max)는 채널에 차단된 사용자가 있는 경우 요청된 수보다 적은 수의 메시지를 표시합니다. 채팅 이력에 대한 특정 페이지 크기를 요청할 때 채널에 차단된 사용자가 있는 경우 이 선택한 숫자보다 적은 수의 메시지를 표시할 수 있습니다. 이 기능은 개인정보를 보호하고 원치 않는 상호 작용을 방지하는 데 중요합니다.
history_session마지막 읽기에는 읽지 않은 메시지 수가 표시됩니다. Vivox는 읽은 메시지를 확인하고 읽지 않은 메시지 수를 제공합니다. 그러나 이 수에는 응답에서 의도적으로 필터링된 차단된 메시지가 포함됩니다. 채널에 차단된 사용자가 있는 경우 읽지 않은 메시지 수가 정확하지 않을 수 있습니다.
차단된 참가자의 계정 채팅 이력
계정에 대한 채팅 이력 요청을 제출하면 쿼리에는 사용자가 보낸 메시지만 표시됩니다.