XGameUiShowSendGameInviteAsync
이 메서드는 게임 초대를 보내기 위해 선택된 플레이어의 친구 목록 및 추천 친구 목록에서 채워진 선택기 UI를 표시합니다.구문
매개 변수
async _In_형식: XAsyncBlock* XAsyncRun에 전달되는 XAsyncBlock에 대한 포인터입니다. requestingUser _In_
형식: XUserHandle 초대를 보내는 사용자에 대한 핸들입니다. sessionConfigurationId _In_
형식: char* 타이틀의 서비스 구성 ID를 나타내는 문자열을 지정합니다. sessionTemplateName _In_
형식: char* 멀티플레이어 세션 템플릿의 이름을 나타내는 문자열을 지정합니다. sessionId _In_
형식: char* 초대할 멀티플레이어 세션의 ID를 나타내는 문자열을 지정합니다. invitationText _In_opt_
형식: char* 사용자 지정 초대 문자열 ID를 나타내는 문자열을 지정합니다.
이 문자열 ID는 XBOX Live 서비스 구성에 정의되어 있으며, 표준 초대 텍스트에 추가되는 초대 텍스트를 식별합니다. ID 문자열은 ”///” 접두사로 시작해야 합니다. 초대에 사용자 지정 문자열을 추가하지 않으려면 빈 문자열을 전달하세요. customActivationContext _In_opt_
형식: char* 초대 활성화 URI에서 초대받은 사용자에게 제공되는 사용자 지정 활성화 컨텍스트입니다. 사용자 지정 활성화 컨텍스트 문자열은 URL에 안전해야 하며, 바이너리 콘텐츠는 URL에 안전한 base64 인코딩으로 인코딩되어야 합니다. 최대 길이는 160자입니다.
반환 값
형식: HRESULT 비동기 호출의 HRESULT 성공 또는 오류 코드입니다.설명
목록이 채워지면 플레이어를 선택할 수 있습니다. 플레이어는 선택기 UI에서 선택한 개인에게 지정된 게임 세션에 대한 게임 및/또는 파티 채팅 초대를 보낼 수 있습니다. UI를 호출하면 게임이 제한 모드(constrained mode) 로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 더 적은 시스템 리소스를 받게 됩니다. 제한 모드 및 타이틀의 기타 작동 모드에 대해 자세히 알아보려면 XBOX 게임 수명 주기(NDA 항목)를 참조하세요.요구 사항
헤더: XGameUI.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, Steam Deck, XBOX One 계열 콘솔 및 XBOX Series 콘솔개념 문서
함께 보기
XGameUIXGameUiShowSendGameInviteResult
XBOX 게임 수명 주기(NDA 항목)