Skip to main content

game_chat_transcribed_chat_received_state_change

game_chat_state_change_type::transcribed_chat_received 상태 변경에 특화된 정보를 나타냅니다.

구문

멤버

speaker  
형식: chat_user*
텍스트 메시지를 발신한 chat_user 개체에 대한 포인터입니다. chat_user 개체의 포인터는 chat_manager::remove_user 메서드를 통해 사용자가 로컬 chat_manager 인스턴스에서 제거될 때까지 유효한 상태로 유지됩니다. receiver_count  
형식: uint32_t
receivers의 배열 요소 수입니다. receivers  _Field_size_(receiver_count)
형식: chat_user_array
텍스트 메시지가 전달되는 하나 이상의 로컬 대상 플레이어에 대한 chat_user 포인터의 배열입니다. chat_user_array 개체에 대한 메모리는 chat_manager::finish_processing_state_changes를 호출하여 이 개체가 반환될 때까지 유효한 상태로 유지됩니다. 개별 chat_user 개체 포인터는 chat_manager::remove_user 메서드를 통해 사용자가 로컬 chat_manager 인스턴스에서 제거될 때까지 유효한 상태로 유지됩니다. message  
형식: PCWSTR
speaker 개체와 연결된 사용자의 오디오를 필사하여 생성된 텍스트 문자열에 대한 포인터입니다. 문자열은 null 종결자를 제외하고 최대 c_maxChatTextMessageLength 문자 길이일 수 있습니다.
c_maxChatTextMessageLength는 값이 1023인 constexpr uint16_t입니다.
문자열은 chat_manager::finish_processing_state_changes를 호출하여 이 개체가 반환될 때까지 유효한 상태로 유지됩니다. 앱은 Game Chat 통신 정책 가이드 문서에 설명된 방식과 기간으로 표시하기 위해 텍스트의 복사본을 만들어야 합니다.

설명

이 구조체는 Game Chat 2의 game_chat_state_change_type::transcribed_chat_received 상태 변경에 대한 추가 정보를 제공합니다. 이 상태 변경은 원격 플레이어의 음성 통신이 필사되어 하나 이상의 로컬 사용자에게 표시되어야 할 때 발생합니다. 이 상태 변경이 발생하면, 이 구조체는 앱이 chat_manager::start_processing_state_changes를 호출할 때 검색되는 game_chat_state_change_array 배열의 game_chat_state_change 요소로 반환됩니다. 해당 game_chat_state_change 요소의 state_change_type 멤버 값을 확인하여 상태 변경 유형을 확인한 후, 해당 요소를 이 구조체로 캐스팅할 수 있습니다. 그런 다음 chat_manager::finish_processing_state_changes를 호출하여 배열이 앱에서 Game Chat 2로 다시 전달되기 전에 이 구조체를 사용하여 상태 변경에 대한 자세한 정보를 얻고 처리할 수 있습니다. 상태 변경 처리에 대한 자세한 내용은 Game Chat 2 C++ API 사용을 참조하세요.

요구 사항

헤더: GameChat2.h 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

Game Chat 2 소개
chat_manager
GameChat2 멤버
마지막 수정일 2026년 8월 24일