将 PlayFab GSDK 集成到 Unity 中 - XBOX Game Development Documentation

Multiplayer Servers 平台提供了一个 GSDK 库,你可以将其集成到你的 Unity 游戏服务器中。该库是开源的,可以在 GitHub 上的 GSDK 存储库中找到。

安装

你可以将 Assets/PlayFabSdk 文件夹复制到你的 Unity 项目中。之后,你需要在 Unity 构建设置上启用脚本指令 ENABLE_PLAYFABSERVER_API(示例)。或者,你可以使用提供的 Unity 包文件。你可以在 MultiplayerServerSample 项目中找到示例代码。

用法

至少,你需要实现 PlayFabMultiplayerAgentAPI.Start() 方法,并为 PlayFabMultiplayerAgentAPI.ReadyForPlayers() 方法启动一个协程,如下面的代码所示

//...
StartCoroutine(ReadyForPlayers());
//...

private IEnumerator ReadyForPlayers()
{
    yield return new WaitForSeconds(.5f);
    PlayFabMultiplayerAgentAPI.ReadyForPlayers();
}

你还会希望通过 PlayFabMultiplayerAgentAPI.OnServerActiveCallback 注册游戏服务器过渡到 Active 状态的事件,如下例所示:

PlayFabMultiplayerAgentAPI.OnServerActiveCallback += OnServerActive;
// ...
private void OnServerActive()
{
    Debug.Log("Server Started From Agent Activation");
    // players can now connect to the server
}

有关游戏服务器状态的更多信息,请查看此处的 PlayFab 游戏服务器基础知识部分

此外,你可以在游戏服务器上实现以下回调:

PlayFabMultiplayerAgentAPI.OnMaintenanceCallback 在 Azure 需要对 VM 执行维护时触发
PlayFabMultiplayerAgentAPI.OnShutDownCallback 在收到终止通知时触发
PlayFabMultiplayerAgentAPI.OnAgentErrorCallback 在游戏服务器与 PlayFab VM Agent 通信之间出现任何错误时触发

有关更多 GSDK 示例,你可以在此处查看我们的 MPS 示例存储库

最后修改于 2026年8月25日

​安装

​用法

安装

用法