기술 자료

지원

Vivox Unity SDK

Vivox Unity SDK

채팅 이력 쿼리 옵션

Query chat history with various filtering options.
읽는 시간 1분최근 업데이트: 19일 전

ChatHistoryQueryOptions는 반환되어야 하는 메시지를 지정하기 위해
VivoxService.Instance.GetDirectTextMessageHistoryAsync
또는
VivoxService.Instance.GetChannelTextMessageHistoryAsync
호출에 포함될 수 있는 옵션 모델(선택 사항)입니다.

SearchText

ChatHistoryQueryOptions
의 SearchText 필드를 사용하여 채팅 이력 쿼리에서 반환된 모든 메시지에 포함되어야 하는 텍스트 문자열을 지정할 수 있습니다. 예를 들어 다음 코드는 반환된 historyMessages에 ‘Hello, lobby!’라는 텍스트가 포함된 메시지만 포함되도록 합니다.
var options = new ChatHistoryQueryOptions();options.SearchText = "Hello, lobby!";var historyMessages = await VivoxService.Instance.GetChannelTextMessageHistoryAsync(LobbyChannelName, 10, options);

TimeStart - TimeEnd

ChatHistoryQueryOptions
의 TimeStart와 TimeEnd 필드는 모두 메시지가 전송되어야 하는 각각의 전후 시간을 설명하는
DateTimes
입니다. 예를 들어 다음 코드는 요청이 이루어지기 24시간 전부터 요청이 이루어지기 12시간 전까지 마지막 10개의 메시지를 반환합니다.
var 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

ChannelTextMessageHistory
요청의 경우 ChatHistoryQueryOptions의 PlayerId 필드는 반환된 모든 메시지의 발송자가 될 PlayerId를 설명합니다. 예를 들어 다음 코드는 지정된 채널의 특정 참가자가 보낸 마지막 10개의 메시지를 반환합니다.
IReadOnlyCollection<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가 보낸 메시지를 볼 수 없습니다.

차단된 참가자가 참여한 경우 이력 세션

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

차단된 참가자의 계정 채팅 이력

계정에 대한 채팅 이력 요청을 제출하면 쿼리에는 사용자가 보낸 메시지만 표시됩니다.