跳轉到主要內容
多人遊戲伺服器平台提供一個 GSDK 程式庫,您可以將其整合至 Unity 遊戲伺服器中。此程式庫是開放原始碼,可以在 GitHub 上的 GSDK 存放庫中找到。

安裝

您可以將 Assets/PlayFabSdk 資料夾複製到您的 Unity 專案中。之後,您需要在 Unity 組建設定中啟用指令碼指示詞 ENABLE_PLAYFABSERVER_API (範例)。 或者,您可以使用提供的 Unity 套件檔案。 您可以在 MultiplayerServerSample 專案中找到範例程式碼。

使用方式

至少,您需要實作 PlayFabMultiplayerAgentAPI.Start() 方法,並為 PlayFabMultiplayerAgentAPI.ReadyForPlayers() 方法啟動協同程式,如下列程式碼所示
您也會想要使用 PlayFabMultiplayerAgentAPI.OnServerActiveCallback,註冊遊戲伺服器轉換為作用中狀態的時機,如下列範例所示:
如需遊戲伺服器狀態的詳細資訊,請查看此處的 PlayFab 遊戲伺服器基本概念一節
此外,您可以在遊戲伺服器上實作下列回呼:
  • PlayFabMultiplayerAgentAPI.OnMaintenanceCallback 在 Azure 需要對 VM 執行維護時觸發
  • PlayFabMultiplayerAgentAPI.OnShutDownCallback 在收到終止通知時觸發
  • PlayFabMultiplayerAgentAPI.OnAgentErrorCallback 在遊戲伺服器與 PlayFab VM 代理程式之間的通訊發生任何錯誤時觸發
如需更多 GSDK 範例,您可以在此處查看我們的 MPS 範例存放庫
最後修改於 2026年10月8日