game_chat_text_chat_received_state_change
game_chat_state_change_type::text_chat_received 상태 변경에 특화된 정보를 나타냅니다.구문
멤버
sender형식: 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 chat_user_local::send_chat_text를 호출하여 전송된 텍스트 문자열에 대한 포인터입니다. 문자열은 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::text_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 멤버