使用 Multiplayer Manager 处理协议激活

本主题介绍如何使用 Multiplayer Manager 处理协议激活。激活是指系统响应另一操作而自动启动游戏。这通常在玩家接受来自另一玩家的游戏邀请时发生。你的游戏可以通过以下方式被协议激活。

用户接受游戏邀请
用户从玩家的玩家卡中选择”加入游戏”

此场景涵盖当你的游戏启动时,玩家加入大厅并正在进行游戏(如果存在)时如何处理协议激活。有关协议激活过程的流程图,请参阅处理协议激活(流程图)。当玩家接受游戏邀请或通过玩家的玩家卡加入好友的游戏时,系统会通过协议激活在其设备上启动游戏。游戏启动后,通过 XGameActivationRegisterForEvent 获取邀请句柄。使用邀请句柄调用 XblMultiplayerManagerJoinLobby。如果未通过 XblMultiplayerManagerLobbySessionAddLocalUser 添加被邀请的用户,则 XblMultiplayerManagerJoinLobby 会失败,并通过 JoinLobbyCompleted 事件调用 XblMultiplayerEventArgsXuid 提供邀请所针对的 xuid。加入大厅后,我们建议设置本地成员的连接地址以及该成员的任何自定义属性。如果不存在主机,你还可以通过 XblMultiplayerManagerLobbySessionSetSynchronizedHost 设置主机。最后,如果游戏已在进行中且有空位容纳被邀请者,Multiplayer Manager 会自动将用户加入游戏会话。游戏会通过 JoinGameCompleted 事件收到通知,并提供相应的错误代码和消息。

扁平 C API

#include <XTaskQueue.h>
#include <XGameActivation.h>  
  
XTaskQueueHandle g_taskQueue;  
XTaskQueueRegistrationToken g_activationToken;  
  
void CALLBACK OnActivation(void* context, const XGameActivationInfo* activationInfo)  
{  
    if (activationInfo->type == XGameActivationType::AcceptedGameInvite)
    {
        if (activationInfo->inviteUri != nullptr)
        {
            std::string inviteString(activationInfo->inviteUri);
            auto pos = inviteString.find("handle=");
            auto inviteHandeId = inviteString.substr(pos + 7, 36);
            // Now, call XblMultiplayerManagerJoinLobby.
        }
    }
}  
  
void InitializeGame()  
{  
    XGameActivationRegisterForEvent(g_taskQueue, nullptr, OnActivation, &g_activationToken);  
}  
  
void ShutdownGame()  
{  
    XGameActivationUnregisterForEvent(g_activationToken, true);  
}  

HRESULT hr = XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress(
    xblUserHandle, connectionAddress, context);

有关详细信息,请参阅 XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress。 Multiplayer Manager 执行以下功能。

注册 Real-Time Activity 和多人游戏订阅。
加入大厅会话。
清理现有的大厅状态。
将所有本地玩家加入为活动状态。
上传安全设备地址 (SDA)。
设置成员属性。
注册会话变更事件。
将大厅会话设置为活动会话。
加入游戏会话(如果存在)。
使用传输句柄。

XBOX Services

PlayFab

扁平 C API

​扁平 C API

扁平 C API