다음을 통해 공유

XGameUiShowSendGameInviteAsync

  • 아티클

이 메서드는 선택된 플레이어의 친구 목록 및 추천 친구 목록에서 입력한 선택기 UI가 게임 초대를 보내는 방법을 보여줍니다.

구문

HRESULT XGameUiShowSendGameInviteAsync(  
         XAsyncBlock* async,  
         XUserHandle requestingUser,  
         const char* sessionConfigurationId,  
         const char* sessionTemplateName,  
         const char* sessionId,  
         const char* invitationText,  
         const char* customActivationContext  
)

매개 변수

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를 호출하면 게임이 제한 모드로 전환됩니다. 제한 모드에서는 호출된 UI의 백그라운드에 있는 동안 타이틀이 시스템 리소스를 적게 받게 됩니다. 타이틀의 제한 모드 및 기타 운영 모드에 대한 자세한 내용은 Xbox 게임 수명 주기(NDA 항목)를 참조하세요.

요구 사항

헤더: XGameUI.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XGameUI
XGameUiShowSendGameInviteResult
Xbox 게임 수명 주기(NDA 항목)