XGameInviteEventCallback

아티클
05/09/2023

애플리케이션이 게임 초대 이벤트에 대해 정의한 콜백입니다.

구문

void XGameInviteEventCallback(  
         void* context,  
         const char* inviteUri  
)

매개 변수

context _In_opt_
형식: void*

XGameInviteRegisterForEvent에 전달한 컨텍스트입니다.

inviteUri _In_
형식: char*

게임 세션 참가용 URI입니다.

참고 항목

XSAPI는 URI 사용 방법을 알고 있습니다.

반환 값

형식: void

설명

게임 초대 이벤트에 대한 콜백을 등록하려면 XGameInviteRegisterForEvent를 호출합니다. 이 함수는 XGameInviteEventCallback에 대한 포인터를 인수로 사용합니다.

게임 초대 이벤트에 대한 콜백을 등록 해제하려면 XGameInviteUnregisterForEvent를 호출합니다.

다음 코드 샘플은 게임 초대 콜백을 등록합니다.

#include <XTaskQueue.h>
#include <XGameInvite.h>  
  
XTaskQueueHandle g_taskQueue;  
XTaskQueueRegistrationToken g_gameInviteEventToken;  
  
void OnGameInvite(void* context, const char* inviteUri)  
{  
    if (inviteUri != nullptr)
    {
        std::string inviteString(inviteUri);
        auto pos = inviteString.find("handle=");
        auto inviteHandeId = inviteString.substr(pos + 7, 36);
        // Now call XblMultiplayerManagerJoinLobby if using MPM
        // or call XblMultiplayerWriteSessionByHandleAsync if using MPSD APIs
    }
}  
  
void InitializeGame()  
{  
    XGameInviteRegisterForEvent(g_taskQueue, nullptr, OnGameInvite, &g_gameInviteEventToken);  
}  
  
void ShutdownGame()  
{  
    XGameInviteUnregisterForEvent(g_gameInviteEventToken);  
}