chat_manager::add_remote_user
로컬 chat_manager 인스턴스에 원격 사용자를 추가합니다.구문
매개 변수
xboxUserId _In_형식: PCWSTR 추가할 원격 사용자의 XBOX User ID입니다. locallyUniqueEndpointIdentifier _In_
형식: uint64_t 원격 사용자가 있는 엔드포인트를 참조하는 데 사용되는 타이틀에서 생성된 식별자입니다. 엔드포인트는 XBOX One 또는 PC와 같은 디바이스입니다. 각 엔드포인트는 로컬 Game Chat 인스턴스에서 고유한 식별자를 가져야 하며, 이 식별자는 네트워크 전체에서 전역적으로 고유할 필요는 없습니다. 동일한 XBOX One에서 플레이하는 두 사용자와 같은 동일 엔드포인트의 원격 사용자는 동일한 엔드포인트 식별자로 추가되어야 합니다. Game Chat은 이 식별자를 사용하여 game_chat_data_frame 구조체에서 데이터를 보내야 하는 엔드포인트를 나타내며, 타이틀은 chat_manager::process_incoming_data()에서 데이터가 어느 엔드포인트에서 왔는지를 나타내는 데 이 식별자를 사용해야 합니다.
반환 값
형식: chat_user*설명
로컬 및 원격 사용자의 총 수가 chat_manager::initialize()에 지정된 최대 사용자 수와 같지 않는 한 사용자가 무조건 추가됩니다.반환 값은 이 사용자와 연결된 chat_user 개체에 대한 포인터입니다. XBOX User ID가 잘못된 경우 사용자의 chat_indicator 값은 game_chat_user_chat_indicator::platform_restricted가 됩니다.
요구 사항
헤더: GameChat2.h 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔관련 항목
chat_managerchat_user
chat_manager::add_remote_user
chat_manager::remove_user
chat_manager::process_incoming_data
game_chat_data_frame