次の方法で共有

XGameInviteEventCallback

  • [アーティクル]

ゲームへの招待イベントに対してアプリケーションが定義するコールバック。

構文

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);  
}

要件

ヘッダー: XGameInvite.h

ライブラリ: xgameruntime.lib

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

XGameInvite

XGameInviteRegisterForEvent

XGameInviteUnregisterForEvent