game_chat_transcribed_chat_received_state_change
game_chat_state_change_type::transcribed_chat_received 상태 변경과 관련된 정보를 나타냅니다.
구문
typedef struct game_chat_transcribed_chat_received_state_change {
chat_user* speaker;
uint32_t receiver_count;
chat_user_array receivers;
PCWSTR message;
} game_chat_transcribed_chat_received_state_change
멤버
스피커
형식: chat_user*
문자 메시지를 시작한 chat_user 개체에 대한 포인터입니다.
chat_user 개체 포인터는 chat_manager::remove_user 메서드가 사용자 현지 chat_manager 인스턴스에서 제거될 때까지 유효합니다.
receiver_count
형식: uint32_t
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 개체와 연결된 사용자의 오디오 기록을 통해 생성된 텍스트 문자열에 대한 포인터입니다. 문자열은 최대 c_maxChatTextMessageLength자일 수 있으며, Null 종결자를 포함하지 않습니다.
참고 항목
c_maxChatTextMessageLength은(는) 값이 1023인 constexpr uint16_t입니다.
문자열은 chat_manager::finish_processing_state_changes을(를) 호출하여 이 개체가 반환될 때까지 유효한 상태를 유지합니다. 앱에서는 텍스트를 복사하여 게임 채팅 통신 정책 가이드 문서에서 설명하는 방식과 기간에 따라 표시해야 합니다.
설명
이 구조는 게임 채팅 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 호출을 통해 이 구조를 사용하여 배열이 앱에서 게임 채팅 2로 다시 전달되기 전에 상태 변경에 대한 자세한 정보를 가져오고 상태 변경을 처리할 수 있습니다.
상태 변경을 처리하는 방법에 대한 자세한 내용은 게임 채팅 2 C++ API 사용을 참조하세요.
요구 사항
헤더: GameChat2.h
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔